简短回答
大多数 AI 应用把 MCP 服务器放在一个 JSON 文件里,键是 mcpServers。VS Code 用 servers,Zed 用 context_servers,Codex 用 TOML 表。在下面找到你的应用,改它的文件,再重启它。工具上限少见:VS Code 是 128 个,Windsurf 是 100 个。
本文内容
各个应用的 MCP 配置文件在哪里?
大多数应用都有一个对所有项目生效的文件,和一个只对单个项目生效的文件。下表给出这两种文件、打开它们的方法,以及你的服务器要写在哪个键下面。
| 应用 | 配置文件 | 键 |
|---|---|---|
Claude Codeclaude mcp add,或在会话里用 /mcp |
~/.claude.json 里。项目里的 .mcp.json 是用来和团队共享的。 | mcpServers |
| Claude DesktopSettings › Developer › Edit Config |
| mcpServers |
| Cursor |
| mcpServers |
VS Code命令:MCP: Open User Configuration |
| serversVS Code 自己的格式。项目根目录下可移植的 .mcp.json 用的是 mcpServers。 |
| WindsurfWindsurf 的文档现在放在 Devin Desktop 名下 |
| mcpServers |
| Gemini CLI |
| mcpServers |
Codexcodex mcp add <name> -- <command> |
| [mcp_servers.<name>]每个服务器一张 TOML 表。 |
| LM StudioProgram 标签页 › Install › Edit mcp.json |
| mcpServers |
| ClineMCP Servers 图标 › Configure 标签页 › Configure MCP Servers |
CLINE_MCP_SETTINGS_PATH 可以移动这个文件。在 VS Code 里,它位于用户设置文件夹中。 | mcpServers |
| Roo CodeMCP settings › Edit Global MCP 或 Edit Project MCP |
| mcpServers |
| Amazon Q聊天面板,工具图标 |
default.json。较旧的 ~/.aws/amazonq/mcp.json 和 .amazonq/mcp.json 默认仍会被读取。 | mcpServers在较旧的 mcp.json 里。 |
Zed命令:zed: open settings file |
| context_servers |
~ 是你的主目录:在 Windows 上是 C:\Users\you。
各个应用里怎么配置远程 MCP 服务器?
远程(HTTP)服务器需要一个 URL,但每个应用给字段起的名字都不一样。同一条配置没法从一个应用直接粘贴到另一个应用。
| 应用 | 字段 | 须知 |
|---|---|---|
| Claude Code |
| |
| Claude Desktop | — | 不写在这个文件里。请在应用设置的 Connectors 下,把它添加为自定义连接器。 |
| Cursor |
| |
| VS Code |
| |
| Windsurf |
| 地址用这两个名字中的哪一个都可以。 |
| Gemini CLI |
| httpUrl 是可流式传输的 HTTP,url 是 SSE。 |
| Codex |
| 写在这个服务器的 TOML 表里。 |
| LM Studio |
| |
| Cline |
| 旧的传输方式用 sse。 |
| Roo Code |
| 旧的传输方式用 sse。 |
| Amazon Q | — | 在 MCP 面板里设置:传输方式选 http,再填 URL 和可选的请求头。 |
| Zed |
|
各个应用的 MCP 工具数量上限是多少?
工具数量上限很少见。有两个应用写明了上限。其他应用各有各的办法来应对很长的工具列表。
| 应用 | 上限 | 对很长的工具列表怎么办 |
|---|---|---|
| VS Code | 每次请求 128 个工具 | 超过这个数,VS Code 会报告 Cannot have more than 128 tools per request。你可以在工具选择器里取消选择某些工具或整个服务器,或者设置 github.copilot.chat.virtualTools.threshold,让 VS Code 把相似的工具归为一组。 |
| Windsurf | 同时 100 个工具 | 在服务器的配置项里用 disabledTools 逐个关掉工具。 |
| Cursor | 未写明上限 | 常被引用的数字是 40 个工具。Cursor 的文档没有给出上限,它在 2026年1月的文章里介绍了按需加载 MCP 工具描述的做法。 |
| Claude Code | 未写明上限 | Tool Search 默认开启:在某个工具被用到之前,只有工具名称会进入你的上下文。 |
| Codex | 未写明上限 | 每个服务器都可以设置 enabled_tools 和 disabled_tools 列表。 |
| Amazon Q | 未写明上限 | 每个工具可以设为 Ask、Always allow 或 Deny。 |
Claude Desktop、Gemini CLI、LM Studio、Cline、Roo Code 和 Zed 都没有写明工具数量上限。
上限说的是能放下多少个工具。这些工具要花多少 token,是另一个问题,下面这篇指南回答了它。 MCP 为什么这么耗 token
为什么你的 MCP 服务器没有出现?
沿着这个清单往下查。它依照 MCP 项目的故障排查指南,那份指南是为 Claude Desktop 写的。前四步适用于任何应用。
- 完全退出应用,再重新打开
Claude Desktop 的指南说,改完它的文件之后,要完全退出再重新启动。其他应用可能会自己重新加载:如果服务器没有出现,就把你的应用重新打开。
- 检查 JSON 和键名
语法错误,比如少了一个引号或多了一个逗号,会让应用读不了这个文件。然后检查键名:大多数应用是
mcpServers,VS Code 是servers,Zed 是context_servers。 - 使用绝对路径
args里的路径必须是绝对路径,不能是相对路径。 - 自己运行一遍命令
把服务器的命令和参数粘贴到终端里运行。如果在那里就失败了,应用也同样启动不了它。
- 查看日志
Claude Desktop 会写出
mcp.log,并为每个服务器写一个mcp-server-NAME.log,在 macOS 上位于~/Library/Logs/Claude,在 Windows 上位于%APPDATA%\Claude\logs。 - 在 Windows 上检查 APPDATA
如果日志里某个路径中出现了
${APPDATA},就把APPDATA连同它的完整取值加到该服务器的env里,比如C:\Users\you\AppData\Roaming\。
这些文件非得手动改吗?
想把它们集中在一处查看,不用手动。Delta MCP 会读取十二款 AI 应用的 MCP 设置,也就是上面表格里的那些,不会改动任何东西,并列出它找到的每个服务器。
要通过 Delta MCP 使用这些服务器,它会添加一条名为 mcpdelta 的配置,把应用切换过来。它会关掉每个被迁移服务器的直接配置,并保留原件,以便原样还原。其中十款应用由它帮你切换;Codex 和 Zed 目前要手动设置。每次改动之前,它都会保存一份带日期的文件副本。
常见问题
claude_desktop_config.json 在哪里?
在 macOS 上是 ~/Library/Application Support/Claude/claude_desktop_config.json,在 Windows 上是 %APPDATA%\Claude\claude_desktop_config.json。最快的办法是 Settings › Developer › Edit Config,如果文件不存在,它会帮你创建。Claude Desktop 提供 macOS 和 Windows 版本。
Cursor 的 mcp.json 在哪里?
~/.cursor/mcp.json 存放所有项目共用的服务器,项目里的 .cursor/mcp.json 存放该项目自己的。两者都使用 mcpServers 键。
VS Code 的 mcp.json 在哪里?
项目的是 .vscode/mcp.json。你自己的在用户配置文件夹里:运行 MCP: Open User Configuration 就能打开。VS Code 把服务器写在 servers 下,而不是 mcpServers。
VS Code 里 MCP 的工具数量上限是多少?
一次聊天请求最多可以同时启用 128 个工具,超过时 VS Code 会报告 Cannot have more than 128 tools per request。你可以在工具选择器里取消选择工具或服务器,或者设置 github.copilot.chat.virtualTools.threshold,让 VS Code 把相似的工具归为一组。
Cursor 有 MCP 工具数量上限吗?
它的文档没有写明上限;常被引用的数字是 40 个工具。2026年1月,Cursor 介绍了按需加载 MCP 工具描述的做法。
为什么我的 MCP 配置在另一个应用里不能用?
键名和远程服务器的字段各不相同。大多数应用用 mcpServers;VS Code 用 servers,Zed 用 context_servers,Codex 用 TOML 表。远程服务器在 Cursor 里是 url,在 Windsurf 里是 serverUrl 或 url,在 Gemini CLI 里是 httpUrl 或 url,在 Claude Code 和 VS Code 里是 type 加 url。
Claude Desktop 能通过配置文件使用远程 MCP 服务器吗?
不能。远程服务器要在应用设置里添加为自定义连接器。claude_desktop_config.json 里的服务器是另一套机制,在 Cowork 或 claude.ai 里用不了。
Claude Code 把 MCP 服务器存在哪里?
你自己的服务器和各个项目的服务器,都在 ~/.claude.json 里。项目根目录的 .mcp.json 是用来和团队共享的。可以用 claude mcp add 添加服务器,也可以在会话里用 /mcp。两个文件都用 mcpServers 键。
Windsurf 的 mcp_config.json 在哪里?
Windsurf 的文档现在归在 Devin Desktop 下,给出的路径是 macOS 和 Linux 上的 ~/.config/devin/mcp_config.json,以及 Windows 上的 %APPDATA%\devin\mcp_config.json。早期的 Windsurf 版本用 ~/.codeium/windsurf/mcp_config.json。服务器放在 mcpServers 下,Windsurf 一次允许 100 个工具。
来源
- Claude Code, Connect Claude Code to tools via MCP (documentation) ~/.claude.json 和 .mcp.json 文件、mcpServers 键、http 类型,以及 Tool Search 默认开启。
- Model Context Protocol, Connect to local MCP servers Claude Desktop 的文件路径、Edit Config、重启、故障排查步骤和日志文件夹。
- Claude Help Center, Get started with custom connectors using remote MCP 远程服务器是自定义连接器,与 claude_desktop_config.json 是两回事。
- Cursor, Model Context Protocol (documentation) 全局和项目的 mcp.json 文件、mcpServers、url 和 headers;没有写明工具数量上限。
- Cursor, Dynamic context discovery (2026年1月6日) 按需加载 MCP 工具描述。
- Cursor forum, About limitation of the number of MCP tools 一位用户反映存在 40 个工具的上限。
- VS Code, Add and manage MCP servers in VS Code (documentation) 工作区和用户的 mcp.json 文件、servers 键、可移植的 .mcp.json、http 类型。
- VS Code, Use tools with agents (documentation) 128 个工具的上限及其报错、工具选择器、虚拟工具。
- Windsurf, Cascade MCP Configuration (documentation, now on Devin Desktop’s site) 配置路径、mcpServers、serverUrl 或 url、100 个工具的上限、disabledTools。
- Gemini CLI, MCP servers with Gemini CLI (documentation) settings.json 文件、mcpServers、httpUrl 和 url。
- OpenAI Codex, Model Context Protocol (documentation) config.toml、mcp_servers 表、url、enabled_tools 和 disabled_tools、codex mcp add。
- LM Studio, Use MCP Servers (documentation) Edit mcp.json、mcpServers、url 和 headers。
- Cline, MCP (documentation) cline_mcp_settings.json 及其所在文件夹、Configure 标签页、streamableHttp。
- Roo Code, Using MCP in Roo Code (documentation) 全局的 mcp_settings.json 和项目的 .roo/mcp.json、streamable-http。
- AWS, MCP configuration for Q Developer in the IDE default.json 和较旧的 mcp.json、http 传输方式、工具权限。
- Zed, Model Context Protocol (documentation) settings.json 的路径、context_servers、url 和 headers。
- Delta MCP, Supported AI apps (documentation) Delta MCP 能识别的十二款应用、它读取的文件,以及它如何切换每一款应用。