关于 Nookal MCP by usefulapi
Nookal MCP by usefulapi 是托管式 MCP 服务,让用户通过 MCP 客户端读取 Nookal 诊所数据,涵盖地点、从业者、预约、客户、病例和发票。
主要功能
- 01列出地点、从业者、服务和课程
- 02查询预约可用时段
- 03列出预约并搜索客户
- 04获取病例、发票和付款记录
适用场景
- 01查询不同地点的预约可用时段
- 02查找客户或治疗病例
- 03查看预约、发票和付款记录
MCP 相关
向 MCP 客户端提供 Nookal 只读工具和元数据工具。托管服务使用用户的 Nookal API v3.0 Basic Key 和区域连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://nookal.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-nookal https://nookal.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-nookal":{"type":"http","url":"https://nookal.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-nookal":{"type":"http","url":"https://nookal.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-nookal":{"type":"http","url":"https://nookal.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-nookal":{"serverUrl":"https://nookal.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
11| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 页码(默认值为 1)。 |
| active | boolean | 否 | true = 仅限启用的位置,false = 仅限未启用的位置。 |
| page_length | integer | 否 | 每页条目数,范围为 1–100(默认值为 50)。 |
| location_ids | array | 否 | 仅限这些位置(数字型 Nookal ID,最多 100 个)。 |
详细介绍
usefulapi 提供的 Nookal MCP
在 Claude、Cursor 或任何 MCP 客户端中使用 Nookal——读取 Nookal 的地点、从业人员、可用时间、预约、客户、病例和发票。 托管服务,无需本地安装:使用你自己的 Nookal 凭据连接。
在线端点: https://nookal.usefulapi.io/mcp · 主页: https://usefulapi.io/nookal
连接
- Claude(claude.ai、桌面版):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴
https://nookal.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http nookal https://nookal.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将此 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"nookal": {
"url": "https://nookal.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Nookal 凭据。
分步设置说明、凭据查找方法和常见问题:https://usefulapi.io/nookal/
首次连接时,你需要提供 Nookal API v3.0 Basic Key 和区域。 系统会验证你的凭据,并按用户存储和限定使用范围——配置文件中不会包含密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
nookal_list_locations | read | 列出地点 |
nookal_list_staff | read | 列出从业人员和员工 |
nookal_list_services | read | 列出服务(预约类型) |
nookal_list_classes | read | 列出课程类型 |
nookal_get_availability | read | 获取预约可用时间 |
nookal_list_appointments | read | 列出预约 |
nookal_search_clients | read | 搜索客户(患者) |
nookal_get_client | read | 获取客户(患者) |
nookal_list_cases | read | 列出治疗病例 |
nookal_list_invoices | read | 列出发票 |
nookal_list_payments | read | 列出发票付款记录 |
nookal_usage_status | meta | 使用情况(免费层用量计数) |
nookal_request_feature | meta | 申请添加缺失功能 |
nookal_upgrade | meta | 升级到 Pro(无限*) |
nookal_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会更改数据(客户端应先确认);meta 工具用于报告使用情况、管理订阅或发送功能申请。
定价
| 方案 | 价格 | 限额 |
|---|---|---|
| Free | $0 | 每月 50 次工具调用 |
| Pro(每位用户) | $9/mo 或 $90/yr(免费使用 2 个月) | 无限* |
*此服务上的 Pro 设有合理使用限额,每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 nookal_upgrade 订阅(该工具会返回 Stripe Checkout 链接)。你可以随时使用 nookal_cancel_subscription 取消:Pro 会持续到已付费期限结束,当前期限不予退款;在此之前运行 nookal_upgrade 可撤销取消操作。也可以发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 Nookal 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。