> ## Documentation Index
> Fetch the complete documentation index at: https://00doc-web.vercel.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up MCP in Claude

> Connect Claude (web or Desktop) to the Unfurl MCP server and verify publishing works.

# Set up MCP in Claude

Use endpoint **`https://mcp.unfurl.pub/mcp`** for all configurations below.

You need an **API key** from your Unfurl account before the OAuth step. The key is shown **only once** when you create it — store it somewhere safe until you paste it on the Unfurl authorize page.

<Steps>
  <Step title="Create an API key in Unfurl">
    1. Sign in at [unfurl.pub](https://unfurl.pub) and open the dashboard.
    2. Go to **[Dashboard → API keys](https://unfurl.pub/dashboard/api-keys)** (or **API keys** in the sidebar).
    3. Enter a **label** (e.g. `MCP` or `Claude`) and create a new key.
    4. **Copy the full secret** immediately — it starts with `oodoc_` and is displayed only this one time. You will paste it when the browser opens the Unfurl **authorize** page after you connect the MCP server.

    <Tip>
      If you lose the secret, revoke the old key and create a new one on the same page.
    </Tip>
  </Step>

  <Step title="Choose your surface">
    <Tabs>
      <Tab title="Claude.ai (web)">
        1. Open **Settings** (or the connectors / plug menu from chat).
        2. Add a **custom MCP** or search for Unfurl if listed.
        3. Paste **`https://mcp.unfurl.pub/mcp`**.
        4. Complete OAuth when prompted. On the Unfurl **authorize** page, **paste the API key** from step 1.
      </Tab>

      <Tab title="Claude Desktop">
        Edit your MCP config (location varies by OS; see Anthropic docs for `claude_desktop_config.json`).

        ```json theme={null}
        {
          "mcpServers": {
            "unfurl": {
              "url": "https://mcp.unfurl.pub/mcp"
            }
          }
        }
        ```

        Save the file and **fully quit** Claude Desktop, then reopen it. When the browser opens for OAuth, **paste the API key** from step 1 on the Unfurl authorize page.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Verify the connection">
    Start a new chat and ask:

    > "List available MCP tools related to Unfurl" or "Publish a one-line HTML test page titled MCP test to Unfurl"

    You should see tool calls or a successful publish response with a URL.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="MCP tools do not appear">
    * Confirm the URL has **no trailing typo** and uses **HTTPS**.
    * Disconnect and reconnect the connector; start a **new** conversation after reconnecting.
    * On Desktop, confirm the JSON is valid and Claude was **restarted** after the edit.
  </Accordion>

  <Accordion title="Authorisation errors">
    Complete the browser OAuth flow when the connector opens it. On the Unfurl authorize page, paste an **API key** from [Dashboard → API keys](https://unfurl.pub/dashboard/api-keys) (create one there if needed).
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Claude quickstart" icon="bolt" href="/getting-started/quickstart-claude" />

  <Card title="publish_document" icon="code" href="/api-reference/publish-document" />
</CardGroup>