> ## 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 Cursor

> Add the Unfurl MCP server in Cursor and reload so the AI can call publish_document and get_document.

# Set up MCP in Cursor

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.

## Add the server

<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 `Cursor`) 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 add 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="Open MCP settings">
    In Cursor, open **Settings → MCP** (or **Cursor Settings → Features → MCP**, depending on your version).
  </Step>

  <Step title="Paste configuration">
    Add an entry named `unfurl`:

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

    If your config already has `mcpServers`, merge the `unfurl` block without duplicating the outer key.
  </Step>

  <Step title="Reload">
    Use **Reload MCP** or restart Cursor so the new server registers.
  </Step>

  <Step title="Authorize with your API key">
    When Cursor opens the browser for OAuth, complete the flow. On the Unfurl **Connect to unfurl** page, **paste the API key** you created in step 1 and submit. After that, the MCP connection is active.
  </Step>
</Steps>

## Where the file lives

Cursor stores MCP config per installation; paths change between releases. Search Cursor's documentation for **"MCP configuration file"** if you edit JSON on disk manually.

## Verify

In the AI chat (Cmd+L / Ctrl+L):

> "Call Unfurl MCP to publish a minimal HTML page titled 'Cursor MCP test' with a single H1 body"

You should get `document_id` and a share URL back.

<Warning>
  If nothing happens, confirm **no corporate proxy** is blocking `https://mcp.unfurl.pub` and that you completed OAuth in the browser (paste your API key on the Unfurl authorize page when asked).
</Warning>

<CardGroup cols={2}>
  <Card title="Cursor quickstart" icon="code" href="/getting-started/quickstart-cursor" />

  <Card title="get_document" icon="download" href="/api-reference/get-document" />
</CardGroup>