Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getmcp.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Finding Your Server URL

Every GetMCP server has a unique MCP endpoint URL. Find it by:
  1. Going to GetMCP > Dashboard
  2. Clicking on your server
  3. Copying the Server URL shown at the top of the server detail page
The URL format is: 
https://yoursite.com/mcp/{slug}
Server URL
Authentication in your MCP client config serves two purposes: (1) sending an access token if your server has inbound authentication enabled, and/or (2) supplying your own API credentials that GetMCP forwards to external APIs when tools run. The method differs per client — Claude Desktop uses --header args; Cursor, Windsurf, and VS Code use a headers JSON object. See Authentication for a full explanation.

​
Claude Desktop

Requires: Claude Desktop app installed · Node.js 18+ installed (needed for mcp-remote)
1

Open Claude Desktop

Open the Claude Desktop app.
2

Open Developer Settings and click Edit Config

  • macOS: Menu bar → Claude → Settings → Developer → Edit Config
  • Windows: Breadcrumb menu (top bar) → File → Settings → Developer → Edit Config
The config file opens in a text editor. It is located at:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
3

Copy the configuration below and paste it into the mcpServers object, then save

No authentication (macOS / Linux):
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://yoursite.com/mcp/my-server"
      ]
    }
  }
}
No authentication (Windows) — routes through cmd.exe to avoid Node.js path-with-spaces issues:
{
  "mcpServers": {
    "my-server": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "mcp-remote",
        "https://yoursite.com/mcp/my-server"
      ]
    }
  }
}
If your server has inbound authentication enabled, pass the credential as a --header arg (no space after the colon). On Windows, use cmd /c npx as shown above and add the --header args the same way.Bearer token:
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://yoursite.com/mcp/my-server",
        "--header",
        "Authorization:Bearer YOUR_BEARER_TOKEN"
      ]
    }
  }
}
Basic auth (base64-encode username:password first):
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://yoursite.com/mcp/my-server",
        "--header",
        "Authorization:Basic BASE64_USERNAME_PASSWORD"
      ]
    }
  }
}
API key (header):
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://yoursite.com/mcp/my-server",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}
API key (query param) or OAuth: Use the plain URL — no --header needed. For query-param keys, append ?keyName=YOUR_KEY to the URL. OAuth opens a browser flow automatically.
4

Fully quit and restart Claude Desktop

Closing the window is not enough — fully quit and relaunch. The server will appear in the MCP panel.
Fully quit and restart Claude Desktop after saving — closing the window is not enough.
Claude Desktop MCP docs

​
Claude Code

Requires: Claude Code CLI installed — npm install -g @anthropic-ai/claude-code
1

Open your terminal

Open your terminal.
2

Copy and run the command below

No authentication:
claude mcp add --transport http my-server https://yoursite.com/mcp/my-server
Bearer token:
claude mcp add --transport http my-server https://yoursite.com/mcp/my-server \
  --header "Authorization: Bearer YOUR_BEARER_TOKEN"
Basic auth (base64-encode username:password first):
claude mcp add --transport http my-server https://yoursite.com/mcp/my-server \
  --header "Authorization: Basic BASE64_USERNAME_PASSWORD"
API key (header):
claude mcp add --transport http my-server https://yoursite.com/mcp/my-server \
  --header "X-API-Key: YOUR_API_KEY"
API key (query param) or OAuth: Use the plain URL — no --header needed. For query-param keys, append ?keyName=YOUR_KEY to the URL.Other useful commands:
# List all connected MCP servers
claude mcp list

# Remove a server
claude mcp remove my-server
3

Claude Code confirms the server was added immediately

The server is registered right away — no restart needed.
4

Run /mcp inside Claude Code to verify the server appears

Type /mcp in Claude Code to confirm the server is listed and connected.
The server is added immediately — no restart needed.
Claude Code MCP docs

​
Cursor

Requires: Cursor editor installed
1

Open Cursor and go to Settings

Open Cursor and go to Settings.
2

Navigate to Tools & MCP, then click Add a custom MCP

Navigate to Tools & MCP, then click Add a custom MCP.
3

The mcp.json file opens in the editor

The mcp.json config file opens in the editor automatically.
4

Copy the configuration below, paste it into the mcpServers object, then save

No authentication:
{
  "mcpServers": {
    "my-server": {
      "url": "https://yoursite.com/mcp/my-server"
    }
  }
}
If your server has inbound authentication enabled, add a headers object before url:Bearer token:
{
  "mcpServers": {
    "my-server": {
      "headers": {
        "Authorization": "Bearer YOUR_BEARER_TOKEN"
      },
      "url": "https://yoursite.com/mcp/my-server"
    }
  }
}
Basic auth (base64-encode username:password first):
{
  "mcpServers": {
    "my-server": {
      "headers": {
        "Authorization": "Basic BASE64_USERNAME_PASSWORD"
      },
      "url": "https://yoursite.com/mcp/my-server"
    }
  }
}
API key (header):
{
  "mcpServers": {
    "my-server": {
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      },
      "url": "https://yoursite.com/mcp/my-server"
    }
  }
}
API key (query param) or OAuth: No headers needed — use the plain URL. For query-param keys, append ?keyName=YOUR_KEY to the URL.File location: ~/.cursor/mcp.json (global) · .cursor/mcp.json (project)
Restart Cursor after saving to apply the changes.
Cursor MCP docs

​
Windsurf

Requires: Windsurf editor installed
1

Open Windsurf and go to Settings

Open Windsurf and go to Settings.
2

Click on Cascade, then click Open MCP Registry

