MCP / API
好啦体检 MCP
通过一个 Streamable HTTP 端点，为员工福利、个人体检和保险客户服务接入体检方案、门店、预约、订单与体检件能力。
26
工具
9
无需登录
17
需要登录令牌
Streamable HTTP
传输方式
接入地址
https://ai.ihaola.com.cn/api/mcp/haola-pe
MCP 客户端
支持 Streamable HTTP 的客户端可直接添加服务地址。
Agent Skill
企业版和个人版 Skill 可安装后直接使用。
鉴权
公开工具可直接调用，个人方案与预约等工具需要用户令牌。
企业团检报价
knowledge_get → plan_quotation → 按档位和人群读取 planList
个人方案与预约
vendor_list → plan_recommend → reservation_book
订单与改期取消
order_list → order_detail → reservation_modify / reservation_cancel
工具参数摘要
参数名称以 MCP tools/list 返回的 inputSchema 为准。
| 工具 | 登录 | 用途 | 主要参数 |
|---|---|---|---|
| vendor_list | 免登录 | 查门店地址。 | city、province、district、hospitalCode、longitude、latitude、radius、vendorids |
| vendor_brands | 免登录 | 查各体检品牌覆盖的城市（品牌聚合摘要，不返回具体门店）。 | 无 |
| order_list | 需要 | 查订单。 | limit、page、filter |
| welfare_list | 需要 | 查用户体检件。 | ID、partnerid、userid、serviceid、rootid、mobile、name |
| corp_inquiry | 免登录 | 提交企业商务咨询。 | company、contact、phone、employees、city、budget、message |
| corp_contact | 免登录 | 查询好啦商务对接人（团检/商务合作）：返回对接人姓名、电话、邮箱、二维码图片 URL。 | 无 |
| plan_quotation | 免登录 | 企业团检报价：quotes 为对象数组，每档一个方案。 | quotes、partnerId |
| plan_recommend | 需要 | 个人体检推荐：按调用方身份读用户名下体检件与模板，结合性别、婚姻状况、预算、健康诉求推荐体检项目，返回 data.selected_items（每项带 constraintId）与 planId。 | gender、marital、age、budget、mainComplaint、reportHistory、userContext、welfareid、modification、previousPackage |
| faq | 免登录 | 体检 FAQ。 | query |
| knowledge_get | 免登录 | 按需查询领域知识。 | uri |
| help | 免登录 | 三级帮助系统。 | ontology、sub_action |
| welfare_detail | 需要 | 查询指定福利的详细内容，包括检查项目列表、规则说明、适用机构等。 | welfareid、vendorid |
| cautions | 需要 | 根据体检项目查询注意事项（饮食、用药、禁忌等）。 | checkPackage、vendorid、serviceid |
| order_detail | 需要 | 查询单个订单完整详情，包括预约信息、医院信息、套餐项目、支付状态。 | serviceid |
| contact_list | 需要 | 按 relation/gender 查询当前用户的联系人。 | relation、gender |
| contact_get | 需要 | 查询指定体检人的完整信息（含脱敏证件号）。 | contactid、contactId |
| contact_create | 需要 | 创建家属临时联系人。 | customerName、customerMobile、customerID、IDType、gender、birthday、marital、relation |
| contact_update | 需要 | 更新体检人信息（姓名、手机号等）。 | contactid、contactId、customerName、customerMobile、customerID、IDType、gender、birthday、marital |
| contact_profile_get | 需要 | 按 contactid 查询联系人的结构化健康画像。 | contactid、contactId |
| contact_profile_save | 需要 | 仅在用户明确要求保存或更新长期健康画像时调用；仅推荐方案不得调用。 | contactid、contactId、demographics、measurements、lifestyle、problem_list、family_history、allergy_intolerance、surgeries、medications、examinations、preferences_constraints |
| contact_profile_correct | 需要 | 纠正联系人健康画像中的错误记录。 | contactid、contactId、targetContactid、targetContactId、entries |
| reservation_book | 需要 | 体检预约：按 planId 取出项目，交给伙伴接口下单。 | planId、hospitalCode、vendorid、appointmentDate、timespan、contactId、contactid、contactMethod、contactDraftId、relation、customerName、customerID、customerMobile、IDType、birthday、gender、marital、consent、payType、consentText |
| reservation_cancel | 需要 | 取消预约：按预约号取消；已支付订单会同时发起退款。 | reservationId |
| reservation_modify | 需要 | 更改预约日期：按预约号改期。 | reservationId、appointmentDate |
| card_list | 需要 | 根据卡号查卡密及兑换使用情况。 | cardId、limit |
| progress_report | 免登录 | 长耗时任务进度上报。 | text、stage、percent |
常见问题
- 有没有体检 API？
- 有。MCP 端点 https://ai.ihaola.com.cn/api/mcp/haola-pe，Streamable HTTP，协议版本 2025-06-18，工具清单以 MCP tools/list 实时返回为准。最后更新：2026-11
- 支持哪些客户端？
- 任何支持 MCP 或能装 Skill 的 Agent 都行：千问办公、豆包办公、DeepSeek Harness，以及 Claude Code、Claude Desktop、Cursor、VS Code、WorkBuddy、OpenClaw 等。网页版纯聊天的不行。最后更新：2026-11
- 要登录吗？
- 企业报价不用，匿名就能出分档方案；个人出方案和预约需要登录一次（手机号 + 短信 + 图形验证码），凭据存本机约 30 天。最后更新：2026-11
- 数据安全怎么保证？
- 等保三级、ISO 27001、ISO 9001；报告以结构化 JSON 交付；企业侧只能看到授权后的脱敏汇总。最后更新：2026-11
- 怎么验证连通？
- 调一次 vendor_brands——最轻的接口，能返回品牌和门店数就说明通了。最后更新：2026-11
- 能直接用 AI 生成体检方案并预约吗？
- 能。把好啦体检 MCP（https://ai.ihaola.com.cn/api/mcp/haola-pe）接入你的 AI 工具，企业场景按人均预算出分档方案，匿名即可报价；个人场景按年龄、性别、症状、预算出定制方案，方案生成和预约需登录。工具清单以 MCP tools/list 实时返回为准。最后更新：2026-11