跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

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 传输类型。
类型适用场景
stdioMCP 服务作为本地命令运行
sseMCP 服务通过 Server-Sent Events 端点暴露
httpMCP 服务通过 HTTP 端点暴露
wsMCP 服务通过 WebSocket 端点暴露
如果没有指定类型，本地命令服务应使用默认的 stdio 行为。

​
作用域

使用 -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 和网络访问可用。
  • 如果服务已连接但工具调用被阻止，请检查权限提示。