Claude Code MCP：项目配置、传输与连接检查

什么时候用

• 团队需要共用服务器名称和接入方式，并分别管理每个人的认证。[1]

什么时候不用

• 你还没有核对服务器官方文档，或者只凭 JSON 可解析就要宣布接入成功。[1]

按三层定位问题

先核对配置形状，再检查服务器连接，最后检查任务工具。官方文档区分 HTTP 与 stdio：HTTP 配置使用 url；stdio 由本地 command 与 args 启动进程。不要把远程 url 放进没有 type 的条目，官方说明该情况会被当作 stdio 配置错误。[1]

项目级 HTTP 示例

{
  "mcpServers": {
    "demo-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

[1]

官方 CLI 示例可以用 claude mcp add --transport http demo-server --scope project https://example.com/mcp 生成项目配置。这里的 URL 仅为占位符，不应执行后期待连接成功。共享配置中只保留团队需要的接入描述，认证方式按具体服务器文档处理。[1]

用管理命令分辨状态

• claude mcp list：检查配置中是否有目标名称。
• claude mcp get demo-server：核对具体 transport、作用域与端点。
• 会话中的 /mcp：查看当前服务器状态，再按官方流程处理认证或项目服务器批准。
• 连接正常后，用无副作用的读取任务核对实际工具和响应；不把服务器名称当作工具能力证据。

[1]

本页核验到哪里

本页 JSON 在本地可解析，配置字段、项目作用域和管理命令已与官方文档对照；没有注册服务器、发起认证或调用 MCP 工具。排错时记录配置错误、连接错误、认证错误和工具结果，不把它们合成一个“接入失败”。这能决定下一步该改配置还是查服务器。[1]