Skip to main content

​
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

1

Create an API key in Unfurl

  1. Sign in at unfurl.pub and open the dashboard.
  2. Go to 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.
If you lose the secret, revoke the old key and create a new one on the same page.
2

Open MCP settings

In Cursor, open Settings → MCP (or Cursor Settings → Features → MCP, depending on your version).
3

Paste configuration

Add an entry named unfurl:
If your config already has mcpServers, merge the unfurl block without duplicating the outer key.
4

Reload

Use Reload MCP or restart Cursor so the new server registers.
5

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.

​
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.
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).

Cursor quickstart

get_document