Cursor

Cursor speaks MCP natively over HTTP. Add Graniite from the settings UI, complete the OAuth flow in your browser, and the agent panel can search and add to your library.

Requirements

• Cursor 0.45 or later (native HTTP MCP). Older versions need the mcp-remote fallback below.
• A Graniite account, signed in at graniite.co in your default browser.

Steps

1. Open Cursor settings.
   • macOS: menu bar Cursor → Settings → Cursor Settings, or ⌘,
   • Windows or Linux: Ctrl+,
2. In the left sidebar, click MCP.
3. Click + Add new MCP server.
4. Fill the form:

5. Click Save. Cursor opens your browser to graniite.co/oauth/authorize.
6. Approve the consent screen.
7. Back in Cursor, the MCP server shows a green dot. The four Graniite tools (search_knowledge_base, get_item, list_recent, add_to_knowledge) are now available to the agent.

What the consent screen shows

Same as the Claude Desktop quickstart: "Cursor Unverified wants to connect to your Graniite account." The unverified badge is normal for DCR-registered clients.

Verify it works

Open Composer (⌘L or Ctrl+L) or Chat (⌘I or Ctrl+I) and try:

Search my Graniite library for the latest podcast I added and summarize the top 3 takeaways.

Cursor's agent will call search_knowledge_base, then likely get_item to pull full content for the citations.

Picking a scope

Cursor benefits from a scoped token if you only want it to see code-related content. Mint a token first at /settings/integrations with scope set to a specific folder (for example, Code or Engineering), then redo the Cursor add. The OAuth flow defaults to your latest mint settings.

Fallback: mcp-remote bridge

For older Cursor versions that only support stdio MCP.

1. Mint a token

Go to /settings/integrations and click + Create token. Copy the lev_… string.

2. Configure stdio in Cursor

In Cursor's MCP settings, add a server with Type: command instead of HTTP:

Save and restart Cursor. The first launch downloads mcp-remote via npx. Subsequent launches are fast.

Troubleshooting

"Tools/list returned an error"

This usually means the OAuth handshake landed but Cursor's first tools/list call hit a rate limit or transient error. Wait 60 seconds and reload the MCP server in settings (the toggle next to its name).

Tools do not show up in the agent panel

Cursor's tool registry only refreshes when the MCP server reconnects. Toggle the server off and on in MCP settings.

"Server connection failed" immediately after Save

Same fix as the Claude Desktop browser-side fix. Make sure you are signed in at graniite.co in your default browser, and that the browser actually opens when you click Save (check popup-blocker and privacy extensions).

Revoking access

Go to /settings/integrations, find the Cursor token, and click Revoke. Cursor will surface a reconnect prompt on its next tool call.