一、最简上手
前置条件:已完成添加 MCP Server 中的基本安装操作,本机已安装 Node.js 18+。
以下用两个 MCP Server 搭建一个可实际工作的多 Server 环境:GitHub(代码协作)和 Context7(文档查询)。
启动 Claude Code,验证两个 Server 均已连接:
预期输出中两个 Server 均显示 connected。GitHub Server 首次连接时会触发 OAuth 认证流程,按提示在浏览器中完成授权。
验证成功后,直接给出一个跨 Server 任务:
Claude 会依次调用 GitHub Server 的工具获取 Issue 列表,再调用 Context7 的工具查询文档。两个 Server 的工具调用在对话中以 mcp__github__* 和 mcp__context7__* 前缀标识。
二、更多操作方式
命令行安装 vs 配置文件安装
命令行 claude mcp add 是逐个添加 Server 的快捷方式。当 Server 数量较多或需要团队共享时,直接编辑 .mcp.json 更高效——配置文件格式详见 .mcp.json 配置。
传输方式的选择和对比详见 MCP 概念。
作用域选择
- 个人调试用的 Server → 默认 local 作用域(仅自己可见)
- 团队项目共享的 Server →
--scope project(写入.mcp.json) - 所有项目通用的 Server →
--scope user(写入~/.claude.json)
作用域合并规则和优先级详见作用域管理。
三、参数与配置
环境变量传递
需要 API Key 的 Server 通过 -e 参数传入环境变量:
在 .mcp.json 中对应的写法: