接入 AI 客户端（IDE Integration）

ServBay 可以把内置的 MCP Server 一键接入你常用的 AI 客户端，自动写入对应的 MCP 配置，无需你手动编辑配置文件。本文介绍如何接入、支持哪些客户端，以及各客户端的接入方式。

前提条件

• 已安装并运行 ServBay。
• 已安装目标 AI 客户端（ServBay 据其配置判断是否可接入）。

一键接入

进入 ServBay 设置（Settings）→ AI 客户端集成（IDE Integrations），在客户端列表中找到目标客户端，点击 接入（Integrate）。ServBay 会：

1. 定位随发行版嵌入的 servbay-mcp 可执行文件（无需你单独安装）。
2. 按目标客户端的配置规范写入 MCP 配置（只新增 / 更新 servbay 节点，保留你已有的其它 MCP 配置）。
3. 显示接入状态。

若要撤销，点击 移除（Remove） 即可。

接入状态

每个客户端会显示其相对「本机这份 ServBay」的接入状态：

状态	含义
已接入	客户端已指向本机这份 ServBay 的 servbay-mcp
已接入（其它路径）	客户端配了 servbay 但指向别的路径（例如另一份 ServBay）
未接入	检测到客户端，但尚未接入
未检测到	未在本机找到该客户端

支持的客户端与接入方式

客户端	接入方式	配置位置
Claude Code	官方 CLI：claude mcp add --scope user --transport stdio servbay -- <bin>	Claude Code 用户级 MCP 配置
Codex	官方 CLI：codex mcp add（CLI 不可用时回退写 ~/.codex/config.toml）	Codex 配置
Cursor	写 ~/.cursor/mcp.json（顶层 mcpServers）	~/.cursor/mcp.json
VS Code / GitHub Copilot	写用户级 mcp.json（顶层 servers，type: stdio）	VS Code 用户级 mcp.json
Claude Desktop	写 claude_desktop_config.json（顶层 mcpServers）	claude_desktop_config.json

配置 schema 差异

不同客户端的 MCP 配置顶层键不同：VS Code 用 servers，Cursor / Claude Desktop 用 mcpServers。ServBay 会按各客户端规范自动写入正确的键，你无需关心这些差异。

验证接入

接入后，在对应 AI 客户端里发起一次与环境相关的请求（例如「列出 ServBay 当前运行的服务」），若 AI 能返回真实的服务列表，说明接入成功。

常见问题（FAQ）

• Q：接入会覆盖我已有的 MCP 配置吗？
  • A：不会。ServBay 只新增 / 更新 servbay 节点，保留你配置的其它 MCP Server。
• Q：客户端显示「未检测到」？
  • A：说明本机未找到该客户端。请先安装并运行一次该客户端后再接入。
• Q：接入后 AI 调用失败？
  • A：确认 ServBay 正在运行；对于用 CLI 接入的 Claude Code / Codex，确认其官方 CLI 可用。可尝试移除后重新接入。
• Q：接入后建议做什么？
  • A：建议再安装 AI 规则，引导 AI 优先、正确地使用 ServBay MCP。

总结

通过「AI 客户端集成」，你可以把 ServBay MCP 一键接入主流 AI 工具，全程无需手动改配置且不影响已有设置。接入完成后，配合 AI 规则，即可让 AI 顺畅地管理你的本地开发环境。