ClaudeMap

Claude Code MCP Docs

把 MCP 服务器接进 Claude Code 的官方指南——作用域、传输与鉴权。

教程与指南officialdocsmcpclaude-code
访问项目

Claude Code 官方文档的 MCP 章节：用 claude mcp add 与 .mcp.json 添加服务器、项目/用户/企业三级作用域如何互动、stdio 与 HTTP 传输、远程服务器的 OAuth。客户端侧 MCP 配置的地面真相——协议线上发生了什么，再配协议规范阅读。

它做什么

  • 四种加 server 的官方途径——远程 HTTP、远程 SSE、本地 stdio 与远程 WebSocket——另支持从为其他客户端写的安装说明、从 URL、从 npx/uvx/二进制命令或从 mcpServers JSON 块导入
  • 作用域模型讲透:local、project、user 三级作用域的层级与优先级、项目 server 审批与工作区信任
  • 客户端运行时行为面向生产:动态工具更新、v2 运行时通知流、自动重连、会话中途掉线、首连失败与重试、带通道的推送消息、长工具调用自动后台化
  • 鉴权深度:命令行登录、固定 OAuth 回调端口、预配凭据、覆盖元数据发现、收窄 scope、动态请求头——以及 .mcp.json 的环境变量展开(含未设变量与空凭据语义)

什么时候用

Claude Code 客户端侧 MCP 配置的事实源——排查 server 连接前,先对照这里的作用域、传输与失败重试语义。

如何上手

非安装包——纯配置。本地 stdio 示例,放在项目根的 .mcp.json:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "my-mcp-server"],
      "env": {
        "API_KEY": "${MY_API_KEY}"
      }
    }
  }
}

环境变量按文档语法展开;未设变量遵循文档的默认语义。

注意事项

作用域既是技术决策也是团队决策——project 作用域与仓库所有人共享 server(且需审批/信任),user 作用域则不然;请有意选择,别默认接受。

收录日期

地图上的相关资源