resOS MCP by usefulapi

usefulapi 的 resOS MCP

通过 Claude、Cursor 或任何 MCP 客户端使用你的 resOS 账户。它可以读取预订、宾客、反馈和可订情况，也可以创建、修改或取消预订，以及发布宾客评论。托管服务，无需本地安装：使用你自己的凭据连接。

在线端点： https://resos.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、Desktop）：打开 自定义 → 连接器，点击 + 添加 → 添加自定义连接器，然后粘贴 https://resos.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http resos https://resos.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将该 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "resos": {
      "url": "https://resos.usefulapi.io/mcp"
    }
  }
}

仅添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 resOS 凭据。

分步设置说明、凭据查找方式和常见问题：https://usefulapi.io/resos/

首次连接时，你需要提供 resOS API 密钥（设置 → API 集成；API 是付费附加服务）。服务会验证该密钥，并按用户保存。配置文件中无需放置密钥。

工具

工具	类型	功能
resos_list_bookings	read	列出预订
resos_get_booking	read	获取预订
resos_list_customers	read	列出客户
resos_get_customer	read	获取客户
resos_list_guest_feedback	read	列出宾客反馈
resos_get_guest_feedback	read	获取宾客反馈
resos_list_seating_areas	read	列出就餐区域和餐桌
resos_list_opening_hours	read	列出营业时间
resos_get_opening_hour	read	获取营业时间
resos_list_custom_fields	read	列出自定义字段
resos_get_custom_field	read	获取自定义字段
resos_get_available_dates	read	获取可订日期
resos_get_available_times	read	获取可订时间
resos_get_available_tables	read	获取可用餐桌
resos_create_booking	write	创建预订
resos_update_booking	write	更新预订
resos_cancel_booking	write	取消预订
resos_add_booking_note	write	添加内部预订备注
resos_send_booking_comment	write	向宾客发布预订评论
resos_usage_status	meta	使用情况（免费层级用量）
resos_request_feature	meta	请求添加缺失的功能
resos_upgrade	meta	升级到 Pro（无限量*）
resos_cancel_subscription	meta	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应先征求确认）；meta 工具用于报告用量、管理订阅或发送功能请求。

定价

套餐	价格	限额
Free	$0	每月 50 次工具调用
Pro（按用户计费）	$9/mo 或 $90/yr（免费使用 2 个月）	无限量*

*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 resos_upgrade 订阅（它会返回 Stripe Checkout 链接）。你可以随时使用 resos_cancel_subscription 取消：Pro 会持续到已付费周期结束，当前周期不予退款；在此之前运行 resos_upgrade 可撤销取消操作。也可以发送邮件至 [email protected]。

许可证

MIT — 请参阅 LICENSE。仅提供文档；服务由托管方运行。