指南

MCP 配置文件在哪?Claude、Cursor、VS Code 等应用一览

6 分钟阅读Delta MCP 团队出品

十二款 AI 应用的图标网格,包括 Claude、Cursor、VS Code 和 Windsurf,另有 Delta MCP 的图标,旁边是配置键 mcpServers、servers 和 context_servers。

简短回答

大多数 AI 应用把 MCP 服务器放在一个 JSON 文件里,键是 mcpServers。VS Code 用 servers,Zed 用 context_servers,Codex 用 TOML 表。在下面找到你的应用,改它的文件,再重启它。工具上限少见:VS Code 是 128 个,Windsurf 是 100 个。

本文内容

各个应用的 MCP 配置文件在哪里?

大多数应用都有一个对所有项目生效的文件,和一个只对单个项目生效的文件。下表给出这两种文件、打开它们的方法,以及你的服务器要写在哪个键下面。

各个应用的 MCP 配置文件在哪里?
应用配置文件键
Claude Codeclaude mcp add,或在会话里用 /mcp
  • 所有项目~/.claude.json
  • 单个项目.mcp.json
你自己的服务器和每个项目的服务器,都在 ~/.claude.json 里。项目里的 .mcp.json 是用来和团队共享的。
mcpServers
Claude DesktopSettings › Developer › Edit Config
  • macOS~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows%APPDATA%\Claude\claude_desktop_config.json
只支持本地服务器。Claude Desktop 提供 macOS 和 Windows 版本。
mcpServers
Cursor
  • 所有项目~/.cursor/mcp.json
  • 单个项目.cursor/mcp.json
mcpServers
VS Code命令:MCP: Open User Configuration
  • macOS~/Library/Application Support/Code/User/mcp.json
  • Windows%APPDATA%\Code\User\mcp.json
  • Linux~/.config/Code/User/mcp.json
  • 单个项目.vscode/mcp.json
serversVS Code 自己的格式。项目根目录下可移植的 .mcp.json 用的是 mcpServers。
WindsurfWindsurf 的文档现在放在 Devin Desktop 名下
  • macOS · Linux~/.config/devin/mcp_config.json
  • Windows%APPDATA%\devin\mcp_config.json
  • ~/.codeium/windsurf/mcp_config.json
第一个路径是现行的,在 Devin Desktop 名下。早期的 Windsurf 版本用最后一个。
mcpServers
Gemini CLI
  • 所有项目~/.gemini/settings.json
  • 单个项目.gemini/settings.json
mcpServers
Codexcodex mcp add <name> -- <command>
  • 所有项目~/.codex/config.toml
  • 单个项目.codex/config.toml
项目文件只对受信任的项目生效。
[mcp_servers.<name>]每个服务器一张 TOML 表。
LM StudioProgram 标签页 › Install › Edit mcp.json
  • ~/.lmstudio/mcp.json
mcpServers
ClineMCP Servers 图标 › Configure 标签页 › Configure MCP Servers
  • ~/.cline/data/settings/cline_mcp_settings.json
  • …/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
设置 CLINE_MCP_SETTINGS_PATH 可以移动这个文件。在 VS Code 里,它位于用户设置文件夹中。
mcpServers
Roo CodeMCP settings › Edit Global MCP 或 Edit Project MCP
  • 所有项目…/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
  • 单个项目.roo/mcp.json
项目文件的优先级高于全局文件。
mcpServers
Amazon Q聊天面板,工具图标
  • 所有项目~/.aws/amazonq/default.json
  • 单个项目.amazonq/default.json
这个面板写入的是 default.json。较旧的 ~/.aws/amazonq/mcp.json 和 .amazonq/mcp.json 默认仍会被读取。
mcpServers在较旧的 mcp.json 里。
Zed命令:zed: open settings file
  • macOS · Linux~/.config/zed/settings.json
  • Windows%APPDATA%\Zed\settings.json
context_servers

~ 是你的主目录:在 Windows 上是 C:\Users\you。

各个应用里怎么配置远程 MCP 服务器?

远程(HTTP)服务器需要一个 URL,但每个应用给字段起的名字都不一样。同一条配置没法从一个应用直接粘贴到另一个应用。

各个应用里怎么配置远程 MCP 服务器?
应用字段须知
Claude Code
  • "type": "http"
  • "url"
Claude Desktop — 不写在这个文件里。请在应用设置的 Connectors 下,把它添加为自定义连接器。
Cursor
  • "url"
  • "headers"可选
VS Code
  • "type": "http"
  • "url"
Windsurf
  • "serverUrl"
  • "url"
  • "headers"可选
地址用这两个名字中的哪一个都可以。
Gemini CLI
  • "httpUrl"
  • "url"
  • "headers"可选
