MCP config generator and one-click install links
Every agent client wants a remote MCP server written a little differently: a CLI flag here, url or serverUrl or httpUrl there, mcpServers or servers or mcp, a type of http, streamableHttp or remote. Fill in the server once and copy the version for each client.
Below the configs you also get one-click install links for Cursor, VS Code, Claude and Goose, with README badges and HTML buttons to paste into your docs.
Runs in your browser. Nothing you type is sent anywhere. Still, don't paste real keys on shared screens.
Claude Code
Run in a terminal (--scope user makes it available in every project)
claude mcp add --transport http --scope user my-server "https://example.com/mcp" --header "Authorization: Bearer YOUR_KEY"Source: code.claude.com/docs/en/mcp
Cursor
~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project)
{
"mcpServers": {
"my-server": {
"url": "https://example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}Source: cursor.com/docs/context/mcp
Codex CLI
~/.codex/config.toml
[mcp_servers.my_server]
url = "https://example.com/mcp"
http_headers = { "Authorization" = "Bearer YOUR_KEY" }Windsurf / Devin Desktop
~/.config/devin/mcp_config.json (older Windsurf: ~/.codeium/windsurf/mcp_config.json)
{
"mcpServers": {
"my-server": {
"serverUrl": "https://example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}Devin CLI / Devin Local
Run in a terminal (-s user saves it to ~/.config/devin/mcp_config.json for every project)
devin mcp add -s user -H "Authorization: Bearer YOUR_KEY" my-server "https://example.com/mcp"VS Code (Copilot agent mode)
.vscode/mcp.json in the workspace, or your user mcp.json (MCP: Open User Configuration)
{
"servers": {
"my-server": {
"type": "http",
"url": "https://example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}Source: code.visualstudio.com/docs/agents/reference/mcp-configuration
Gemini CLI
~/.gemini/settings.json (or .gemini/settings.json in the project)
{
"mcpServers": {
"my-server": {
"httpUrl": "https://example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}Antigravity CLI (agy)
~/.gemini/config/mcp_config.json (or .agents/mcp_config.json in the workspace)
{
"mcpServers": {
"my-server": {
"serverUrl": "https://example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}Source: antigravity.google/docs/mcp
Cline
cline_mcp_settings.json (in the Cline panel, MCP Servers > Configure > Configure MCP Servers; Cline CLI: ~/.cline/data/settings/cline_mcp_settings.json)
{
"mcpServers": {
"my-server": {
"type": "streamableHttp",
"url": "https://example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}Source: docs.cline.bot/mcp/mcp-overview
OpenCode
opencode.json in the project root, or ~/.config/opencode/opencode.json for every project
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"my-server": {
"type": "remote",
"url": "https://example.com/mcp",
"oauth": false,
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}Source: opencode.ai/docs/mcp-servers/
One-click install links
Links, README badges and HTML buttons that add your server to Claude, Cursor, VS Code and Goose in one click. Put them in your README or docs.
- Links never carry your Authorization value. The Cursor link sets Authorization to Bearer ${env:MY_SERVER_API_KEY}, so people who install it set MY_SERVER_API_KEY in their environment before opening Cursor. The Goose link names Authorization without a value, so Goose opens its extension form and asks for the key. In VS Code and Claude they add the key themselves after installing (Claude's custom connectors don't take headers at all).
- If your server supports OAuth sign-in, leave the header out: every client then asks people to sign in, with no key to copy.
Claude
Try the linkhttps://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=my-server&connectorUrl=https%3A%2F%2Fexample.com%2Fmcp[](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=my-server&connectorUrl=https%3A%2F%2Fexample.com%2Fmcp)<a href="https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=my-server&connectorUrl=https%3A%2F%2Fexample.com%2Fmcp" title="Add my-server to Claude" style="display:inline-block;padding:8px 14px;border-radius:6px;background:#A8502F;color:#ffffff;font:600 14px/1.2 system-ui,sans-serif;text-decoration:none">Add to Claude</a>Cursor
Try the linkhttps://cursor.com/install-mcp?name=my-server&config=eyJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke2VudjpNWV9TRVJWRVJfQVBJX0tFWX0ifX0%3Dcursor://anysphere.cursor-deeplink/mcp/install?name=my-server&config=eyJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke2VudjpNWV9TRVJWRVJfQVBJX0tFWX0ifX0%3D[](https://cursor.com/install-mcp?name=my-server&config=eyJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke2VudjpNWV9TRVJWRVJfQVBJX0tFWX0ifX0%3D)<a href="https://cursor.com/install-mcp?name=my-server&config=eyJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke2VudjpNWV9TRVJWRVJfQVBJX0tFWX0ifX0%3D" title="Add my-server to Cursor" style="display:inline-block;padding:8px 14px;border-radius:6px;background:#000000;color:#ffffff;font:600 14px/1.2 system-ui,sans-serif;text-decoration:none">Add to Cursor</a>VS Code
Try the linkhttps://vscode.dev/redirect/mcp/install?name=my-server&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fexample.com%2Fmcp%22%7D[](https://vscode.dev/redirect/mcp/install?name=my-server&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fexample.com%2Fmcp%22%7D)<a href="https://vscode.dev/redirect/mcp/install?name=my-server&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fexample.com%2Fmcp%22%7D" title="Add my-server to VS Code" style="display:inline-block;padding:8px 14px;border-radius:6px;background:#0065A9;color:#ffffff;font:600 14px/1.2 system-ui,sans-serif;text-decoration:none">Add to VS Code</a>VS Code Insiders
Try the linkhttps://insiders.vscode.dev/redirect/mcp/install?name=my-server&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fexample.com%2Fmcp%22%7D[](https://insiders.vscode.dev/redirect/mcp/install?name=my-server&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fexample.com%2Fmcp%22%7D)<a href="https://insiders.vscode.dev/redirect/mcp/install?name=my-server&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fexample.com%2Fmcp%22%7D" title="Add my-server to VS Code Insiders" style="display:inline-block;padding:8px 14px;border-radius:6px;background:#1A7F64;color:#ffffff;font:600 14px/1.2 system-ui,sans-serif;text-decoration:none">Add to VS Code Insiders</a>Goose
Try the linkgoose://extension?url=https%3A%2F%2Fexample.com%2Fmcp&name=my-server&header=Authorization%3D[](goose://extension?url=https%3A%2F%2Fexample.com%2Fmcp&name=my-server&header=Authorization%3D)<a href="goose://extension?url=https%3A%2F%2Fexample.com%2Fmcp&name=my-server&header=Authorization%3D" title="Add my-server to Goose" style="display:inline-block;padding:8px 14px;border-radius:6px;background:#000000;color:#ffffff;font:600 14px/1.2 system-ui,sans-serif;text-decoration:none">Add to Goose</a>GitHub removes goose:// links from READMEs, so use this one on your own site.
Setup notes for each client
Where each client keeps the file, how it handles keys and sign-in, how to check the server connected, and the gotchas from its docs.
- Add a remote MCP server to Claude Code
- Add a remote MCP server to Cursor
- Add a remote MCP server to Codex
- Add a remote MCP server to Windsurf
- Add a remote MCP server to Devin
- Add a remote MCP server to VS Code
- Add a remote MCP server to Gemini CLI
- Add a remote MCP server to Antigravity CLI
- Add a remote MCP server to Cline
- Add a remote MCP server to OpenCode
Questions
- Can an install link include my API key?
- No. Install links are public, so the generator never puts a header value in one. The Cursor link can name the header and read the key from an environment variable each person sets. In VS Code, Goose and Claude, people add the key after installing. A server with OAuth sign-in needs no key at all.
- Where do the badges point?
- Each badge is an img.shields.io image linked to that client's own install URL: cursor.com/install-mcp for Cursor, vscode.dev for VS Code, and the add custom connector dialog on claude.ai for Claude. Paste the Markdown into a GitHub README, or use the HTML button on your own site.
Need a task list for those agents?
Taskhold is a remote MCP server that gives Claude Code, Cursor, Codex and Windsurf a task list you share. Its setup link writes this config for the agent, so you don't have to. $12 a month or $120 a year, 7-day trial.
Or connect your agent first, no sign-up: add https://taskhold.com/api/mcp as an MCP server. The first time it uses Taskhold, it gives you the trial link.