MCP 服务器

入口： 侧边栏 → 设置 → MCP 服务器

MCP（Model Context Protocol，模型上下文协议）是让 AI 连接外部工具和数据源的开放协议。通过添加 MCP 服务器，Claude 或 Codex 可以在对话中直接调用数据库查询、文件系统、Web 搜索等能力。例如，接入文件系统类或数据库类的 MCP 服务器后，AI 就能直接读取相应数据来回答问题，而无需你手动把内容复制粘贴进对话。

本页管理 Claude CLI 与 Codex CLI 各自的 MCP 服务器配置。页面顶部的 Claude | Codex 切换栏用于分别维护两个 CLI 的服务器列表。

MCP 服务器设置页面，顶部 Claude/Codex 切换栏，下方服务器列表每行显示状态灯、名称、作用域标签和传输协议摘要

服务器列表

列表中每条服务器记录显示以下信息：

状态灯 — 绿色表示已启用，暗色表示已停用
名称 — 服务器标识
作用域标签 — 用户（蓝色，存储在用户级配置，跨工作区生效）或 工作区（绿色，仅对当前关联的工作区生效）
传输协议摘要 — 如 stdio 或服务端地址

每行右侧提供三个操作：

编辑按钮（铅笔图标）— 打开编辑表单
删除按钮（红色垃圾桶图标）— 删除服务器，不可撤销
启用开关 — 拨动即可即时启用或停用，无需重新填写配置

Claude 模式下若未关联工作区任务，启用开关不可操作，可先在任务列表中点击一个工作区任务再切换；Codex 模式无此限制。

添加 MCP 服务器

点击列表页顶部的 新建 MCP 服务器 按钮打开配置表单。表单支持两种编辑模式，通过顶部切换按钮选择：表单（逐字段填写）或 JSON（直接粘贴完整配置）。

表单模式字段

字段	说明
作用域	选择用户或工作区；编辑现有服务器时作用域锁定，不可更改；未关联工作区时只能选用户
名称	服务器标识；创建后不可修改
类型	传输协议，见下表

类型选项：

类型	适用场景
stdio（本地命令）	通过本地子进程通信，适合大多数本地工具
HTTP (Streamable)	连接支持 Streamable HTTP 的远程服务端
SSE（Server-Sent Events）	连接通过 SSE 推送消息的远程服务端

以上类型名称均为界面原文，其中「HTTP (Streamable)」在界面中即以英文括号显示。

stdio 类型额外字段：

字段	说明
命令	启动服务器的可执行文件，如 `npx`
参数（空格分隔）	传递给命令的参数，如 `-y @modelcontextprotocol/server-memory`
环境变量（可选）	JSON 对象，注入服务器子进程的环境变量，如 `{"MY_API_KEY": "your-key"}`

HTTP / SSE 类型额外字段：

字段	说明
URL	服务端地址，如 `https://example.com/mcp`
请求头 Headers（可选）	JSON 对象，附加到请求的 HTTP 头，如 `{"Authorization": "Bearer ..."}`

JSON 模式

直接粘贴完整配置，支持两种格式：

json

{
  "my-mcp-server": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-memory"]
  }
}

或带 mcpServers 外层键的格式（与 claude_desktop_config.json 兼容）：

json

{
  "mcpServers": {
    "my-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

填写完成后点击添加保存；编辑现有记录时按钮文案为保存。点击取消或顶部 返回 MCP 列表 放弃变更。

快速上手示例：4 步添加一个 stdio 服务器

点击 新建 MCP 服务器，作用域 选用户
名称填一个标识（如 my-mcp-server），类型选 stdio（本地命令）
命令填 npx，参数（空格分隔） 填 -y @modelcontextprotocol/server-memory（此处以 memory 服务器为例，实际按所用包的官方说明填写）
点击添加返回列表，确认该服务器状态灯为绿色（已启用），即可在对话中使用

常见问题

stdio 服务器启动失败

确认命令字段中的可执行文件已安装且在系统 PATH 中可找到
检查参数是否正确，例如使用 npx 时确认包名有效
若需要 API Key，请在 环境变量 字段以 JSON 格式填写，不要拼入命令字符串

HTTP / SSE 服务器无法连接

确认服务端地址可从本地网络访问
需要认证时请在 请求头 Headers 中填写 Authorization 等认证头

下一步

插件 — 通过插件市场扩展 CLI 功能，安装第三方工具集
技能 — 管理预置的专项工作流，在对话中通过 / 命令快速触发

MCP 服务器 ​

服务器列表 ​

添加 MCP 服务器 ​

表单模式字段 ​

JSON 模式 ​

常见问题 ​