octop v1.0.0原生支持mcp v1.2协议，通过yaml配置连接器、api验证状态、agent绑定调用及分级日志调试实现开箱即用的工具集成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Octop v1.0.0 原生支持 MCP 协议，无需额外插件即可启用连接器。核心在于正确配置 MCP 客户端与目标服务器的通信链路，并确保工具能力被 Octop 的 Agent 调度层识别。
确认 Octop 版本与 MCP 兼容性
Octop v1.0.0 内置对 MCP v1.2 协议的支持，已适配 Anthropic 官方规范。运行以下命令验证：
-
检查版本：执行
octop --version，输出应为v1.0.0或更高 -
查看 MCP 状态：启动后访问
http://localhost:8080/api/mcp/status，返回{"enabled":true,"version":"1.2"}表示协议栈就绪 - 注意：v1.0.0 不兼容 MCP v1.0 降级握手，若连接失败请确认服务端未强制启用旧版协商逻辑
添加 MCP 连接器配置
Octop 使用 YAML 格式管理外部连接器，配置文件路径为 ~/.octop/config/mcp_connectors.yaml。一个典型配置如下：
-
基础字段必须包含：
name（唯一标识）、url（MCP 服务器地址，如http://localhost:3000）、auth_token（Bearer token，格式为sk-mcp-xxx） -
可选但推荐设置：
timeout_ms: 5000（避免长阻塞）、verify_ssl: false（开发环境跳过证书校验） - 保存后执行
octop mcp reload触发热加载，无需重启主进程
在 Agent 中调用 MCP 工具
Octop 的多 Agent 架构允许每个 Agent 绑定独立的 MCP 连接器。以“客服助理”Agent 为例：
- 在 Agent 配置中通过
mcp_connector: "crm-server"指定已注册的连接器名 - 工具调用时，自然语言指令如“查张伟上周订单”会被自动解析为 MCP 请求，发送至对应服务器的
/tools/query_order端点 - 返回结果经 Octop 的上下文注入机制整合进 LLM 提示，用户看到的是结构化摘要，而非原始 JSON
调试与常见问题
Octop 提供两级日志辅助排障：
-
连接层日志：启用
--log-level debug启动时，会输出 MCP 握手详情（如X-MCP-Version头是否匹配、WebSocket 子协议协商结果） -
工具调用日志：在
~/.octop/logs/mcp_calls.log中可查到每次请求的耗时、参数、响应状态码 - 典型错误：
401 Unauthorized多因auth_token格式错误或过期；503 Service Unavailable通常表示目标 MCP 服务器未运行或网络不通
