MCP 配置生成器 — Claude、Cursor、VS Code、Windsurf 和 Codex

只需定义一次 MCP 服务器，即可得到 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf 和 Codex 各自所需的配置文件或命令。

添加常用服务器

服务器名称

传输方式

命令

只填写可执行文件：npx、uvx、docker、node 或完整路径。

环境变量

每行一个 KEY=value。写 ${VAR} 可引用 shell 中的变量。

参数（每行一个）

每一行成为数组中的一项。路径包含空格也没问题。

服务器名称

传输方式

服务器 URL

使用 OAuth 登录的服务器无需填写请求头。

HTTP 请求头

每行一个 Name: value。

不要把密钥写进文件：将每个环境变量的值替换为对同名 shell 变量的引用（例如 GITHUB_TOKEN=${GITHUB_TOKEN}）。

claude_desktop_config.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/projects"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.githubcopilot.com/mcp/",
        "--header",
        "Authorization:${MCP_HEADER_1}"
      ],
      "env": {
        "MCP_HEADER_1": "Bearer ${GITHUB_PAT}"
      }
    }
  }
}

文件位置：macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 为 %APPDATA%\Claude\claude_desktop_config.json（可通过 Settings > Developer > Edit Config 打开）。保存后完全退出并重新打开 Claude。
远程服务器通过 mcp-remote 桥接（需要 Node.js）。付费套餐也可以在 Settings > Connectors 中添加 URL，它会替你处理 OAuth。
Claude Desktop 不会展开此文件中的 ${VAR}；请将这些占位符替换为真实值。

完全在你的浏览器中运行。配置中常含有 API 令牌，因此你输入或粘贴的任何内容都不会被上传或保存。浏览全部免费工具.

发现问题，或者觉得哪里可以更好？每条消息我们都会阅读，并尽快修复。

这款 MCP 配置生成器通过一个表单，为所有主流 AI 客户端生成 Model Context Protocol 服务器设置。每个客户端要求的文件都略有不同：Claude Desktop 和 Cursor 使用“mcpServers”对象，VS Code 使用“servers”且必须有“type”，Windsurf 把远程 URL 叫作“serverUrl”，Claude Code 的远程条目需要“type”，Codex 则使用 TOML 表。只需输入一次命令或 URL，然后复制你所用工具对应的版本即可。

验证器则反过来：粘贴一份无法加载的配置，它会指出 JSON 错误、缺失的字段或客户端不读取的键，然后把服务器载入表单，方便你转换格式。它检查的是结构，而不是服务器包是否存在或令牌是否有效；如果服务器仍然失败，请查看客户端的 MCP 日志。

使用方法

点击 Filesystem 或 GitHub 等预设，或添加一个空白服务器。
本地服务器：设置命令（npx、uvx、docker），每个参数单独一行。远程服务器：设置 URL 以及所需的 headers。
可勾选将密钥排除在文件之外的选项，把值替换为 ${VAR} 引用。
选择你的客户端，然后复制或下载输出，并保存到下方显示的路径。
重启客户端（完全退出 Claude Desktop），让它重新加载配置。要修复现有文件，把它粘贴到“验证与转换”中。

常见问题

claude_desktop_config.json 在哪里？

在 macOS 上位于 ~/Library/Application Support/Claude/claude_desktop_config.json，在 Windows 上位于 %APPDATA%\Claude\claude_desktop_config.json。打开它最简单的方法是在 Claude Desktop 中依次点击 Settings > Developer > Edit Config。保存后请完全退出并重新打开 Claude，因为该文件只在启动时读取。

Claude Code 的 .mcp.json 和 claude mcp add 有什么区别？

claude mcp add 在终端中注册服务器。使用默认的 local 作用域时，它保存在 ~/.claude.json 中，只对你自己和当前项目生效；--scope user 让它在你的所有项目中可用；--scope project 会把它写入项目根目录的 .mcp.json，让团队通过版本控制共享。.mcp.json 中的每个条目都应带有“type”（stdio、http 或 sse）；有 url 但没有 type 的条目会被当作 stdio 读取，从而失败。

为什么 VS Code 忽略了我的 mcpServers 配置？

VS Code 读取的是 .vscode/mcp.json，顶层键为“servers”而不是“mcpServers”，并且每个服务器都需要 "type": "stdio"、"http" 或 "sse"。所以从 Claude 或 Cursor 的 README 中复制来的文件什么也加载不了。把它粘贴到验证器中，转换为 VS Code 格式即可。

