客户端配置

选择你正在使用的客户端配置一次即可。服务名称可以自定，下面的步骤统一使用 qnbot_docs。所有客户端都使用同一个地址 https://docs.qnbot.com/mcp。

Codex

Codex CLI 与 Codex 桌面端共用同一份用户级配置。在终端运行：

codex mcp add qnbot_docs --url https://docs.qnbot.com/mcp
codex mcp get qnbot_docs

也可以直接编辑 ~/.codex/config.toml：

[mcp_servers.qnbot_docs]
url = "https://docs.qnbot.com/mcp"

重新启动 Codex CLI 会话，或重新打开 Codex 桌面端即可生效。使用“永不请求审批”等无交互策略的会话，需要额外允许三个只读工具，见工具调用需要审批。

Claude Code

claude mcp add --transport http qnbot_docs --scope user https://docs.qnbot.com/mcp
claude mcp list

--scope user 让该服务在本机所有项目中可用；只想在当前项目使用时，把作用域改为 project，配置会写入项目根目录的 .mcp.json，便于随项目提交。打开 Claude Code 后运行 /mcp 确认 qnbot_docs 已连接。

Cursor

在项目根目录创建 .cursor/mcp.json；希望本机所有项目都能使用时，改用 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "qnbot_docs": {
      "url": "https://docs.qnbot.com/mcp"
    }
  }
}

重新打开 Cursor 或新建一个智能体会话，在 Cursor 设置的 MCP 页面确认 qnbot_docs 已连接并启用工具。

VS Code

在项目根目录创建 .vscode/mcp.json：

{
  "servers": {
    "qnbot_docs": {
      "type": "http",
      "url": "https://docs.qnbot.com/mcp"
    }
  }
}

在命令面板运行 MCP: List Servers 确认服务已启动，再在 GitHub Copilot 聊天的工具选择器中启用 qnbot_docs 的文档工具。

确认接入成功

客户端只有在重新启动或新建会话后才会加载新的 MCP 配置。让智能体调用一次 list_docs 或 search_docs，看到页面列表或搜索结果才算接通。

连接失败、工具调用需要审批，或让智能体按 markdownPath 读取全文，见验证与排查；三个工具的输入与返回内容见可用工具。