Smoobu MCP by usefulapi

usefulapi による Smoobu MCP

Claude、Cursor、または任意の MCP クライアントから Smoobu を利用できます。物件、予約、料金、空室状況、ゲストへのメッセージ、ゲストを確認し、予約を作成または更新できます。 ホスト型のため、ローカルへのインストールは不要です。ご自身の Smoobu 認証情報を使って接続します。

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

接続

• Claude（claude.ai、Desktop）：Customize → Connectorsを開き、+ Add → Add custom connectorをクリックして、https://smoobu.usefulapi.io/mcpを貼り付けます。
• Claude Code： claude mcp add --transport http smoobu https://smoobu.usefulapi.io/mcpを実行し、続いて/mcpを実行してログインします。
• VS Code： VS Code に追加。
• Cursor およびその他のクライアント： URL をリモート MCP サーバーとして追加します。

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

URL だけを追加してください。クライアント設定にAuthorizationヘッダーや API キーを追加しないでください。サーバーが OAuth でログインを行い、ログインページで Smoobu の認証情報を求めます。

セットアップ手順、認証情報の確認方法、よくある質問：https://usefulapi.io/smoobu/

初回の接続時に、Smoobu API key と API secret（Settings → Advanced → API Keys）を入力します。 これらは検証され、ユーザーごとに保存され、そのユーザー専用に制限されます。設定ファイルにキーを保存する必要はありません。

ツール

ツール	種類	機能
smoobu_get_user	read	現在のユーザーを取得します
smoobu_list_apartments	read	物件の一覧を取得します
smoobu_get_apartment	read	1 件の物件を取得します
smoobu_list_reservations	read	予約の一覧を取得します
smoobu_get_reservation	read	1 件の予約を取得します
smoobu_list_price_elements	read	予約の料金項目の一覧を取得します
smoobu_get_reservation_placeholders	read	予約のメッセージ用プレースホルダーを取得します
smoobu_get_rates	read	料金と空室状況を取得します
smoobu_check_availability	read	空室状況を確認し、宿泊料金を見積もります
smoobu_list_message_threads	read	受信トレイのスレッド一覧を取得します
smoobu_list_reservation_messages	read	予約のメッセージ一覧を取得します
smoobu_list_guests	read	ゲストの一覧を取得します
smoobu_get_guest	read	1 人のゲストを取得します
smoobu_list_addons	read	アドオンの一覧を取得します
smoobu_list_custom_placeholders	read	カスタムプレースホルダーの一覧を取得します
smoobu_create_reservation	write	予約を作成します
smoobu_update_reservation	write	予約を更新します
smoobu_set_rates	write	料金と最低宿泊日数を設定します
smoobu_send_message_to_guest	write	ゲストにメッセージを送信します
smoobu_send_message_to_host	write	ホストにメッセージを投稿します
smoobu_usage_status	meta	利用状況（無料プランの使用量）を確認します
smoobu_request_feature	meta	未対応の機能をリクエストします
smoobu_upgrade	meta	Pro にアップグレードします（無制限*）
smoobu_cancel_subscription	meta	Pro サブスクリプションを解約します

readツールは読み取り専用です。writeツールはデータを変更します（クライアントは実行前に確認する必要があります）。metaツールは利用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。

料金

プラン	料金	上限
Free	$0	月 50 回のツール呼び出し
Pro（ユーザーごと）	$9/mo または $90/yr（2 か月分無料）	無制限*

*このサーバーでの Pro の公正使用上限は、月 10,000 回のツール呼び出しです。さらに必要な場合は、[email protected] までご連絡ください。

Pro はこのサーバーのみが対象です。smoobu_upgradeを使って登録してください（Stripe Checkout のリンクが返されます）。smoobu_cancel_subscriptionを使えばいつでも解約できます。Pro は有料期間の終了まで引き続き利用できます。現在の期間分の返金はなく、期間終了前にsmoobu_upgradeを実行すると解約が取り消されます。または、[email protected] までご連絡ください。

ライセンス

MIT © usefulapi。Smoobu とは提携しておらず、推奨も受けていません。