Connect MCP

Pick the path that matches your client. All three talk to the same hosted server:

https://mcp.unfurl.pub/mcp

The interactive setup page is unfurl.pub/connect.

Choose a path

One-command install
Custom connector
API key

Best for coding agents (Claude Code, Cursor, Codex). Installs the MCP server and the Unfurl agent skill.

npx unfurl-install

Target a specific client:

npx unfurl-install --client=claude
npx unfurl-install --client=cursor
npx unfurl-install --client=codex

Restart the client (or open a new session). On first publish, sign in at Unfurl and click Allow.

Best when you want to paste the MCP URL in the app — Claude Desktop, Claude.ai, ChatGPT, Cursor, Codex Desktop, and other MCP clients. No terminal required.

Copy https://mcp.unfurl.pub/mcp.
In your app, open connector / MCP settings and add a custom or remote MCP server.
Paste the URL and save.
On first use, sign in at Unfurl and click Allow.

Example config (Cursor, Claude Desktop, and similar JSON-based clients):

{
  "mcpServers": {
    "unfurl": {
      "url": "https://mcp.unfurl.pub/mcp"
    }
  }
}

OAuth creates a managed MCP connector key for your workspace. You do not paste a key on the Unfurl authorize page.

Use a dashboard API key for the REST API, scripts, and MCP clients that let you attach HTTP headers to a remote server.

Sign in and open Dashboard → API keys.
Create a key and copy the full oodoc_… secret — it is shown only once.
Send it as X-Api-Key: oodoc_… or Authorization: Bearer oodoc_… on REST requests.

If your MCP client supports custom headers on a remote URL, you can attach the same key instead of (or alongside) OAuth:

{
  "mcpServers": {
    "unfurl": {
      "url": "https://mcp.unfurl.pub/mcp",
      "headers": {
        "Authorization": "Bearer oodoc_YOUR_KEY"
      }
    }
  }
}

Free workspaces include 1 API key. Pro includes unlimited keys. OAuth connector keys appear in the dashboard with an MCP connector badge and count toward the key limit.

Per-client guides

Claude

Cursor

Codex

ChatGPT

After you connect

Ask your assistant to publish a one-line HTML page. You should get back document_id and share_url. For small later edits, prefer edit_document over republishing the whole file.

Getting Started

Core Concepts

Guides

Connect MCP

Connect MCP

Choose a path

Per-client guides

Claude

Cursor

Codex

ChatGPT

After you connect

MCP overview

​Connect MCP

​Choose a path

​Per-client guides

Claude

Cursor

Codex

ChatGPT

​After you connect

MCP overview

Connect MCP

Choose a path

Per-client guides

After you connect