如何避免把 API 密钥写进 MCP 配置？

引用环境变量，而不是直接粘贴值。Claude Code 支持展开 ${VAR} 和 ${VAR:-default}；Cursor 和 Windsurf 使用 ${env:VAR}；VS Code 支持 ${env:VAR} 以及能安全存储密钥的 ${input:id} 提示；Codex 通过 env_vars、env_http_headers 和 bearer_token_env_var 转发变量。Claude Desktop 不会展开配置中的变量，所以那里的值必须是字面值。

如何在 Claude Desktop 中添加远程 MCP 服务器？

Claude Desktop 的配置文件只能启动本地命令。付费套餐用户可以在 Settings > Connectors 中添加远程服务器 URL，它还会处理 OAuth 登录。否则，可以用 mcp-remote 做桥接：命令为 npx，参数为 -y、mcp-remote 和服务器 URL，再加上用于认证的 --header 选项。选择 Claude Desktop 时，生成器会自动为你写好这个桥接配置。

stdio、HTTP 和 SSE 传输方式有什么区别？

stdio 服务器作为本地进程运行，由客户端启动并通过标准输入输出与之通信，适合读取文件或在本机运行的工具。Streamable HTTP 服务器在远程通过 URL 运行，是目前托管服务器的标准方式。SSE 是较旧的远程传输方式；Claude Code 已将其标记为弃用，Codex 只支持 streamable HTTP，所以服务器两者都提供时，优先选择 HTTP。

MCP 配置文件位置与格式

• Claude Desktop：claude_desktop_config.json，位于 ~/Library/Application Support/Claude（macOS）或 %APPDATA%\Claude（Windows）。顶层为“mcpServers”；条目包含 command、args 和 env。

• Claude Code：项目根目录中的 .mcp.json（project 作用域），或 ~/.claude.json（local 和 user 作用域，由 claude mcp add 管理）。顶层为“mcpServers”，每个条目带“type”。

• Cursor：项目中的 .cursor/mcp.json，或全局的 ~/.cursor/mcp.json。使用“mcpServers”；远程条目使用“url”和“headers”。

• VS Code：工作区中的 .vscode/mcp.json，或通过“MCP: Open User Configuration”打开的用户级文件。顶层为“servers”，另有可选的“inputs”。

• Windsurf：~/.codeium/windsurf/mcp_config.json。Windsurf 的文档现已归入 Devin Desktop，后者使用 ~/.config/devin/mcp_config.json（macOS/Linux）或 %APPDATA%\devin\mcp_config.json。远程条目使用“serverUrl”。

• Codex：~/.codex/config.toml，或受信任项目中的 .codex/config.toml。每个服务器一个 [mcp_servers.<name>] 表，包含 command/args/env，或 url 加 bearer_token_env_var 和 http_headers。

MCP 服务器无法加载的常见原因

• 整条命令都写在了“command”里（"npx -y @scope/server"）。客户端会去找一个以这整串为名的可执行文件。应把 npx 放在 command 中，其余部分放在 args 中，每项一个。

• JSON 中有结尾逗号或 // 注释。只有 VS Code 的 mcp.json 接受注释；其他客户端都要求严格的 JSON。

• 找不到 npx 或 uvx。macOS 上的图形界面应用不一定继承 shell 的 PATH；请用 `which npx` 得到的完整路径作为命令。

• 顶层键写错：在 Claude 或 Cursor 文件中用了“servers”，或在 VS Code 中用了“mcpServers”。

• Claude Code 的 .mcp.json 中远程条目没有“type”，结果被当作本地命令处理。

• 没有重启客户端。Claude Desktop 只在启动时读取配置文件；Cursor 和 VS Code 会在各自的 MCP 设置面板中显示服务器状态。

添加服务器前的安全须知

MCP 服务器以你的权限运行：文件系统服务器可以读取和修改你列出的每个文件夹，数据库服务器可以用你提供的凭据执行查询。请授予能满足需要的最小范围，比如单个项目文件夹、只读数据库用户，或仅限所需仓库的细粒度 GitHub 令牌。

从官方发布者处安装服务器，涉及生产环境的一律锁定版本，优先选择支持 OAuth 的远程服务器，而不是把长期有效的令牌粘贴进文件。把工具输出视为不可信的输入：服务器抓取的网页或 issue 中可能包含针对模型的指令。