Click on Cascade, then click Open MCP Registry.
3

The mcp_config.json file opens in the editor

The mcp_config.json config file opens in the editor automatically.
4

Copy the configuration below and paste it into the mcpServers object, then save

No authentication:
{
  "mcpServers": {
    "my-server": {
      "serverUrl": "https://yoursite.com/mcp/my-server"
    }
  }
}
If your server has inbound authentication enabled, add a headers object before serverUrl:Bearer token:
{
  "mcpServers": {
    "my-server": {
      "headers": {
        "Authorization": "Bearer YOUR_BEARER_TOKEN"
      },
      "serverUrl": "https://yoursite.com/mcp/my-server"
    }
  }
}
Basic auth (base64-encode username:password first):
{
  "mcpServers": {
    "my-server": {
      "headers": {
        "Authorization": "Basic BASE64_USERNAME_PASSWORD"
      },
      "serverUrl": "https://yoursite.com/mcp/my-server"
    }
  }
}
API key (header):
{
  "mcpServers": {
    "my-server": {
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      },
      "serverUrl": "https://yoursite.com/mcp/my-server"
    }
  }
}
API key (query param) or OAuth: No headers needed — use the plain URL. For query-param keys, append ?keyName=YOUR_KEY to the URL.File location: ~/.codeium/windsurf/mcp_config.json
Restart Windsurf after saving to apply the changes.
Windsurf MCP docs

​
VS Code

Requires: VS Code with GitHub Copilot extension installed · Agent mode enabled: VS Code Settings → search “chat agent” → enable
1

Open (or create) .vscode/mcp.json in your project root

Open (or create) .vscode/mcp.json in your project root.For a global config, open the Command Palette and run MCP: Open User Configuration.
2

Copy the configuration below and paste it into the file

No authentication:
{
  "servers": {
    "my-server": {
      "type": "http",
      "url": "https://yoursite.com/mcp/my-server"
    }
  }
}
If your server has inbound authentication enabled, add a headers object. VS Code’s ${input:} syntax prompts you to enter the value securely on first use:Bearer token:
{
  "servers": {
    "my-server": {
      "type": "http",
      "url": "https://yoursite.com/mcp/my-server",
      "headers": {
        "Authorization": "Bearer ${input:my-server-key}"
      }
    }
  }
}
Basic auth:
{
  "servers": {
    "my-server": {
      "type": "http",
      "url": "https://yoursite.com/mcp/my-server",
      "headers": {
        "Authorization": "Basic ${input:my-server-key}"
      }
    }
  }
}
API key (header):
{
  "servers": {
    "my-server": {
      "type": "http",
      "url": "https://yoursite.com/mcp/my-server",
      "headers": {
        "X-API-Key": "${input:my-server-key}"
      }
    }
  }
}
API key (query param) or OAuth: No headers needed — use the plain URL. For query-param keys, append ?keyName=YOUR_KEY to the URL.File location: .vscode/mcp.json (workspace) · Command Palette → “MCP: Open User Configuration” (global)
3

Save — VS Code detects the file automatically, no restart needed

Save the file. VS Code picks it up automatically without a restart.
No restart needed — VS Code detects the file automatically on save.
VS Code MCP docs

​
OpenAI Playground

1

Go to platform.openai.com/playground/prompts

Go to platform.openai.com/playground/prompts.
2

Click the tools icon in the left panel, then select Add MCP server

Click the tools icon in the left panel, then select Add MCP server.
3

Enter the URL and label from the Connection Details below

Enter your server URL and a label name.
4

Under Authentication, select "Access token / API key" and paste your API key

If your server has authentication enabled (bearer, basic, or API key header), under Authentication select Access token / API key and paste your token or key value.For API key query param or OAuth, leave the authentication field empty — the key is appended to the URL or handled via browser flow.
5

Copy the URL below, paste it into the URL field, then click Connect

Click Connect.
No installation needed — OpenAI Playground connects to remote MCP servers natively.
OpenAI Playground MCP docs

​
Generic MCP Client

Any client that supports the MCP Streamable HTTP transport can connect using:
SettingValue
URLhttps://yoursite.com/mcp/{slug}
TransportStreamable HTTP
Content-Typeapplication/json
Auth HeaderAuthorization: Bearer YOUR_KEY (bearer) · Authorization: Basic BASE64 (basic) · X-API-Key: YOUR_KEY (api-key header)

​
Verifying the Connection

Once connected, ask your AI client to list available tools:
“What tools do you have available?”
The AI should respond with the tools configured in your GetMCP server. You can also verify the connection by checking GetMCP > Analytics — a successful MCP initialize call will appear in the call logs. GetMCP Server Connected to AI Client

​
Troubleshooting

  • Verify HTTPS is properly configured on your WordPress site
  • Check that the server status is Active in GetMCP admin
  • Confirm the URL is correct (slug and server_id match)
  • Ensure the MCP rewrite rules are flushed (visit Settings > Permalinks and click Save)
  • Your server has inbound authentication enabled
  • Verify the API key or token is correct
  • Ensure the Authorization header is being sent correctly for your client
  • For Claude Desktop: auth must be --header args in mcp-remote (e.g. "Authorization:Bearer TOKEN"), not a headers JSON key — mcp-remote does not support a headers object
  • The server is set to Paused status
  • Activate the server in GetMCP admin
  • Ensure tools are set to Active status
  • Ask the AI to refresh its tool list
  • In Claude Desktop, fully quit and restart — closing the window is not enough
  • Run /mcp in Claude Code to check the server status