resOS MCP by usefulapi

usefulapi の resOS MCP

Claude、Cursor、または任意の MCP クライアントから resOS アカウントを利用できます。予約、ゲスト、フィードバック、空き状況を読み取り、予約の作成、変更、キャンセル、ゲストコメントの投稿もできます。ホスト型のため、ローカルへのインストールは不要です。ご自身の認証情報で接続します。

ライブエンドポイント： https://resos.usefulapi.io/mcp · ホームページ： https://usefulapi.io

接続

• Claude（claude.ai、Desktop）：Customize → Connectorsを開き、+ Add → Add custom connectorをクリックして、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 キー（Settings → API integration。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を参照してください。ドキュメントのみです。サーバーはホストされています。