Connect Cursor

Cursor reads MCP servers from its settings file. Add the streamable HTTP endpoint and the agent can call your tools inside the editor.

TransportStreamable HTTPConfigCursor MCP settings

How do I connect an MCP server to Cursor?

Add the server’s HTTP URL to `~/.cursor/mcp.json` (Settings → MCP) and reload Cursor. Cursor connects to remote MCP servers directly over streamable HTTP, so a deployed server needs only its URL — no local process or bridge.

Setup

Open Cursor → Settings → MCP (or edit `~/.cursor/mcp.json`).
Add the entry below, replacing the URL with your deployment URL.
Reload Cursor; the server appears in the MCP panel.

Cursor MCP settingsjson

{
  "mcpServers": {
    "my-server": {
      "url": "https://my-server.mcp.cloud/mcp"
    }
  }
}

Verify the connection

Open the MCP settings panel and confirm the server shows a green/connected indicator.

Troubleshooting

Tools do not load.

Cursor caches MCP config — toggle the server off and on, or reload the window.

Cursor MCP documentation

Connect another client

CLI

Claude Code

Add your MCP server to Claude Code from the terminal.

Desktop

Claude Desktop

Connect Claude Desktop to a remote MCP server over a stdio bridge.

Editor

VS Code

Add a remote MCP server to VS Code.

Editor

Windsurf

Connect Windsurf to a remote MCP server.

Editor

Antigravity

Add a remote MCP server to Antigravity.

CLI

Codex

Add a remote MCP server to the Codex CLI and IDE extension.

Web

ChatGPT

Add your MCP server to ChatGPT as a custom connector.

CLI

Gemini CLI

Add a remote MCP server to the Gemini CLI.