# Using these docs with Claude

This is grandocs, an unofficial mirror of MA Lighting documentation. For authoritative or safety-relevant information, cite the canonical page on help.malighting.com.

---
import { Steps, Tabs, TabItem, Aside } from '@astrojs/starlight/components';

Claude is the cleanest fit for grandocs: it speaks the [MCP server](/connect/mcp/)
natively and can install the grandocs **skills**, so it searches the live manual
and follows the same grounding rules you'd want. Three ways, depending on which
Claude you use.

<Aside type="tip" title="Grounded by design">
With the MCP server connected, Claude looks up the real page and cites it —
no invented keywords. The skills add the house rules ("never invent syntax, the
user's console version wins, cite the source").
</Aside>

## Option 1 — connect the MCP server (recommended)

This gives Claude live search over every page.

<Tabs>
<TabItem label="Claude Code">

```bash
claude mcp add --transport http grandocs https://grandocs-mcp.samcarlton.workers.dev/mcp
```

Then ask normally — Claude calls `search_docs`, `get_page`, and `command_lookup`.

</TabItem>
<TabItem label="Claude Desktop">

Add a custom connector under *Settings → Connectors → Add custom connector* with
the URL `https://grandocs-mcp.samcarlton.workers.dev/mcp`.

Or edit `claude_desktop_config.json` directly:

```json
{
  "mcpServers": {
    "grandocs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://grandocs-mcp.samcarlton.workers.dev/mcp"]
    }
  }
}
```

Restart Claude Desktop and the grandocs tools appear.

</TabItem>
<TabItem label="claude.ai">

On plans with connectors, add a custom connector in *Settings → Connectors* using
the URL `https://grandocs-mcp.samcarlton.workers.dev/mcp`.

</TabItem>
</Tabs>

The full tool list and what each does is on the [Any MCP client](/connect/mcp/)
page.

## Option 2 — install the skills (Claude Code)

The grandocs skills teach Claude how to use the docs *and* the house rules
(version awareness, never inventing syntax, citing the page). One command
installs all six:

```bash
npx skills add ThatGuySam/grandocs
```

You get: `grandma3-docs`, `grandma2-dot2-docs`, `grandma-command-syntax`,
`grandma3-lua-api`, `grandma-macro-writer`, and `grandma-troubleshooting`. They
pair well with the MCP server — the skill routes the lookup, the server fetches
the page.

## Option 3 — Projects (no MCP)

For chat-only use on claude.ai, drop the manual into a Project.

<Steps>

1. Create a Project.

2. Add the manual to **Project knowledge** — either:
   - upload the `.md` for the pages you care about (use **Copy as Markdown** /
     the `.md` twin URLs), or
   - upload a whole product set, e.g.
     [`/_llms-txt/grandma3-v24.txt`](https://grandocs.samcarlton.com/_llms-txt/grandma3-v24.txt).

3. Add a custom instruction: *"Answer only from the attached grandMA manual;
   quote syntax blocks verbatim and cite the page; never invent commands."*

</Steps>

For a single question you can also just paste a page's markdown into the chat.

<Aside type="caution" title="Unofficial mirror">
For conformity, electrical, or safety-critical answers, confirm against the
official [help.malighting.com](https://help.malighting.com/) page linked on every
grandocs topic.
</Aside>