Skip to main content

Prerequisites

  • Cursor installed
  • A MCPCore server with at least one tool
  • The config snippet from your server’s Integration tab

Step 1 — Get your config snippet

Open your server’s detail page, click the Integration tab, and select Cursor. Copy the generated snippet. Cursor supports native HTTP transport — no npx bridge needed:
{
  "mcpServers": {
    "your-server-code": {
      "url": "https://your-subdomain.mcpcore.io/mcp"
    }
  }
}
For API Key mode:
{
  "mcpServers": {
    "your-server-code": {
      "url": "https://your-subdomain.mcpcore.io/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Step 2 — Open the MCP config file

Cursor’s MCP config is at: macOS / Linux:
~/.cursor/mcp.json
Windows:
%USERPROFILE%\.cursor\mcp.json
Create the file if it doesn’t exist.

Step 3 — Merge the snippet

Add your server entry to the mcpServers object. If the file is new:
{
  "mcpServers": {
    "your-server-code": {
      "url": "https://your-subdomain.mcpcore.io/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Step 4 — Reload MCP in Cursor

Save the file. You can reload without restarting Cursor: open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for MCP: Reload.

Step 5 — Verify

Open Cursor’s Agent mode or a chat and ask it to use one of your tools. Your MCPCore tools are available in any AI feature.
Cursor Agent mode showing a MCPCore tool call

Troubleshooting

ProblemSolution
Server shows as offlineConfirm the URL is correct and internet access is available
401 UnauthorizedVerify the Authorization header value
Tools fail silentlyCheck Traffic Logs