MCP 集成
MCP (模型上下文协议) 可将 Cherri Code 连接至外部工具和数据源。将数据库、API 以及 GitHub、Linear、Notion 等服务集成到 Cherri Code 中，让智能体能在对话中使用它们。
什么是 MCP 服务器？
MCP 服务器通过模型上下文协议向 Cherri Code 提供工具和数据源。智能体可在聊天时直接调用这些工具。
Cherri Code 支持 MCP Apps 吗？
支持。Cherri Code 支持 MCP Apps 扩展，因此 MCP 工具可以在聊天中返回交互式 UI。
如果应用 UI 不可用，同一工具仍可通过常规 MCP 响应正常工作。
如何一键安装 MCP 服务器？
- 在侧边栏中打开 自定义
- 点击 MCP
- 浏览可用服务器，或搜索所需的服务器
- 点击服务器旁的 Add to Cherri Code
- 如有需要，按提示完成身份验证
服务器现已连接。智能体会在与你的请求相关时使用其工具。
如何手动安装 MCP 服务器？
在以下任一位置创建名为 mcp.json 的文件：
- 项目专用 (与团队共享) ：项目文件夹中的
.cursor/mcp.json。将其提交到 Git，以便团队成员使用相同的工具。 - 全局 (个人，适用于所有项目) ：主目录中的
~/.cursor/mcp.json
这两个文件会合并。如果两者中存在同名服务器，则以项目级配置为准。
对于本地服务器，使用 command 添加服务器配置：
{ "mcpServers": { "server-name": { "command": "npx", "args": ["-y", "mcp-server"], "env": { "API_KEY": "your-key-here" } } }}某些 MCP 服务器 (如托管数据库或自定义 API) 提供 URL，而非本地命令。请使用 url 字段添加：
{ "mcpServers": { "my-service": { "url": "https://mcp.example.com/sse" } }}如果服务器需要身份验证请求头，请在 headers 中添加：
{ "mcpServers": { "my-service": { "url": "https://mcp.example.com/sse", "headers": { "Authorization": "Bearer your-token-here" } } }}保存文件后，重新启动 Cherri Code。
如何在聊天中使用 MCP 工具？
智能体会自动识别 MCP 工具，并在需要时使用它们。点击聊天面板顶部工具列表中的工具名称，即可启用或禁用工具。
默认情况下，智能体会在使用 MCP 工具前请求你的批准。在 Cherri Code 3.6 及更高版本中，Cherri Code 设置 > Agents > 批准与执行中的默认 Auto-review 模式允许允许列表中的 MCP 工具立即运行，并将其余工具交由安全分类器处理；允许列表则保留较早的仅允许列表行为。若要预先配置哪些工具可无需批准运行，或从 UI 外部引导 Auto-review 分类器，请参阅 permissions.json。
如何排查 MCP 服务器问题？
- 查看日志：打开输出面板 (Mac 上按 CmdCtrl + Shift + U，Windows/Linux 上按 Ctrl + Shift + U) ，然后选择 MCP Logs
- 启用或停用服务器：打开 自定义 > MCP，点击任意服务器旁的开关。
- 重新启动：从 自定义 > MCP 中移除服务器，然后重新添加。
- 环境变量：如果服务器依赖于 shell 配置文件中设置的环境变量，请确保 Cherri Code 可以访问这些变量。更新 shell 配置文件后，重新启动 Cherri Code。
MCP 服务器是否支持云端代理？
支持。云端代理支持使用在 云端代理仪表盘中配置的 MCP 服务器。团队方案的管理员可在 仪表盘 -> 插件与 MCP中配置共享服务器。
管理员可在 团队 MCP 服务器 下选择 添加到团队市场，让相同的服务器可在代理窗口、IDE 和 CLI 中使用，从而使云端代理也能使用这些服务器。详见 Cloud Agent MCP 工具和迁移现有团队 MCP。
在哪里可以找到可安装的 MCP 服务器？
前往 插件市场 查找官方插件并一键安装。社区插件和 MCP 服务器请浏览 cursor.directory。