MCP 服务器

MCP（模型上下文协议）服务器为 Claude Code 和 Codex 提供额外的工具和资源。你可以按项目或全局为所有会话配置 MCP 服务器。

MCP 范围

  • 项目 (.mcp.json) — 特定于工作区的 MCP 服务器，存储在工作区根目录
  • 用户 (~/.claude.json) — 对服务器上所有工作区可用的全局 MCP 服务器

管理 MCP 服务器

在工作区终端中，点击底部工具栏的 MCP 按钮。你会看到项目和用户 MCP 服务器的分区。

添加 MCP 服务器

点击 + 按钮添加新的 MCP 服务器。选择服务器类型：

Stdio（本地进程）

在服务器上运行本地命令作为 MCP 服务器。最适合本地安装的工具。

  • 服务器名称 — 用于标识此 MCP 服务器的唯一名称
  • 命令 — 要运行的命令（如 npx、python）
  • 参数 — MCP 服务器的命令行参数
  • 环境变量 — 进程的额外环境变量

示例 — 添加一个文件系统 MCP 服务器：

Name:    filesystem
Command: npx
Args:    -y @modelcontextprotocol/server-filesystem /path/to/dir

HTTP（远程）

通过 HTTP 连接到远程 MCP 服务器。最适合云端托管的工具和服务。

  • 服务器名称 — 用于标识此 MCP 服务器的唯一名称
  • URL — MCP 服务器的 HTTP 端点
  • 请求头 — 自定义 HTTP 请求头（如用于认证）

编辑和删除

  • 编辑 — 点击列表中的任何 MCP 服务器修改其配置
  • 删除 — 在 MCP 服务器上向左滑动可删除它
提示

编辑用户级 MCP 设置（~/.claude.json）时，ServerCC 会保留文件中它不管理的字段 — 你的其他 Claude 配置不会受影响。

配置文件

MCP 配置以 JSON 文件存储在服务器上：

  • 项目范围: {workspace}/.mcp.json
  • 用户范围: ~/.claude.json

这些文件遵循标准的 Claude MCP 配置格式，因此也与桌面端的 Claude Code 兼容。