关于 Halaxy MCP by usefulapi
Halaxy MCP 服务面向需要访问 Halaxy 诊疗运营数据的 MCP 客户端,支持查询患者、预约、时段和账单,并可创建患者、预约及临床记录草稿。
主要功能
- 01查询患者和执业人员
- 02查看预约、排班和可用时段
- 03读取账单、费用和转诊
- 04创建患者和预约
- 05创建临床记录草稿
适用场景
- 01查找患者及其预约信息
- 02检查可预约时段并安排预约
- 03创建患者记录或临床记录草稿
MCP 相关
通过 MCP 向客户端提供 Halaxy 数据查询与写入工具;登录使用 OAuth,凭据按用户保存。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://halaxy.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-halaxy https://halaxy.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-halaxy":{"type":"http","url":"https://halaxy.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-halaxy":{"type":"http","url":"https://halaxy.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-halaxy":{"type":"http","url":"https://halaxy.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-halaxy":{"serverUrl":"https://halaxy.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
usefulapi 提供的 Halaxy MCP
在线端点: https://halaxy.usefulapi.io/mcp
连接
- Claude(claude.ai、Desktop):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://halaxy.usefulapi.io/mcp。 - **Claude Code:**运行
claude mcp add --transport http halaxy https://halaxy.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code:添加到 VS Code。
- **Cursor 和其他客户端:**将此 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"halaxy": {
"url": "https://halaxy.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Halaxy 凭据。
分步设置指南、凭据查找位置及常见问题:https://usefulapi.io/halaxy/
首次连接时,你需要粘贴 Halaxy Client ID 和 Client Secret。系统会验证凭据、按用户分别存储,并将其限定为仅供你使用。配置文件中不会包含密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
halaxy_list_patients | read | 列出或搜索患者 |
halaxy_list_practitioners | read | 列出执业人员 |
halaxy_list_practitioner_roles | read | 列出执业人员角色(诊所地点) |
halaxy_list_organizations | read | 列出组织和诊所 |
halaxy_list_appointments | read | 列出预约 |
halaxy_list_schedules | read | 列出执业人员日程 |
halaxy_list_slots | read | 列出时段 |
halaxy_list_healthcare_services | read | 列出预约类型 |
halaxy_list_fees | read | 列出费用 |
halaxy_list_coverage | read | 列出患者保障信息(理赔详情) |
halaxy_list_invoices | read | 列出发票 |
halaxy_list_invoice_lines | read | 列出发票明细 |
halaxy_list_payment_transactions | read | 列出付款交易 |
halaxy_list_referrals | read | 列出转诊 |
halaxy_list_referral_definitions | read | 列出转诊模板 |
halaxy_get_patient | read | 获取患者信息 |
halaxy_get_practitioner | read | 获取执业人员信息 |
halaxy_get_practitioner_role | read | 获取执业人员角色 |
halaxy_get_organization | read | 获取组织信息 |
halaxy_get_appointment | read | 获取预约信息 |
halaxy_get_schedule | read | 获取日程 |
halaxy_get_slot | read | 获取时段 |
halaxy_get_healthcare_service | read | 获取预约类型 |
halaxy_get_fee | read | 获取费用 |
halaxy_get_coverage | read | 获取患者保障信息 |
halaxy_get_invoice | read | 获取发票 |
halaxy_get_invoice_line | read | 获取发票明细 |
halaxy_get_payment_transaction | read | 获取付款交易 |
halaxy_get_referral | read | 获取转诊 |
halaxy_get_referral_definition | read | 获取转诊模板 |
halaxy_find_available_appointments | read | 查找可预约时段 |
halaxy_create_patient | write | 创建患者 |
halaxy_create_appointment | write | 预约 |
halaxy_update_appointment_status | write | 更新预约状态 |
halaxy_create_clinical_note | write | 创建临床记录草稿 |
halaxy_usage_status | meta | 使用状态(免费套餐用量计数) |
halaxy_request_feature | meta | 请求添加缺失功能 |
halaxy_upgrade | meta | 升级到 Pro(无限使用*) |
halaxy_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应在执行前确认);meta 工具用于报告用量、管理订阅或发送功能请求。
定价
| 方案 | 价格 | 限额 |
|---|---|---|
| 免费版 | $0 | 每月 50 次工具调用 |
| 专业版(每个账户) | $9/mo 或 $90/yr(免费使用 2 个月) | 不限量* |
*专业版在此服务上的公平使用限额为每月 10,000 次工具调用。需要更多调用次数,请联系 [email protected]。
专业版仅适用于此服务。使用 halaxy_upgrade 订阅(它会返回 Stripe Checkout 链接)。随时可通过 halaxy_cancel_subscription 取消:专业版会持续到付费周期结束,当前周期不予退款;在此之前运行 halaxy_upgrade 可撤销取消操作。也可联系 [email protected]。
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。