Claude MCP 连接器：三个入口、配置示例与连接验证

Claude MCP 连接器有三个入口：Claude.ai、Claude Desktop 和 Claude Code，远程服务器三处都能连。Claude.ai 和 Claude Desktop 从 Connectors Directory 一键连接，或者添加自定义连接器填服务器 URL；Claude Code 用 claude mcp add 添加，再用 /mcp 完成 OAuth 登录。配置完成后还差一步：在对话输入框的加号菜单里选中这个连接器，Claude 才会在这次对话里用它。

完整路径是四步：选入口、完成 OAuth、检查授权范围与工作区限制、做一次连通性检查。判断标准只有一个，对话里能看到 Claude 真的调用了该服务器的工具；列表里多一行名字，只说明添加成功。

Claude MCP 连接器能在哪些入口连接？

三个入口都能连远程服务器，本地进程则要看客户端支不支持。选入口之前，先分清服务器是别人托管好的远程服务，还是要在您本机跑起来的进程。远程服务器是别人维护的一个地址，认证走 OAuth；本地进程由客户端在自己的配置文件里用 command 和 args 描述怎么启动。下面 Claude Code 那条命令添加的是远程服务器。

目录里的连接器点一下 Connect，登录一次就行。没进目录的服务走自定义连接器，步骤如下：

1. 在 Claude.ai 里打开 Customize > Connectors，点“+ Add”，选 Add custom connector。
2. 填入连接器名称和服务器 URL，点 Continue。
3. Claude 会检测认证设置，核对一遍；需要的话，在 OAuth client 或 Request headers 里补上自己的凭据。
4. 点 Add 完成。

然后在对话输入框的加号菜单里选中它，这次对话才会用上。

Claude Desktop 连远程服务器的路径和 Claude.ai 一样：目录里一键连接，或者在 Customize > Connectors 加自定义连接器再走 OAuth。只有本地服务器不同，它不走 Connectors，而是走 Settings 里的 Edit Config。

命令行这边，远程服务器用 claude mcp add 添加，在浏览器里完成 OAuth 登录，回到终端后用 /mcp 查看状态。默认作用域是当前项目，换一个目录就看不到刚才那台服务器。

服务器只用于日常提问和文档整理的话，Claude.ai 或 Claude Desktop 就够了。要参与代码仓库里的操作，比如读 issues、跑浏览器自动化、查项目数据库，用 Claude Code 更顺手，它本来就带着当前项目的文件和上下文。

Claude Code 怎么添加 MCP 服务器：命令、作用域与配置示例

在项目目录下运行一条 claude mcp add，就能把一台远程服务器注册进来。

claude mcp add --transport http your-server https://example.com/mcp

OAuth 流程会在浏览器里完成，登录授权后回到终端。默认情况下，这台服务器只在当前项目里可用；要让它跟着您走，加 --scope user：

claude mcp add --transport http --scope user your-server https://example.com/mcp

全局注册的代价是每个项目都会看到这台服务器，工具列表变长，提示面也跟着变大，所以只服务一个项目的服务器留在项目里更干净。claude mcp list 用来确认注册结果，不需要了就用 claude mcp remove your-server 删掉。

本地进程与远程服务的两种写法

通用 MCP 配置把本地进程写成 command 与 args，把远程服务写成 url，配合 http 传输和 Authorization header。Claude Code 添加远程服务器用的就是上面那条命令。

字段名和可用的传输方式会随客户端版本变化，本机 claude mcp list 或 /mcp 显示的就是实际生效的配置。

不想用命令，可以直接改配置文件。用户级写 ~/.claude.json，对所有项目生效；项目级写项目根目录的 .mcp.json，只作用于当前项目。项目级配置能提交进 Git，团队成员克隆下来就有同一套服务器。正因为会进版本库，令牌一律走环境变量，配置里只出现变量名。

{
  "mcpServers": {
    "project-db": {
      "command": "npx",
      "args": ["-y", "your-mcp-server", "--db-path", "./data/app.db"]
    }
  }
}

Claude Code 在真实开发里怎么用，包括任务拆分和上下文管理，vibe coding 的完整工作流程那篇接着往下讲。

Claude Desktop 和 Claude.ai 的添加步骤有什么不同？

连远程服务器时，Claude Desktop 和 Claude.ai 没有区别：目录里一键连接，或添加自定义连接器填 URL 再走 OAuth。区别只在本地服务器，Claude Desktop 的 JSON 配置能加，Claude.ai 不能直接运行本地进程。

本地服务器只有桌面端能加

打开 Settings 里的 Developer，点 Edit Config，把 mcpServers 写进 JSON 配置：

{
  "mcpServers": {
    "your-server": {
      "command": "npx",
      "args": ["-y", "your-mcp-server"]
    }
  }
}

保存后重启 Claude Desktop，服务器的工具会在下一次对话里出现。JSON 少一个逗号或多一个括号，服务器都会静默失效，所以写完先用编辑器的 JSON 校验过一遍，比在对话里反复试工具快。