httpUrl 是可流式传输的 HTTP,url 是 SSE。
Codex
  • url
  • bearer_token_env_var可选
  • http_headers可选
写在这个服务器的 TOML 表里。
LM Studio
  • "url"
  • "headers"可选
Cline
  • "type": "streamableHttp"
  • "url"
  • "headers"可选
旧的传输方式用 sse。
Roo Code
  • "type": "streamable-http"
  • "url"
  • "headers"可选
旧的传输方式用 sse。
Amazon Q — 在 MCP 面板里设置:传输方式选 http,再填 URL 和可选的请求头。
Zed
  • "url"
  • "headers"可选

各个应用的 MCP 工具数量上限是多少?

工具数量上限很少见。有两个应用写明了上限。其他应用各有各的办法来应对很长的工具列表。

各个应用的 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 写的。前四步适用于任何应用。

  1. 完全退出应用,再重新打开

    Claude Desktop 的指南说,改完它的文件之后,要完全退出再重新启动。其他应用可能会自己重新加载:如果服务器没有出现,就把你的应用重新打开。

  2. 检查 JSON 和键名

    语法错误,比如少了一个引号或多了一个逗号,会让应用读不了这个文件。然后检查键名:大多数应用是 mcpServers,VS Code 是 servers,Zed 是 context_servers。

  3. 使用绝对路径

    args 里的路径必须是绝对路径,不能是相对路径。

  4. 自己运行一遍命令

    把服务器的命令和参数粘贴到终端里运行。如果在那里就失败了,应用也同样启动不了它。

  5. 查看日志

    Claude Desktop 会写出 mcp.log,并为每个服务器写一个 mcp-server-NAME.log,在 macOS 上位于 ~/Library/Logs/Claude,在 Windows 上位于 %APPDATA%\Claude\logs。

  6. 在 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 个工具。

来源

  1. Claude Code, Connect Claude Code to tools via MCP (documentation) ~/.claude.json 和 .mcp.json 文件、mcpServers 键、http 类型,以及 Tool Search 默认开启。
  2. Model Context Protocol, Connect to local MCP servers Claude Desktop 的文件路径、Edit Config、重启、故障排查步骤和日志文件夹。
  3. Claude Help Center, Get started with custom connectors using remote MCP 远程服务器是自定义连接器,与 claude_desktop_config.json 是两回事。
  4. Cursor, Model Context Protocol (documentation) 全局和项目的 mcp.json 文件、mcpServers、url 和 headers;没有写明工具数量上限。
  5. Cursor, Dynamic context discovery (2026年1月6日) 按需加载 MCP 工具描述。
  6. Cursor forum, About limitation of the number of MCP tools 一位用户反映存在 40 个工具的上限。
  7. VS Code, Add and manage MCP servers in VS Code (documentation) 工作区和用户的 mcp.json 文件、servers 键、可移植的 .mcp.json、http 类型。
  8. VS Code, Use tools with agents (documentation) 128 个工具的上限及其报错、工具选择器、虚拟工具。
  9. Windsurf, Cascade MCP Configuration (documentation, now on Devin Desktop’s site) 配置路径、mcpServers、serverUrl 或 url、100 个工具的上限、disabledTools。
  10. Gemini CLI, MCP servers with Gemini CLI (documentation) settings.json 文件、mcpServers、httpUrl 和 url。
  11. OpenAI Codex, Model Context Protocol (documentation) config.toml、mcp_servers 表、url、enabled_tools 和 disabled_tools、codex mcp add。
  12. LM Studio, Use MCP Servers (documentation) Edit mcp.json、mcpServers、url 和 headers。
  13. Cline, MCP (documentation) cline_mcp_settings.json 及其所在文件夹、Configure 标签页、streamableHttp。
  14. Roo Code, Using MCP in Roo Code (documentation) 全局的 mcp_settings.json 和项目的 .roo/mcp.json、streamable-http。
  15. AWS, MCP configuration for Q Developer in the IDE default.json 和较旧的 mcp.json、http 传输方式、工具权限。
  16. Zed, Model Context Protocol (documentation) settings.json 的路径、context_servers、url 和 headers。
  17. Delta MCP, Supported AI apps (documentation) Delta MCP 能识别的十二款应用、它读取的文件,以及它如何切换每一款应用。

继续阅读

用你自己的任务试试 Delta MCP

免费,两分钟配置好,一键即可全部还原。

免费 · 无需账号 · Apple 芯片或 Intel

免费 · 无需账号

免费 · 无需账号

关注发布动态

支持 Mac、Windows 和 Linux,无需账号。

即将发布

Delta MCP 即将发布

适用于 Mac、Windows 和 Linux 的免费应用即将发布。留下你的邮箱,上线的那一刻你就会知道。无需账号。

你的邮箱只用于在 Delta MCP 发布时通知你一次,不发订阅邮件。隐私政策