SOP MCP：自分のAIで予約を扱う
オーナー、コーチ、受付スタッフが、自分のAI（たとえばClaudeやChatGPT）で店舗の予約を確認・処理できます。
このページは、店舗（オーナー、コーチ、受付）、店舗のシステムを連携するSIエンジニア、コネクターを審査する方に向けて書いています。
SOP MCPとは
SOP MCPは、SOPが店舗向けに提供するMCPサーバーです。MCP（Model Context Protocol）は、AIが外部のツールにつながるためのオープンな標準です。接続すると、オーナー、コーチ、受付スタッフは、自分のAIに今日の予約を調べさせたり、店舗の確認待ちの予約を承認・辞退させたり、電話をくれたお客さまの代わりに予約させたりできます。
リモートMCPコネクターに対応したAI（たとえばClaudeやChatGPT）で使うことを想定しています。画面やメニューの名前は、AIやバージョンによって異なります。1回のログインで開けるのは1店舗だけで、AIが見られるのも処理できるのも、その店舗の予約だけです。
このページは店舗側の説明です。お客さまのAIが貴店を見つけ、予約し、支払う流れは、エージェントコマース ドキュメントをご覧ください。
接続のしかた
MCPのアドレスはhttps://sellers.carboneasy.ai/mcpです。トランスポートはStreamable HTTP、店舗のログインにはOAuth（動的クライアント登録とPKCEに対応）を使います。
- お使いのAIで、「カスタムコネクター」を追加する場所を探します。名前や場所はAIごとに異なるため、各AIの案内に従ってください。
- MCPのアドレス
https://sellers.carboneasy.ai/mcpを貼り付け、分かりやすい名前（例：「SOP」）を付けます。 - 初回は、AIがSOPのログインページに案内します。店舗コードとパスコードを入力して、ログインボタンを押します。ページは繁体字中国語で表示され、入力欄は「店家代號」（店舗コード）と「店家通行碼」（店舗パスコード）、ログインボタンは「登入並授權」（ログインして承認）、辞退ボタンは「不授權」（承認しない）です。店舗コードとパスコードは、SOPの確認ページで使うものと同じです。
- AIに戻って、予約の確認や処理を頼みます。例：「今夜の予約を見せて」
ログインページには、接続するアプリケーションの名前と、ログイン後に戻るウェブサイトが表示されます。いま操作したAIであることを確かめてから承認してください。違う場合は辞退ボタンを押します。
AI側でいつでもこのコネクターを削除できます。削除すると、そのAIはSOPを呼び出さなくなります。店舗のパスコードを変更すると、その店舗でログイン済みのAIはすべてすぐに無効になり、接続し直す必要があります。
11のツール
ここに挙げる11のツールが、店舗がログインしたときに使えるすべてです。どのツールも、ログインした店舗にだけ作用し、店舗コードを受け取りません。時刻はすべて台北時間（Asia/Taipei）です。最後の列が「いいえ」のツールは、読み取りだけで予約を変更しません。
| ツール | できること | データを変更する？ |
|---|---|---|
get_store_settings | この店舗の情報とルールを取得します。都市、住所、営業時間、連絡先、よくある質問。公開中のサービスと、その料金、所要時間、週ごとの枠、支払い方法（店頭払いまたはオンライン）。予約のルール（自動で確定する条件と人数の上限、キャンセルの締め切り、確認待ちの予約をいつまで保留するか）。手動確認モードがオンかどうか、いつまでかも分かります。 | いいえ |
get_availability | あるサービスについて、今後1〜14日間の空き枠と残り人数を調べます。講師またはトレーナーを指定することもできます。 | いいえ |
list_bookings | 指定した期間の予約を、早い順に一覧します（開始日から1〜14日間、既定は7日間、最大100件）。状態で絞り込めます。各予約には、状態、サービス、時間枠、人数、お客さまの氏名、マスキング済みの電話番号とメールアドレス、店舗の確認が必要な理由、支払い状態、出欠の記録が含まれます。 | いいえ |
get_booking | 予約1件の詳細を取得します。状態と確認が必要な理由、サービス、時間枠、人数、お客さまの氏名、メモ、支払いと返金の情報、出欠の記録。電話番号とメールアドレスは、ここでもマスキングされます。 | いいえ |
reveal_customer_contact | 予約1件のお客さまの電話番号とメールアドレスを、マスキングなしで取得します。呼び出しのたびに、この店舗の監査ログに記録されます。 | いいえ（監査ログに記録） |
confirm_booking | 店舗の確認待ちの予約を確定します。確定すると時間枠の定員を超える場合や、講師の時間が重なる場合は失敗します。オンライン決済待ちの予約は、まだ確定できません。お客さまにはメッセージを送りません。 | はい |
decline_booking | 待機中の予約（オンライン決済待ちを含む）を辞退し、枠を解放します。元に戻せません。お客さまがすでにオンラインで支払っている場合は、その場で全額返金し、結果に返金が完了したか処理中かが表示されます。お客さまにはメッセージを送りません。 | はい |
cancel_booking_by_store | 確定済みの予約を店舗側からキャンセルし、枠を解放します。元に戻せません。確認待ちの予約にはdecline_bookingを使います。オンラインで支払い済みの場合は全額返金します。お客さまにはメッセージを送りません。 | はい |
mark_attendance | 時間枠が始まったあとに、お客さまが「来店した」か「来なかった」かを記録します。1件の予約につき1回だけ記録できます。 | はい |
book_for_customer | お客さまの代わりに予約します。たとえば、お客さまが電話をかけてきた場合や、受付に来た場合です。予約はその場で確定し、店頭払いになります。お客さまが自分のAIで予約するときにオンライン決済が必要なサービスでも同じです。定員と講師の時間は確認されます。お客さまの氏名、電話番号、任意のメールアドレスは店舗が保管します。idempotency_keyを付けると再試行しても安全で、同じ連絡先・サービス・時間枠での重複予約は拒否されます。 | はい |
set_manual_mode | 手動確認モードのオンとオフを切り替えます。オンの間は、この店舗の新しい予約すべて（お客さま自身のAIからのものを含む）が、店舗の確認待ちになります。指定した日付（台北時間のその日の23:59、最長90日先まで）に自動で終わり、いつでもオフにできます。すでに成立した予約は変わりません。 | はい（今後の新しい予約にのみ影響） |
成功した書き込み操作と、reveal_customer_contactの呼び出しは、そのたびにこの店舗の監査ログに1件記録されます。監査ログに残るのは、どのログインまたは認証情報が、何をしたか、どの予約か、いつかであり、お客さまの氏名、電話番号、メールアドレス、メモは記録しません。
プライバシーとセキュリティ
- お客さまの電話番号とメールアドレスは、既定でマスキングされます。電話番号は末尾3桁だけ、メールアドレスはドメインだけを表示します。
list_bookings、get_booking、book_for_customerの応答には、完全な電話番号やメールアドレスは含まれません。 - 完全な連絡先を見られるのは
reveal_customer_contactだけです。予約1件ずつ、呼び出しのたびに監査ログへ記録され、記録できないときは表示しません。 - 予約から一定の時間が過ぎると、お客さまの連絡先はシステムから削除され、その欄は空になります。
- ツールが返す内容は、お使いのAIサービス（たとえばClaudeやChatGPT）を通ります。そのサービス自身の利用規約とプライバシーの規定が適用されます。お客さまの連絡先を既定でマスキングする理由の一つです。
- 1回のログイン、または1つの認証情報で開けるのは1店舗だけです。ツールは店舗コードを受け取らないため、AIが別の店舗を指定することはできません。
- 確定、辞退、キャンセル、出欠の記録は、AIに任せられる日常の操作です。サーバーがAIに渡す使用説明では、依頼された内容どおりに、指定された予約にだけ作用するよう求めています。それでもAIの動きには目を配ってください。辞退とキャンセルは元に戻せないため、AIに頼む前にどの予約かを確かめてください。
- 正式な設定（サービス、料金、スケジュール、キャンセルのルール）：現在、変更できるツールはなく、
get_store_settingsは読み取り専用です。これらの設定の変更に承認が必要な場合、承認できるのは、SOPの確認ページで操作する貴店だけです（SOPのLINE通知から確認ページへ移動できます）。AIが自分で承認することはできません。 - お客さまの代わりに予約するときは、メモ欄に健康や医療に関する情報を書かないでください。
利用回数の制限
- 代理予約：
book_for_customerで成功した予約は、1店舗あたり（フロントエージェントは1つの認証情報あたり）1時間に最大60件、1店舗あたり1日に最大200件です。超えるとrate_limitedが返ります。1時間後にもう一度お試しください。 - ログイン：同じ店舗に対して同じネットワークアドレスから15分間に10回、または同じネットワークアドレスから店舗を問わず15分間に合計50回入力を間違えると、一時的にログインできなくなります。15分後にもう一度お試しください。
SIとフロント業務システム向け
店舗のシステムを連携するSIや、店舗自身のフロント業務システム（たとえばLINEのAI接客や、店舗のコンピューターで動くAI）は、店舗のログインを使わず、「フロントエージェント用認証情報」で同じMCPアドレスに接続します。フロントエージェントとは、店舗の受付業務を代行するAIのことです。
- 認証情報はSOPが発行します。1つの認証情報は1店舗だけに対応し、フロント業務システムごとに1つで、取り消せます。発行時に1回だけ表示されるため、大切に保管してください。紛失した場合は、ご連絡のうえ、取り消しと再発行をご依頼ください。
- 接続時は、HTTPヘッダー
Authorization: Bearer sopk_…を付けます。認証情報はsopk_で始まります。認証情報が間違っている場合や取り消し済みの場合は、必ず401が返ります。 - フロントエージェントが見られるツールは5つだけです：
get_store_settings、get_availability、list_bookings、get_booking、book_for_customer。 - お客さまの電話番号とメールアドレスは、ここでもマスキングされます。
reveal_customer_contactは使えないため、完全な連絡先は見られません。 - フロントエージェントは、予約の確定、辞退、キャンセル、出欠の記録、手動確認モードの切り替えはできません。これらは、店舗自身がログインしたときだけ使えます。
- お客さまの代わりの予約は、その店舗のルールに従います。すぐに確定する（
confirmed）か、店舗の確認待ち（pending、たとえばお客さまの初回予約、メモ付き、自動確定の人数上限を超える場合、または店舗が自分で確認するサービス）になります。オンライン決済のサービスではawaiting_paymentが返り、お客さま向けの支払いリンクが付きます。
フロントエージェント用認証情報の申請は、お問い合わせフォームから、店舗名と接続したいフロント業務システムをお知らせください。
公式MCP Registry
SOP MCPの公式MCP Registryでの名前はtw.srct.sellers/sopで、現在登録の手続き中です。登録の手続き中も、登録の完了後も、上記のMCPアドレスにそのまま接続できます。
サポート
接続、ログイン、ツールの動作、フロントエージェント用認証情報についてのご質問は、お問い合わせフォームからお寄せください。