codebuddy通过mcp标准功能接入服务注册中心与api网关，实时解析接口契约驱动调试：先检查mcp server状态，再绑定目标微服务实例，生成并执行请求，最后对比响应与openapi契约。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在微服务接口调试中遇到Feign调用404、参数错位或响应结构异常时，直接翻源码或抓包效率低，CodeBuddy的MCP标准功能可直接接入服务注册中心与API网关，实时解析接口契约并驱动调试流程。
确认MCP服务已就绪
打开CodeBuddy IDE，点击右侧边栏【Settings】→切换到【MCP】标签页，检查已有MCP Server列表中是否存在状态为绿色的crmeb或nacos-feign-mcp项。若无，则说明尚未完成基础服务接入，后续调试将无法获取真实服务元数据。
若列表为空，需先下载并运行对应MCP Server：例如调试Spring Cloud Alibaba项目，必须启用支持Nacos服务发现与Feign契约解析的MCP服务，而非仅配置通用HTTP代理类MCP。
绑定目标微服务实例
在Craft Agent对话框中输入：“我要调试navigation-facility-service的getBeaconDetail接口”，CodeBuddy会自动触发MCP服务扫描注册中心。
等待3～5秒，界面底部状态栏显示“✅ 已定位服务实例：navigation-facility-service@192.168.3.12:8081”，此时MCP已完成服务发现与健康检查，【该IP和端口必须与Nacos控制台中实际注册地址完全一致，否则后续请求将发往错误节点】。
若显示“⚠️ 未找到匹配服务”，请确认nacos服务名拼写（区分大小写）、命名空间是否为public、以及该服务是否处于HEALTHY状态。
生成并执行调试请求
第一步：点击已识别的接口名称右侧【Generate Request】按钮，CodeBuddy基于OpenAPI Schema自动生成完整请求体，含路径参数、查询参数及Header模板。
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 问题
第二步：手动补全路径参数beaconId值（如1024），此值必须为当前环境中真实存在的灯塔ID，否则返回空数据或404；若不确定ID范围，可先调用listBeacons接口获取列表。
第三步：点击【Send】，左侧显示原始HTTP请求详情，右侧实时渲染响应JSON，并自动高亮字段类型差异（如预期string但返回null）。
这一步操作起来很简单，直接点击发送即可，无需切换Postman或curl命令行。
对比契约与实际响应
方法一：在响应区域右键→选择【Compare with OpenAPI Spec】，CodeBuddy调用MCP内置校验器，逐字段比对实际返回与接口文档定义是否一致，标红显示缺失字段或类型冲突项（如文档写status: string，实际返回"status": 1）。
方法二：输入自然语言指令：“把响应里的lightStatus字段和Swagger文档里定义的枚举值对照一下”，CodeBuddy通过MCP读取服务端/v3/api-docs动态获取最新契约，输出匹配结果。
注意：若对比失败且文档未更新，MCP会提示“检测到契约变更，请同步更新服务端Swagger注解”，此时不可盲目修改客户端代码。
