Sign in Try Core free

Agent guide

Cursor Setup

Back to setup docsRaw source

Paste this into your agent

Start with this visible request when you want the agent to help. It keeps the action coming from you, while the linked setup reference stays plain and non-recursive.

Use this in the app you are connecting, then approve only the browser login, app setting, or restart steps that the app requires.

Please help me set up Core for Cursor. Core keeps shared context for AI work: it preserves useful context, decisions, files, and what worked across connected tools.

Use this official setup reference:
https://core.gradien.ai/core/docs/reference

Source checked: 2026-07-24 Official source: https://docs.cursor.com/en/tools/mcp

Use the complete Secure server address shown by Core during onboarding, including ?setup_attempt=.... Outside onboarding, use https://core.gradien.ai/mcp/continuity.

Add Core in Cursor

  1. Open Cursor Settings.
  2. Open Tools & MCPs.
  3. If Cursor shows a migration notice, select Open Tools & MCPs in Customize.
  4. Select New MCP Server or Add a Custom MCP Server.
  5. Enter Core and paste the complete Core address.
  6. Connect and approve Core in the browser.
  7. Reload Cursor or run Developer: Reload Window if Core remains disabled.

For global manual configuration, preserve the other entries in ~/.cursor/mcp.json and add:

{
  "mcpServers": {
    "core": {
      "url": "<secure-server-address>"
    }
  }
}

Use the global config when Core should follow the user across projects. Use .cursor/mcp.json only for a project-scoped setup.

If Cursor remains on Waiting for callback or Exchanging token after approval, quit and relaunch Cursor once, then inspect Output, MCP Logs. Do not keep creating duplicate Core entries or paste a long-lived connector key into the file during normal setup.