MCP 配置生成器
选择客户端和所需的服务器,即可获取符合该客户端格式要求的配置、相应的 CLI 命令(如果支持),以及无法运行的项目提示。
{
"mcpServers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
},
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp"
},
"playwright": {
"type": "stdio",
"command": "npx",
"args": [
"@playwright/mcp@latest"
]
}
}
}
也可以从命令行添加
claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --transport http --scope project context7 https://mcp.context7.com/mcp
claude mcp add --scope project playwright -- npx @playwright/mcp@latest
输出说明
托管或本地
托管服务器是客户端通过 Streamable HTTP 访问的 URL;服务器由供应商运行,无需安装任何内容。本地服务器通过 npx、uvx 或 docker 作为子进程启动,并使用这台机器的访问权限运行。如果服务器同时提供这两种方式,生成器会优先选择托管模式,并允许你切换。
密钥不会写入文件
生成器绝不会写入真实密钥,而是使用各客户端自己的引用语法:Claude Code 中的 ${VAR}、Cursor 和 Windsurf 中的 ${env:VAR}、VS Code 中的 inputs 提示、Gemini CLI 中的 $VAR、Codex 中的 env_vars,以及 Continue 中的 ${{ secrets.VAR }}。其他客户端会使用 <VAR> 占位符,供你填写。
首次使用时进行 OAuth 授权
此处大多数托管服务器都通过 OAuth 登录。客户端会在首次连接时打开浏览器,也可以运行其登录步骤:在 Claude Code 中运行 /mcp,在 Codex 中运行 codex mcp login,在 Devin 中运行 devin mcp login,或在 OpenClaw 中运行 openclaw mcp login。Slack、Asana 和 HubSpot 只接受预先注册的客户端,请确认你的客户端受支持。
编辑后重新加载
Claude Desktop 会在启动时读取配置文件,因此修改后请退出并重新打开;在 macOS 上,其日志位于 ~/Library/Logs/Claude。如果新服务器没有出现在其他客户端中,请重启客户端或重新加载窗口。在 OpenClaw 中,运行 openclaw mcp doctor <name> --probe 可测试单个服务器。
配置常见问题
Cursor 和 Claude Code 的 mcp.json 应放在哪里?
Cursor 会为每个项目读取项目中的 .cursor/mcp.json,或读取 ~/.cursor/mcp.json。Claude Code 会读取仓库根目录下的 .mcp.json 作为项目级配置,并将本地级和用户级配置保存在 ~/.claude.json 中。VS Code 使用 .vscode/mcp.json,Codex 则使用 ~/.codex/config.toml,而不是 JSON。
为什么 claude_desktop_config.json 无法加载远程服务器?
Claude Desktop 只会从该文件读取本地服务器。远程服务器需要在“设置 > 连接器”中添加为自定义连接器,并在此处粘贴 URL 和登录。因此,生成器会单独列出这些 URL。
如何避免将 API 密钥提交到 .mcp.json?
请引用环境变量,而不要直接粘贴密钥。Claude Code 会展开 ${VAR} 和 ${VAR:-default},Cursor 会展开 ${env:NAME},VS Code 则可以通过 inputs 条目提示输入密钥。启动客户端前,请在 shell 或密钥管理器中设置该变量。
能否在不同客户端之间共用一份 MCP 配置?
不能直接通用:大多数客户端使用顶层键 mcpServers,但 .vscode/mcp.json 使用 servers,Zed 使用 context_servers,Codex 使用 mcp_servers 表。有些客户端可以导入其他客户端的配置文件:VS Code 会发现 Claude Desktop、Cursor 和 Windsurf 的配置,Continue 可以直接导入 mcp.json,JetBrains AI Assistant 则提供“从 Claude 导入”选项。
为什么 Claude Desktop 在 Windows 上运行 npx 会失败?
MCP servers README 在 Windows 上通过 cmd 运行 npx:使用 command cmd,并将 /c、npx 和软件包作为参数。选择 Claude Desktop 和 Windows 后,生成器会自动添加此包装命令。
应该使用服务器的托管版本还是本地版本?
托管版更简单:无需安装运行时,而且 OAuth 可以取代保存在磁盘上的长期令牌。如果服务器需要访问本机文件或凭据,或者没有托管端点(例如 Filesystem、Playwright 或 AWS API server),则适合使用本地版。