MCP 服务

Qoder CLI 可以连接 Model Context Protocol（MCP）服务，以使用外部工具和数据源。添加服务后，其中的工具会在交互式和非交互式会话中提供给 Agent 使用。

​

快速开始

使用 qodercli mcp add 添加 stdio MCP 服务。-- 后面的命令是 Qoder CLI 需要启动的服务进程。

qodercli mcp add playwright -- npx -y @playwright/mcp@latest

Stdio 服务会随 CLI 自动启动。如果 Qoder CLI 已在运行，使用 /mcp reload 重新发现 MCP 服务和工具；新的会话会在启动时自动发现。

​

服务类型

使用 -t 选择 MCP 传输类型。

类型	适用场景
stdio	MCP 服务作为本地命令运行
sse	MCP 服务通过 Server-Sent Events 端点暴露
http	MCP 服务通过 HTTP 端点暴露
ws	MCP 服务通过 WebSocket 端点暴露

如果没有指定类型，本地命令服务应使用默认的 stdio 行为。

启用 Shell 命令前缀后，Qoder CLI 会通过配置的可执行 wrapper 启动 stdio 服务。wrapper 会收到一个经过 shell 引号处理的原服务可执行文件及参数字符串，并且必须执行它，同时保留 stdio 和退出状态。配置值必须是单个可执行文件路径。该设置不影响 sse、http 或 ws 服务。

​

作用域

使用 -s 选择 MCP 服务配置的保存位置。

作用域	适用场景
user	希望该服务在当前账号的所有项目中可用
local	希望该服务只在本机当前项目中可用。默认作用域为 local
project	希望该服务配置随项目共享

MCP 服务配置会保存在以下文件中：

# 用户级配置。
~/.qoder/settings.json

# 本地项目级配置。通常不提交。
${project}/.qoder/settings.local.json

# 项目级配置。通常随项目提交。
${project}/.mcp.json

​

管理服务

列出已配置的服务：

qodercli mcp list

移除服务：

qodercli mcp remove playwright

​

推荐服务

常见 MCP 服务包括：

qodercli mcp add context7 -- npx -y @upstash/context7-mcp@latest
qodercli mcp add deepwiki -- npx -y mcp-deepwiki@latest
qodercli mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

​

权限

MCP 工具仍会经过 Qoder CLI 的权限系统。在默认模式下，调用 MCP 工具通常会请求确认。你可以批准某个具体工具、批准某个 MCP 服务下的所有工具，或在 settings 中配置规则。

MCP 工具名通常使用以下格式：

mcp__<server>__<tool>

示例：

{
  "permissions": {
    "allow": [
      "mcp__context7__*"
    ],
    "deny": []
  }
}

​

故障排查

如果 MCP 工具不可用：

• 运行 qodercli mcp list，确认服务已经配置。
• 如果 Qoder CLI 已在运行，添加或修改服务后执行 /mcp reload。
• 确认 -- 后面的命令可以在终端中正常运行。
• 对于基于 npx 的服务，确认 Node.js 和网络访问可用。
• 如果服务已连接但工具调用被阻止，请检查权限提示。