Connecting Your AI Client to MCP

Copy Markdown link View as Markdown Open in Mistral Le Chat Open in ChatGPT Open in Claude

This guide walks through connecting Claude Desktop, Cursor, and VS Code to the MCP endpoint of a ServeMD-powered documentation site.

Quick install: Visit /servemd on this site for one-click install buttons for Cursor and VS Code, plus a ready-to-copy config snippet for Claude Desktop — all pre-filled with the correct URL for this deployment.

Claude Desktop

Claude Desktop supports remote HTTP MCP servers via manual configuration. There is no one-click URL scheme for remote servers.

Steps

  1. Open Claude Desktop.
  2. Go to Settings → Developer → Edit Config to open claude_desktop_config.json.
  3. Add your server under mcpServers:
{
  "mcpServers": {
    "my-docs": {
      "type": "http",
      "url": "https://your-docs-site.com/mcp"
    }
  }
}
  1. Save the file and restart Claude Desktop.
  2. Verify the connection: click the + button in the chat input and select Connectors.

Config file location: - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

Cursor v3.0.9+ has a known regression where native HTTP/SSE MCP transport is broken (affects Figma, Vercel, and all remote HTTP MCPs). The workaround is mcp-remote, which bridges the remote endpoint via stdio.

Steps

  1. Add the following to your Cursor MCP config:
  2. Global (all projects): ~/.cursor/mcp.json
  3. Project-level: .cursor/mcp.json in your repo root
{
  "mcpServers": {
    "my-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-docs-site.com/mcp"]
    }
  }
}
  1. Restart Cursor (or reload the MCP config from Settings → Tools & MCP).

Or use the Add to Cursor button on /servemd which generates the correct deep link automatically.

VS Code

VS Code supports MCP natively via its built-in HTTP transport.

Steps

  1. Open VS Code settings (Cmd/Ctrl + ,) and navigate to MCP Servers, or add to .vscode/settings.json:
{
  "mcp": {
    "servers": {
      "my-docs": {
        "type": "http",
        "url": "https://your-docs-site.com/mcp"
      }
    }
  }
}

Or use the Add to VS Code button on /servemd which opens a pre-filled confirmation dialog.

Manual JSON-RPC (fallback)

All MCP clients that support JSON-RPC 2.0 over HTTP can connect directly. See the MCP Integration page for the full protocol reference and example requests.