MCP 経由で apaleo を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → apaleo をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

apaleo + Cursor

クラウド PMS の apaleo でのホテル運営：施設、客室と客室タイプ、料金プランと料金、空室とオファー、予約、宿泊予約とゲスト、グループ、フォリオ、支払い、請求書、メンテナンス、ハウスキーピング、パフォーマンスレポート。予約の作成、客室の割り当て、チェックインとチェックアウトができます。OAuth2 クライアントクレデンシャルでアプリとして接続し、キャンセルとノーショーはインストール時にオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

APALEO_CLIENT_ID, APALEO_CLIENT_SECRET

ステップ 1 — 認証情報を取得

セットアップは約 5 分です。Apps にアクセスできる apaleo アカウントが必要です。ブラウザでのサインインはなく、コネクタは OAuth2 のクライアントクレデンシャルグラントでアプリとして認証します。

1. apaleo で Apps > Connected apps > Add a custom app を開きます（または apaleo.dev でクライアントクレデンシャルの OAuth simple client を登録します）。
2. チームに必要な権限をアプリに付与します。読み取りには、たとえば properties.read、unitgroups.read、units.read、rateplans.read、rates.read、services.read、companies.read、availability.read、offers.read、reservations.read、groups.read、blocks.read、folios.read、payments.read、invoices.read、maintenances.read、reports.read。書き込みには reservations.create、reservations.manage、reservations.assign-unit、maintenances.create、operations.change-room-state です。読み取り専用にするなら書き込み権限は付けないでください。
3. クライアント ID を APALEO_CLIENT_ID に、クライアントシークレットを APALEO_CLIENT_SECRET にコピーします。シークレットは一度しか表示されません。なくした場合はアプリで新しく作成します。
4. コネクタをインストールし、apaleo_list_properties を実行して接続を確認します。

コネクタは https://identity.apaleo.com/connect/token からトークンを取得し、1 時間ごとに更新します。すべての呼び出しはカスタムアプリとしてその権限で実行され、アプリにない権限は 403 になります。

読み取れるデータ:

• 在庫と料金：施設（ホテル）、ユニットグループ（客室タイプ）、清掃状態とメンテナンスつきのユニット（客室）、料金プラン、制限つきの 1 泊ごとの料金（apaleo_list_rates）、サービス（朝食や駐車場などの追加サービス）、キャンセルポリシー、法人（法人アカウント）。
• 空室とオファー：客室タイプ・泊ごとの残室数（apaleo_get_unit_group_availability）、滞在期間中ずっと空いている客室（apaleo_get_unit_availability）、宿泊予約に割り当て可能な客室、そして 1 回の滞在で予約できる料金プランと料金を返す apaleo_get_offers。
• 予約と宿泊予約：apaleo_list_reservations は text_search（名前、メール、宿泊予約 ID）と、from・to と組み合わせた date_filter の Arrival、Departure、Stay で絞り込めます。apaleo_count_reservations は読み込まずに件数だけを数えます。ほかに予約、宿泊予約のサービス、グループ、ブロック。ゲストは宿泊予約（primaryGuest、additionalGuests）と予約（booker）の一部です。
• 会計：フォリオ（ゲストの勘定。reservation_ids で探せます）、フォリオの支払い、請求書。
• 運用とレポート：メンテナンス期間、施設のパフォーマンス（稼働率、ADR、RevPAR）、勘定科目別の売上（税抜、税込、付加価値税。最長 1 年）、月内の日ごとの到着数。

書き込める操作:

• 予約：apaleo_get_offers から取った ratePlanId と 1 泊ごとの timeSlice で apaleo_create_booking を実行します。apaleo_update_booking と apaleo_update_reservation は [{"op": "replace", "path": "/comment", "value": "Late arrival"}] のような JSON Patch 操作を受け付けます。apaleo_amend_reservation は到着日、出発日、人数、料金プラン、1 泊の料金を変更します。
• フロント業務：apaleo_assign_unit（apaleo が空室を選びます）または apaleo_assign_specific_unit、apaleo_unassign_units、apaleo_check_in_reservation（apaleo_revert_check_in で取り消し）、apaleo_check_out_reservation。チェックアウトはフォリオの未計上の料金をすべて計上し、出発日が明日以前の場合にだけ行えます。
• ハウスキーピングとメンテナンス：apaleo_set_unit_conditions（Clean、CleanToBeInspected、Dirty）と apaleo_create_maintenance（OutOfService、OutOfOrder、OutOfInventory）。

予約、チェックイン、チェックアウトは稼働中のホテルに反映されるため、AI は変更内容を示してあなたの確認を待ちます。

インストール時はオフ: apaleo_cancel_reservation（料金プランのポリシーに基づくキャンセル料がかかり、キャンセルした宿泊予約は元に戻せません）と apaleo_set_reservation_no_show（ノーショー料金をフォリオに計上し、取り消せません）です。チームに必要になったら管理者がオンにします。

データ形式: ID は読みやすいコードです。施設 MUC、ユニットグループ MUC-DBL、ユニット MUC-101、料金プラン MUC-FLEX-DBL、予約 ABCDEF、その宿泊予約 ABCDEF-1 と ABCDEF-2、フォリオ ABCDEF-1-1。金額は基本単位の {"amount": 120.0, "currency": "EUR"} で、宿泊予約の balance はゲストに未払いがあるとマイナスになります。日付は YYYY-MM-DD、時刻は施設の UTC オフセットつきの ISO 8601 です。1 泊はその泊が始まる営業日に属し、to は空室とパフォーマンスでは含まれ、売上レポートでは含まれません。宿泊予約のステータスは Confirmed、InHouse、CheckedOut、Canceled、NoShow です。複数の値を取るフィルターはスペースなしのカンマ区切り（status: Confirmed,InHouse）で、expand は埋め込みオブジェクトを追加します（expand: booker,assignedUnits）。

ページング: 一覧は page_number（1 から）と page_size（最大 500）を取り、合計件数を count で返します。最後を越えたページは 204 No Content を返し、それ以上はないという意味です。

よくあるエラー: 401 はクライアント ID またはシークレットの誤り、あるいはトークンの期限切れです。403 はカスタムアプリの権限不足です。404 は存在しない ID です。422 は業務ルールによるもので、到着日前のチェックイン、客室未割り当て、売り切れのオファーなどがあり、理由は messages にあります。429 はレート制限です。

このコネクタは、料金や支払いの計上、請求書の作成、料金プラン・料金・在庫の変更、apaleo のユーザーやアプリの管理は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが apaleo のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「今日 MUC に到着する宿泊予約はどれで、そのうちまだ客室が割り当てられていないのはどれですか？」
• 「来週の金曜と土曜にダブルルームはあと何室空いていますか？フレキシブル料金だと 2 泊でいくらですか？」
• 「先月の稼働率、ADR、RevPAR を前月と比べて見せてください。」
• 「宿泊予約 ABCDEF-1 に清掃済みの客室を割り当てて、ゲストをチェックインしてください。」
• 「MUC-101 から MUC-105 を清掃済みにし、MUC-210 はシャワー故障のため月曜まで使用不可にしてください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Gemini に接続
• Meta Muse に接続
• Microsoft Copilot に接続