MCP功能快速上手
1. 什么是MCP？
MCP（模型上下文协议）是一个开放协议，它允许大型语言模型（LLMs）访问自定义的工具和服务。Comate 作为 MCP 客户端，可以选择向 MCP 服务发起请求，使用它们提供的工具、读取数据源等，从而扩展功能。您可以为 Comate 添加所需的 MCP 服务。
2. 支持的传输类型
Comate 支持三种 MCP 服务的通信模式：
| STDIO 传输 | SSE 传输 | Streamable HTTP 传输 |
|---|---|---|
| 1.服务运行在本地 2.通信通过标准输入输出流进行通信 | 1.服务运行在本地或远程运行 2.通过服务器发送事件协议进行通信（SSE 传输已经在 2024-11-05 版本废弃，被 Streamable HTTP 替代，后者将 SSE 作为可选的流式传输机制纳入其中） | 1.服务运行在本地或远程 2.采用 HTTP POST 请求实现客户端到服务端的通信，并可选地通过服务器推送事件（SSE）流实现服务端到客户端的通信 3.采用 HTTP GET 请求请求实现客户端到服务端的通信，服务端通过 SSE 实现服务端到客户端通信 |
3. 配置MCP服务
Comate 目前支持在项目级配置 MCP 服务
配置入口
Comate IDE 和插件的入口略有不同，Comate IDE 可以在 Comate 页面，点击标题栏最右侧的“更多”按钮，可以看到弹出的下拉框中有 MCP 选项，若之前没有配置过 MCP，点击后即可跳转到 MCP 市场。
 |
 |
 |
|---|
添加MCP
方式一：通过 MCP 市场完成添加
- 进入 MCP 入口后可以看到一个 tab 栏，切换到市场标签页即可见到全部 MCP 服务列表。
- 在 MCP 市场中，浏览或搜索所需 MCP 服务，点击“安装”打开安装指引，如果 MCP 需要填写一些必备的信息，会额外出现一个表单，填写后可以点击
JSON 配置预览查看填写的填写的状态。
 |
 |
 |
 |
|---|
方式二：手动完成添加
如果市场中没有想要的 server 或者正在开发一个 server，可以通过点击手动配置打开配置文件，Comate 支持项目级和全局级 MCP 配置，项目级位于打开的项目的 .comate/mcp.json，全局级位于家目录的 .comate/mcp.json 下。
- 点击右上角“手动配置”，选择配置的层级，打开对应的
mcp.json文件
- 填写想要使用的 MCP server 的配置信息
1{
2 "mcpServers": {
3 "sequential-thinking": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "@modelcontextprotocol/server-sequential-thinking"
8 ]
9 }
10 }
11}- 手动添加后，一定要手动添加到 agent 中，避免出现 server 已经成功启动，但是 agent 无法调用的情况
 |
 |
 |
|---|
4. 验证调试
- 当您在市场中/手动添加后，跳转回“已安装” tab 页，可以看到该 MCP server 会被识别到且自动启动，如果没有看到启动，可以点击右上角更新全部按钮确保 MCP 服务正常运行。
2.可以跳转到“已安装”的 tab 页查看已经安装的 MCP server，配置的 MCP server 有四种状态，分别对应四种颜色的状态灯
| 未启动 | 已启动 | 启动中 | 启动失败 |
|---|---|---|---|
 |
 |
 |
 |
启动失败后可以点击“查看日志”灰色按钮，从 Baidu Comate MCP 对应的 MCP server 输出通道中查看输出日志
5. 在对话中使用 MCP 工具
在对话中，如果 Comate 认为您的问题与某个 MCP Server 相关，它将自动使用 MCP 中提供的工具。如果您认为本次对话有必要使用某个工具，只需告知 Comate 使用该工具名称或描述即可。
- 默认情况下，当 Comate 想要使用 MCP 工具时，它会显示一条消息请求您的批准。
- 当您同意 Comate 使用后，将自动完成 MCP 工具的使用，并将结果作为上下文继续生成后面的内容。
- 如果 MCP 工具会调用很多次，在确认 MCP server 时可信任的前提下，可以勾选自动执行，自动执行启动时，会折叠输入参数和结果，你可以点击卡片展开
 |
 |
 |
|---|
6. 查看/启用/禁用 已安装的MCP服务
- 若已安装了MCP服务，在进入配置项目MCP服务页面的”已安装“页签中，可看到所有已安装过的MCP服务。
- 若您暂时不需要某个MCP服务生效，可以通过该MCP服务最后的”开关“操作，进行启用/禁用 启用/禁用与对话中是否可调用成功无关，禁用则一定无法调用。
7. 使用前须知
为了帮助您更好地使用MCP功能，我们温馨提醒您关注以下使用要点（相关功能正在持续优化中）：
使用条件
目前 MCP 仅支持 Zulu 模式下使用，建议您提前确认账户剩余的 Comate 可用次数，以确保流程顺利进行。
工具稳定性说明
由于 MCP 工具的调用逻辑由 AI 模型自主决策，且可能涉及不同开发者编写的服务端代码，存在以下需要您理解的情况：
- 工具调用具有不确定性，可能出现未触发调用或调用未成功的情况。
- 每次调用尝试（无论结果如何）都将消耗 1 次 Comate 使用次数。
- 我们建议您在关键流程中做好备用方案，以确保服务连续性。
文件配置规范
为保障 MCP 服务稳定运行，请特别注意：
- 项目路径 .comate/mcp.json 的配置文件需控制总行数在 5000 行以内。
- 超过行数限制可能导致服务加载异常，建议定期优化文件结构。