Connect an MCP server

docs.connect.lede

docs.connect.before.h

docs.connect.before

docs.connect.claude-code.h

docs.connect.claude-code

docs.kind.remote

  1. Run this in a terminal, in your project folder:
claude mcp add --transport http deepwiki https://mcp.deepwiki.com/mcp
  1. Start Claude Code and type /mcp. deepwiki should show as connected.

Add --scope user to make it available in every project, not just this one.

docs.kind.oauth

  1. Run this in a terminal, in your project folder:
claude mcp add --transport http notion https://mcp.notion.com/mcp
  1. Start Claude Code, type /mcp, pick notion and choose Authenticate. A browser window opens for the Notion sign-in.

Add --scope user to make it available in every project, not just this one.

docs.kind.key

  1. Run this in a terminal, in your project folder:
claude mcp add --transport http example https://mcp.example.com/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
  1. Replace the placeholder with your key before you run it, then check it with /mcp inside Claude Code.

Add --scope user to make it available in every project, not just this one.

docs.kind.local

  1. Run this in a terminal, in your project folder:
claude mcp add --transport stdio memory -- npx -y @modelcontextprotocol/server-memory
  1. Start Claude Code and type /mcp. memory should show as connected.

Add --scope user to make it available in every project.

docs.connect.claude-ai.h

docs.connect.claude-ai

docs.kind.remote

  1. Open the connector form on claude.ai. This button fills in the name and URL for you:
  1. Check that the URL reads https://mcp.deepwiki.com/mcp and click Add.
  2. Turn it on in a chat from the tools menu.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under Organization settings → Connectors.

docs.kind.oauth

  1. Open the connector form on claude.ai. This button fills in the name and URL for you:
  1. Check that the URL reads https://mcp.notion.com/mcp and click Add.
  2. Click Connect and sign in when Notion asks.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under Organization settings → Connectors.

docs.connect.claude-desktop.h

docs.connect.claude-desktop

docs.kind.remote

  1. Open Settings → Connectors and click Add custom connector.
  2. Name it DeepWiki and paste this URL:
https://mcp.deepwiki.com/mcp
  1. Click Add. Its tools appear in the chat's tools menu.

Claude Desktop's JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

docs.kind.oauth

  1. Open Settings → Connectors and click Add custom connector.
  2. Name it Notion and paste this URL:
https://mcp.notion.com/mcp
  1. Click Add, then Connect, and sign in when Notion asks.

Claude Desktop's JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

docs.kind.key

  1. Custom connectors can't send this server's key header, so use the mcp-remote bridge. Open Settings → Developer → Edit Config and add:
claude_desktop_config.json
{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.example.com/mcp",
        "--header",
        "Authorization: Bearer <YOUR_API_KEY>"
      ]
    }
  }
}
  1. Replace the placeholder with your key and restart Claude Desktop.

The bridge needs Node.js on your computer.

docs.kind.local

  1. Open Settings → Developer → Edit Config. It opens claude_desktop_config.json. Add:
claude_desktop_config.json
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}
  1. Save the file and restart Claude Desktop.

Needs Node.js on your computer. The file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

docs.connect.chatgpt.h

docs.connect.chatgpt

docs.kind.remote

  1. On chatgpt.com, open Settings → Security and login and turn on Developer mode.
  2. Go to chatgpt.com/plugins and click + to create an app for a remote MCP server.
  3. Paste https://mcp.deepwiki.com/mcp as the server URL and choose No authentication.

Developer mode is available on the web for Plus, Pro, Business, Enterprise and Education accounts.

docs.kind.oauth

  1. On chatgpt.com, open Settings → Security and login and turn on Developer mode.
  2. Go to chatgpt.com/plugins and click + to create an app for a remote MCP server.
  3. Paste https://mcp.notion.com/mcp as the server URL and choose OAuth. ChatGPT sends you to Notion to sign in.

Developer mode is available on the web for Plus, Pro, Business, Enterprise and Education accounts.

docs.connect.cursor.h

docs.connect.cursor

docs.kind.remote

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json
{
  "mcpServers": {
    "deepwiki": {
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}

docs.kind.oauth

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json
{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

Cursor shows Needs login next to the server. Click it to sign in.

docs.kind.key

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json
{
  "mcpServers": {
    "example": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

docs.kind.local

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}

Needs Node.js on your computer.

docs.connect.vscode.h

docs.connect.vscode

docs.kind.remote

Or from a terminal:

code --add-mcp '{"name":"deepwiki","type":"http","url":"https://mcp.deepwiki.com/mcp"}'

Or commit it to the repo in .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "deepwiki": {
      "type": "http",
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}

docs.kind.oauth

Or from a terminal:

code --add-mcp '{"name":"notion","type":"http","url":"https://mcp.notion.com/mcp"}'

Or commit it to the repo in .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

VS Code asks you to sign in the first time the server starts.

docs.kind.key

Add it to .vscode/mcp.json. VS Code asks for the key the first time and stores it securely:

.vscode/mcp.json
{
  "servers": {
    "example": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "api-key",
      "description": "API key",
      "password": true
    }
  ]
}

docs.kind.local

Or from a terminal:

code --add-mcp '{"name":"memory","type":"stdio","command":"npx","args":["-y","@modelcontextprotocol/server-memory"]}'

Or commit it to the repo in .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}

Needs Node.js on your computer.

docs.connect.other.h

docs.connect.other.devin

docs.kind.remote

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "deepwiki": {
      "serverUrl": "https://mcp.deepwiki.com/mcp"
    }
  }
}
  1. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads serverUrl (or url) for remote servers.

