New: watch your coding agents work, step by step, on a live board. Try the demo, no account

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.

The header value is never put in the link.

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" }

Source: learn.chatgpt.com/docs/extend/mcp?surface=cli

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"
      }
    }
  }
}

Source: docs.devin.ai/windsurf/plugins/cascade/mcp

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"

Source: docs.devin.ai/cli/extensibility/mcp/configuration

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"
      }
    }
  }
}

Source: geminicli.com/docs/tools/mcp-server/

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/

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.
Link
https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=my-server&connectorUrl=https%3A%2F%2Fexample.com%2Fmcp
README badge (Markdown)
[![Add to Claude](https://img.shields.io/badge/Add%20to-Claude-D97757?style=flat-square)](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=my-server&connectorUrl=https%3A%2F%2Fexample.com%2Fmcp)
HTML button
<a href="https://claude.ai/customize/connectors?modal=add-custom-connector&amp;connectorName=my-server&amp;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>
Link
https://cursor.com/install-mcp?name=my-server&config=eyJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke2VudjpNWV9TRVJWRVJfQVBJX0tFWX0ifX0%3D
cursor:// deeplink (opens the app directly)
cursor://anysphere.cursor-deeplink/mcp/install?name=my-server&config=eyJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke2VudjpNWV9TRVJWRVJfQVBJX0tFWX0ifX0%3D
README badge (Markdown)
[![Add to Cursor](https://img.shields.io/badge/Add%20to-Cursor-000000?style=flat-square)](https://cursor.com/install-mcp?name=my-server&config=eyJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke2VudjpNWV9TRVJWRVJfQVBJX0tFWX0ifX0%3D)
HTML button
<a href="https://cursor.com/install-mcp?name=my-server&amp;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>
Link
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
README badge (Markdown)
[![Install in VS Code](https://img.shields.io/badge/Install%20in-VS%20Code-0098FF?style=flat-square)](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)
HTML button
<a href="https://vscode.dev/redirect/mcp/install?name=my-server&amp;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 link
Link
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
README badge (Markdown)
[![Install in VS Code Insiders](https://img.shields.io/badge/Install%20in-VS%20Code%20Insiders-24BFA5?style=flat-square)](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)
HTML button
<a href="https://insiders.vscode.dev/redirect/mcp/install?name=my-server&amp;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>
Link
goose://extension?url=https%3A%2F%2Fexample.com%2Fmcp&name=my-server&header=Authorization%3D
README badge (Markdown)
[![Add to Goose](https://img.shields.io/badge/Add%20to-Goose-000000?style=flat-square)](goose://extension?url=https%3A%2F%2Fexample.com%2Fmcp&name=my-server&header=Authorization%3D)
HTML button
<a href="goose://extension?url=https%3A%2F%2Fexample.com%2Fmcp&amp;name=my-server&amp;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.

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.