远程还是本地，看服务器放在哪里。服务商托管、团队共用同一个地址的，走远程。工具要访问这台机器上的文件和本地数据库的，只能走本地，换机器就得重新配置。

连接前要审查哪些权限：OAuth 范围、工作区限制与凭据存放

点授权之前，有三件事要看清：OAuth 阶段批准的范围、工作区有没有放开连接器、凭据放在哪里。

OAuth 批准的范围决定 Claude 能读到什么

授权页面上勾选的 scope，就是 Claude 之后能碰的数据边界，也是您交出去的那部分权限。范围不够会出现一种很难查的假象：服务器显示已连接，Claude 却读不到想要的数据，因为有些服务器要求特定 scope 才能读某类资源。范围先按最小的给，确实需要再加。

工作区与方案限制

在 Team 工作区里，只有 Owner 和 Primary Owner 能添加自定义连接器；Enterprise 工作区还包括拥有 Libraries 管理权限的自定义角色。所有者在 Organization settings 里打开 Connectors，点 Add，悬停 Custom 选 Web，填入服务器 URL。成员之后到 Customize 找到这个连接器，用自己的账号点 Connect 完成认证。工作区限制了连接器的话，目录条目也归同一条权限管，所有者放行一次，后面的成员各自连接即可。

免费方案只能添加一个自定义连接器，同时接多个自定义服务器要看更高方案；目录里的连接器所有方案都能用。这些限制来自账号方案与工作区策略，跟连接这个动作本身无关。

凭据存放

令牌放环境变量，配置文件里只引用变量名。写死在配置里，文件一旦被提交进 Git，密钥就等于公开了。发放时按最小权限来，能只读就不给写权限，再配合定期轮换和查看服务器日志；跑在内部网络的服务还可以收窄访问范围。

连上以后怎么验证，失败时按什么顺序排查？

新开一个对话，让 Claude 调用该服务器的一个工具。回复里出现工具调用，或者它直接给出服务器里的数据，就说明通了。

一次连通性检查

在 Claude Code 里，可以直接问它现在有哪些可用的 MCP 服务器，也可以用 /mcp 看注册与登录状态，或者在终端里跑 claude mcp list 看每台服务器的连接状态。/mcp 面板会在已连接的服务器旁标注工具数量，claude mcp list 则在连接失败的那一行附上原因。

验证分四层：服务器出现在列表、OAuth 已登录、工具清单成功返回、一次工具调用给出正确数据。只有最后一层能证明当前对话真的拿到了权限。

排查按这个顺序：

• 看不到数据：回到 OAuth，核对批准的范围是否覆盖要读的资源。
• 连不上服务器：检查 URL 是否写对、OAuth 是否走完，必要时断开重连。
• 连接器选项根本不出现：多半是方案或工作区没有放开。
• 服务器显示已连接、工具调用却失败：重点看权限与令牌。

还有一种情况是调用成功，结果却不如预期，比如查数据库时拉回整张表，Claude 拿到了数据却答得含糊。这通常是上下文被工具返回的内容占满了，把查询收窄成需要的几行几列，问题往往就消失。

工具层和模型访问层要分开看：拿到数据之后谁在跑模型

MCP 决定 Claude 能调用哪些工具，生成回答的模型仍然由当前入口和账号决定。连接器加得再多，也不会把 Claude 换成别的模型。工具返回的数据会进入上下文窗口，占用同一次对话的上下文预算。

数据进入上下文窗口之后

客户端需要直连模型 API 的话，MixRoute 提供 OpenAI 兼容端点 https://api.mixroute.ai/v1，可调用 250+ 模型，平台费 0%，接入方式与现有 OpenAI SDK 一致。工具授权和模型调用是两套权限：工具这边由 OAuth scope 管，模型这边由 key 管。MixRoute 的每把 key 可以限定成只能调用指定的模型集合，也可以设一笔逐次扣减、扣完即停的预算，账户余额始终是外层上限；这两项是 key 层级的独立字段，与请求如何被路由无关。两套状态分开记录，出错时才能判断是哪一层的问题。

想先看模型调用的价格，再决定账号与预算怎么接，可以看MixRoute 的方案与模型价格。

模型侧的账号结构、预算分账或结算方式需要先定下来的话，可以和 MixRoute 团队把账号与预算方案定下来，再开始接第一个工具。

选入口拿不准时，看服务器要碰哪台机器、谁来维护它。只读的远程知识库放在连接器目录里最省事；要访问本机文件或数据库，就在 Claude Desktop 或 Claude Code 的本地进程配置里设置；需要跟着项目目录和版本控制走的配置，放 Claude Code 的项目作用域，文件是项目根目录的 .mcp.json，评审代码时一起看得到。用户级注册适合个人服务，但新同事不会自动拿到它。

有些团队把连接器当依赖来管，记录服务器 URL、传输方式、负责人、scope 和最近一次验证日期。换服务器或换客户端时，拿同一条最小查询回归一次，列表、登录、工具返回和数据内容都通过，再决定要不要开放写操作。