docs.kind.oauth

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "notion": {
      "serverUrl": "https://mcp.notion.com/mcp"
    }
  }
}
  1. Refresh the MCP server list in Cascade and sign in when asked.

Devin Desktop is the new name for Windsurf. It reads serverUrl (or url) for remote servers.

docs.kind.key

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "example": {
      "serverUrl": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
  1. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads serverUrl (or url) for remote servers.

docs.kind.local

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}
  1. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

Codex

docs.kind.remote

codex mcp add deepwiki --url https://mcp.deepwiki.com/mcp

Or edit ~/.codex/config.toml directly:

config.toml
[mcp_servers.deepwiki]
url = "https://mcp.deepwiki.com/mcp"

docs.kind.oauth

codex mcp add notion --url https://mcp.notion.com/mcp
codex mcp login notion

Or edit ~/.codex/config.toml directly:

config.toml
[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"

docs.kind.key

codex mcp add example --url https://mcp.example.com/mcp --bearer-token-env-var EXAMPLE_API_KEY

Or edit ~/.codex/config.toml directly:

config.toml
[mcp_servers.example]
url = "https://mcp.example.com/mcp"
bearer_token_env_var = "EXAMPLE_API_KEY"

Set EXAMPLE_API_KEY to your key in the shell that runs Codex.

docs.kind.local

codex mcp add memory -- npx -y @modelcontextprotocol/server-memory

Or edit ~/.codex/config.toml directly:

config.toml
[mcp_servers.memory]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-memory"]

Needs Node.js on your computer.

Gemini CLI

docs.kind.remote

gemini mcp add --transport http deepwiki https://mcp.deepwiki.com/mcp

This adds it to the current project. Add -s user to use it everywhere.

docs.kind.oauth

gemini mcp add --transport http notion https://mcp.notion.com/mcp

Then, inside Gemini CLI, run /mcp auth notion to sign in.

This adds it to the current project. Add -s user to use it everywhere.

docs.kind.key

gemini mcp add --transport http --header "Authorization: Bearer <YOUR_API_KEY>" example https://mcp.example.com/mcp

This adds it to the current project. Add -s user to use it everywhere.

docs.kind.local

gemini mcp add memory npx -- -y @modelcontextprotocol/server-memory

This adds it to the current project. Add -s user to use it everywhere.

docs.connect.other.any

docs.kind.remote

Most clients accept this shape. Some name the URL field differently: serverUrl in Devin Desktop, httpUrl in Gemini CLI's settings file.

{
  "mcpServers": {
    "deepwiki": {
      "type": "http",
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}

Zed puts servers under context_servers in its settings. Cline needs "type": "streamableHttp", or it assumes SSE.

Client only starts local servers? Bridge it with npx -y mcp-remote https://mcp.deepwiki.com/mcp.

docs.kind.oauth

Most clients accept this shape. Some name the URL field differently: serverUrl in Devin Desktop, httpUrl in Gemini CLI's settings file.

{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

Zed puts servers under context_servers in its settings. Cline needs "type": "streamableHttp", or it assumes SSE.

Client only starts local servers? Bridge it with npx -y mcp-remote https://mcp.notion.com/mcp.

docs.kind.key

Most clients accept this shape. Some name the URL field differently: serverUrl in Devin Desktop, httpUrl in Gemini CLI's settings file.

{
  "mcpServers": {
    "example": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

Zed puts servers under context_servers in its settings. Cline needs "type": "streamableHttp", or it assumes SSE.

Client only starts local servers? Bridge it with npx -y mcp-remote https://mcp.example.com/mcp.

docs.kind.local

Most clients that start local servers accept this shape:

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}

Zed puts servers under context_servers in its settings, with the same command, args and env fields.

Needs Node.js on your computer.

docs.connect.access.h

docs.connect.access

docs.connect.trouble.h

docs.connect.faq.page.q

docs.connect.faq.page.a

docs.connect.faq.connect.q

docs.connect.faq.connect.a

docs.connect.faq.signin.q

docs.connect.faq.signin.a

docs.connect.faq.local.q

docs.connect.faq.local.a

docs.connect.faq.bridge.q

docs.connect.faq.bridge.a

docs.connect.faq.sse.q

docs.connect.faq.sse.a

docs.connect.faq.wrong.q

docs.connect.faq.wrong.a