codebuddy 通过 mcp 架构支持自然语言调用第三方工具，需确保 cli ≥v2.3.0、mcp 子系统就绪、正确安装并配置对应 mcp server（如企业微信），最后用自然语言指令触发任务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用自然语言一句话描述需求，CodeBuddy 就能调用第三方工具自动完成任务，比如“把当前目录下所有 .log 文件发到企业微信”，无需写脚本、不用记 API 密钥、不碰 curl 命令。
确认 CodeBuddy CLI 已安装并支持 MCP
打开终端，执行 codebuddy --version，输出版本号且不低于 v2.3.0；若提示 command not found，需先从 https://www.php.cn/link/8564449fd15870d9eba8f7cbf3c63f70 下载对应系统安装包并完成 PATH 配置。
运行 codebuddy mcp list，应返回空列表或已安装的 MCP 服务名称——这说明 CLI 的 MCP 子系统已就绪，可加载外部服务。
获取并安装目标第三方工具的 MCP Server
方法一：从官方 MCP 广场一键安装
访问 腾讯云 MCP 广场 → 搜索关键词（如 “企业微信”、“draw.io”、“EdgeOne Pages”）→ 找到对应 Server → 点击「Install」按钮，自动下载并注册到本地 CLI。
方法二：手动拉取开源 MCP Server
以 draw.io MCP 为例：执行 git clone https://github.com/jgraph/drawio-mcp-server.git → 进入目录后运行 npm install && npm start → 服务默认监听 http://localhost:3000。
【必须确保服务进程持续运行且端口未被占用】。若启动失败，常见原因是 Node.js 版本低于 18.x，此时需升级后再试。
配置 MCP 客户端连接参数
第一步：编辑 CLI 配置文件
执行 codebuddy config edit，在打开的 YAML 文件中找到 mcp.servers 节点。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
第二步：添加新服务条目
按如下格式插入（以企业微信 MCP Server 为例）：
- name: wecom-notify<br> url: http://localhost:5001<br> enabled: true
第三步：保存退出并重载配置
执行 codebuddy mcp reload，CLI 会主动向该地址发起 OPTIONS 请求验证连通性；若返回 HTTP 200 且无报错，则连接成功。
注意：URL 必须是完整地址，不能省略 http:// 或写成 127.0.0.1——某些 MCP Server 对 Host 头校验严格，用 localhost 才能通过。
在自然语言指令中触发第三方工具
直接输入：codebuddy "把 ./output/report.html 发到企业微信「运维值班群」"
CLI 自动识别「企业微信」为已注册 MCP 工具，提取文件路径与群名，构造结构化请求发送至 http://localhost:5001，服务端完成鉴权、上传、消息推送全流程。
如果返回「工具未响应」，先检查 codebuddy mcp list 是否显示该服务状态为 active；若显示 inactive，说明服务进程已断开，需重新启动对应 Server 进程。
