MCP Server 管理

把 Claude Code 的"扩展能力"变成可视化操作——不必手编 ~/.claude.json，不必查 JSON 字段格式，添加 / 启用 / 禁用 / 切作用域，全部在 GUI 里点选完成。

MCP 是什么

MCP（Model Context Protocol）是 Claude Code 的扩展机制，让 AI 调用外部工具或访问外部数据源。最常见的几类：

本地工具型：context7 文档检索、filesystem 文件操作、git 仓库查询
远程 API 型：内部知识库、CRM、监控系统的 HTTP 接口
自研脚本型：你团队的内部工具（如自动化部署、日志查询）

MCP Server 启动后，AI 在对话中可以"调用"它定义的工具，相当于给 Claude 装外挂。

三种服务器类型

智码 AICoder 支持完整的 MCP 三种连接方式：

类型	通信方式	适用场景
Stdio	本地启子进程，通过标准输入/输出通信	大多数本地工具，如 npx 启动的 MCP 包
HTTP	HTTP 请求 / 响应	远程 REST API，无状态调用
SSE	Server-Sent Events 长连接	远程流式服务，需要实时推送

双作用域

每个 MCP Server 可以绑定到两种作用域：

作用域	存储位置	适用
全局（user）	`~/.claude.json` 顶层 `mcpServers`	所有项目共用，如通用文档检索
项目级（project）	`~/.claude.json` 的 `projects[<path>].mcpServers`	仅在该项目目录启动会话时生效，如项目内部工具

切换作用域时，配置自动写到对应位置，无需手动改 JSON。

操作流程

添加 Stdio Server

设置 → MCP Server → 「添加」→ 选 Stdio：

字段	说明	示例
名称	同作用域内唯一	`context7`
Command	可执行命令	`npx`
Args	命令参数（每行一个）	`-y` `@upstash/context7-mcp@latest`
Env	环境变量 K-V	`API_KEY=sk-xxx`
Scope	全局 / 项目级	全局

保存后立即写入 ~/.claude.json，下次启动 Claude Code 时生效。

添加 HTTP / SSE Server

「添加」→ 选 HTTP 或 SSE：

字段	说明	示例
名称	同作用域内唯一	`internal-api`
URL	服务器端点	`https://api.example.com/mcp`
Headers	请求头 K-V	`Authorization: Bearer xxx`
Scope	全局 / 项目级	项目级

写入格式（HTTP/SSE 必须包含 type 字段）：

json

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://api.example.com/mcp",
      "headers": { "Authorization": "Bearer xxx" }
    }
  }
}

启用 / 禁用

每个 Server 卡片有开关，关掉时写入 "disabled": true，CLI 启动时会跳过它。

临时禁用 vs 删除

禁用保留所有配置，将来可一键打开（适合"暂时关掉看看是不是它的问题"）。删除彻底移除（适合不再用的 Server）。

编辑 / 重命名

编辑器允许修改任意字段。重命名时保留 disabled 状态——如果你之前禁用了它，重命名后仍是禁用。

列表视图

设置 → MCP Server 面板默认按作用域分组：

[全局 MCP Server]
  ✓ context7        npx -y @upstash/context7-mcp@latest
  ✗ filesystem      （已禁用）

[当前项目: /path/to/project]
  ✓ internal-api    https://api.example.com/mcp [HTTP]
  ✓ db-query        ./scripts/db-mcp.sh

每个条目右侧有「编辑 / 禁用 / 删除」按钮。

跨实例同步

MCP 配置在 ~/.claude.json 里，WebDAV 云同步默认勾选「Claude 配置」时会一并同步。换机器/设备时一次性带过来。

远程 Server 的认证密钥

如果 HTTP/SSE Server 的 Headers 里硬编码了 API Key，云同步时会明文上传到 WebDAV。建议：

私有 WebDAV 服务：可接受
公共云盘（如 webdav.aliyundrive.com）：把 Key 放本地环境变量，Server 配置只放占位符，导入后再补

常见 MCP Server 推荐

文档检索类

context7   →  npx -y @upstash/context7-mcp@latest

让 AI 实时查询任何库的官方文档，避免凭训练数据胡编 API。

文件系统类

filesystem  →  npx -y @modelcontextprotocol/server-filesystem /path

让 AI 读写指定目录（受 Claude 工具权限二次约束）。

Git 类

git  →  uvx mcp-server-git --repository /path/to/repo

让 AI 查询提交历史、diff、blame。

更多服务器列表见 MCP 官方仓库。

故障排查

现象	排查方向
Claude 启动后看不到 MCP 工具	检查是否禁用 / 检查 `~/.claude.json` JSON 格式是否合法
Stdio Server 启动失败	在终端手动跑一遍 `command + args` 看是否报错；环境变量是否齐全
HTTP Server 401/403	Headers 里 Authorization 是否正确；URL 末尾斜杠是否多/少
项目级 Server 没生效	Claude Code 启动时 cwd 必须正好等于配置里的项目路径
同名 Server 添加失败	同作用域内名称必须唯一；改个名或先删旧的

MCP Server 管理 ​

MCP 是什么 ​

三种服务器类型 ​

双作用域 ​

操作流程 ​

添加 Stdio Server ​

添加 HTTP / SSE Server ​

启用 / 禁用 ​

编辑 / 重命名 ​

列表视图 ​

跨实例同步 ​

常见 MCP Server 推荐 ​

文档检索类 ​

文件系统类 ​

Git 类 ​

故障排查 ​

相关章节 ​