codebuddy原生支持mcp协议，需手动配置服务端点、认证及传输方式；启用需在设置中勾选“启用mcp协议支持”并重启；配置文件为项目根目录下.mcp.json，须含合法json结构与必填字段；配置后状态栏显示“mcp服务已加载”即生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy原生支持MCP（Model Context Protocol）标准，无需额外插件即可启用，但必须手动配置服务端点、认证信息和传输方式，否则AI无法调用外部工具。
确认MCP协议支持已开启
打开CodeBuddy编辑器 → 点击右上角齿轮⚙️按钮 → 进入“设置”面板 → 找到“高级功能”选项卡 → 勾选【启用MCP协议支持】 → 重启编辑器。
这一步不可跳过。未勾选时，所有MCP配置文件均被忽略，界面也不会显示MCP相关入口。
定位并编辑mcp.json配置文件
方法一：通过UI快捷添加（推荐新手）
点击对话窗口右上角齿轮⚙️ → 切换到“MCP”标签页 → 点击右侧“添加MCP”按钮 → 系统自动创建或定位到项目级.mcp.json文件。
方法二：手动查找路径
项目根目录下查找.mcp.json；若不存在，则新建该文件；若存在但为空，直接覆盖写入；【切勿修改用户级~/.codebuddy.json中的mcpServers字段，项目级配置优先级更高】。
填入合法的MCP服务配置
第一步：复制标准JSON结构框架
确保根对象为{ "mcpServers": { ... } }，外层不能有多余字段或逗号。
第二步：粘贴目标服务配置块
例如CRMEB服务需填入：
{ "crmeb": { "url":"https://v5.crmeb.net/outapi/mcp", "headers": { "account":"demo", "password":"crmeb.com", "Content-Type":"application/json" } } }
第三步：检查语法与字段完整性
每个服务名（如"crmeb"）必须是合法键名，不能含空格或特殊符号；url和headers为必填字段；【缺少headers或url会导致连接立即失败，且无明确报错提示】。
第四步：保存文件并等待热重载
CodeBuddy会在1–3秒内自动读取变更，右下角状态栏出现“MCP服务已加载”即生效。
验证MCP服务是否可用
在编辑器中新建空白文件 → 输入自然语言指令，例如：“查一下CRMEB演示账号的订单总数” → 触发AI思考后，观察底部状态栏是否出现“正在调用crmeb服务…”字样。
若长时间显示“等待工具响应”或直接返回“未找到可用工具”，说明配置未生效：请返回检查.mcp.json是否位于当前项目根目录、JSON格式是否合法、服务名是否与指令中引用的一致。
