MCP 服务 - Qoder

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

快速开始

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

qoder 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

管理服务

列出已配置的服务：

qoder mcp list

移除服务：

qoder mcp remove playwright

权限

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

mcp__<server>__<tool>

示例：

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

故障排查

如果 MCP 工具不可用：

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

​快速开始

​服务类型

​作用域

​管理服务

​推荐服务

​权限

​故障排查

快速开始

服务类型

作用域

管理服务

推荐服务

权限

故障排查