概要
iikoCloud API (Syrve Cloud API) を通じた iiko と Syrve のレストラン管理:組織と端末グループ、メニューと外部メニュー、ストップリスト、デリバリーとテーブルオーダー、予約、配達員、注文と支払いの種類、割引とロイヤルティ顧客。ウェブバックオフィスからの API ログイン。
ガイド付きセットアップ
iiko を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで iiko を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
iiko のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.com に直接アクセスしてください。 サインインし、Connectors → iiko をクリックして、API ログインを貼り付け、API ホストとロイヤルティパスのために iiko または Syrve を選択し、MCP API キーを生成すれば完了です。Docker は不要、
git cloneも不要、ローカルサーバーも不要です。
iiko + Microsoft Copilot
iikoCloud API (Syrve Cloud API) を通じた iiko と Syrve のレストラン管理:組織と端末グループ、メニューと外部メニュー、ストップリスト、デリバリーとテーブルオーダー、予約、配達員、注文と支払いの種類、割引とロイヤルティ顧客。ウェブバックオフィスからの API ログイン。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択したときにアプリ内ストアで表示されます)。このコネクタに必要な環境変数は次のとおりです:
IIKO_API_HOST, IIKO_LOYALTY_API, IIKO_API_LOGIN
ステップ 1 — 資格情報を取得する
設定には約 5 分かかります。
- 管理者としてウェブバックオフィス (iiko の場合は iikoWeb、Syrve の場合は Syrve Web / Syrve App) にサインインし、クラウド API 設定 (Integrations, API keys; 古いバージョンでは API settings または Live API settings と呼ばれます) を開きます。
- このコネクタ用の API ログイン (API キー) を作成します:名前を付け、アクセスできる組織を選択し、最長 2 年の有効期限を設定します。キーをコピーします;新しいキーは 36 文字の長さで、一度だけ表示される場合があります。
IIKO_API_LOGINに貼り付けます。IIKO_API_HOSTには API ホストとして製品を二回選択し、IIKO_LOYALTY_APIには同じ製品を選択します (iiko と Syrve はロイヤルティパスの名前を異なります)。- オプション:最初の
iiko_list_organizations呼び出しの後に、主要なレストランの ID をIIKO_ORGANIZATION_IDに入れて、1 つの組織を受け取るツールがそれを省略できるようにします。
コネクタは /api/1/access_token で API ログインを交換し、1 時間持続するベアラートークンを取得し、自動的に更新します。iiko はこのログイン呼び出しを非推奨とし、/api/v2/access_token を使用することを推奨しています。これには開発者ポータルに登録されたアプリが必要です;iiko が古い呼び出しを無効にすると、セットアップチェックはログイン失敗を報告します。
どこから始めるか:iiko_list_organizations は他のツールが必要とする組織 ID を提供します。iiko_list_terminal_groups は組織の POS インストールをリストし、iiko_check_terminal_groups_alive はそれらがオンラインかどうかを示します。
メニュー:iiko_list_external_menus と iiko_get_external_menu は、配達チャネル用に準備されたメニューを読み取り、組織ごとの価格を表示します。iiko_get_nomenclature は完全なバックオフィスメニューを読み取ります(大きい;Syrve 用に文書化されていますが、iiko のリファレンスにはもはやありませんので、iiko の外部メニューを優先してください)。iiko_get_stop_lists は端末グループごとの在庫切れアイテムを表示し、iiko_add_to_stop_list と iiko_remove_from_stop_list はそれを変更し、オフにスイッチされてインストールされます(これには追加のストップリスト権限を持つ API ログインが必要です)。
デリバリーオーダー:iiko_list_deliveries_by_date_and_status(日次概要)、iiko_search_deliveries(テキスト検索と問題フィルター)、iiko_list_deliveries_by_phone、iiko_get_deliveries_by_id。これらは過去 7 日間のデータが保証されています;iiko_list_delivery_history_by_phone は 90 日前まで遡ります。ステータス:未確認、調理待ち、調理準備完了、調理開始、調理完了、待機中、配達中、配達済み、クローズ、キャンセル。iiko_create_delivery と iiko_cancel_delivery はオフにスイッチされてインストールされます:作成された注文はキッチンに届き、キャンセルは元に戻せません。
テーブルオーダーと予約:iiko_get_table_orders_by_id と iiko_list_table_orders_by_table はダインインオーダーを読み取ります。予約については、iiko_list_reserve_terminal_groups の後に iiko_list_restaurant_sections(ホールとテーブル)、iiko_list_reserves(指定された時間から予約されたもの)、iiko_get_reserves_by_id(詳細)を使用します。コネクタは予約を作成しません。
辞書:iiko_list_order_types、iiko_list_payment_types、iiko_list_discounts、iiko_list_cancel_causes、iiko_list_couriers。これらはめったに変更されません:会話ごとに一度読み取ります。
ロイヤルティ:iiko_get_customer は電話、メール、カードでゲストを見つけ、ウォレットの残高を表示します;iiko_list_customer_transactions はボーナスの動きをリストします;iiko_list_customer_categories と iiko_list_loyalty_programs はプログラムを説明します。iiko_create_or_update_customer はゲストのマスターデータを保存します。コネクタはウォレットを補充したり、保持したり、書き消したりせず、支払いを記録しません。
コマンド:デリバリーの作成またはキャンセル、ストップリストの変更は、correlationId で一度に応答します;その後 POS がコマンドを実行します。結果は iiko_get_command_status で読み取ります(進行中、成功、エラー)。
フォーマット:ID は UUID です。日付は yyyy-MM-dd HH:mm:ss.fff で、タイムゾーンなし:注文と予約の時間は端末にローカルです(iiko_list_terminal_groups でタイムゾーンを確認してください)、ロイヤルティレポートの日付は UTC です。合計は組織の通貨で表示されます。ほぼすべての呼び出しは JSON ボディを持つ POST です。
制限:iiko はメソッド(辞書、メニュー、ストップリスト、注文読み取りなど)をグループ化し、通常は 1 分ごとに各グループを制限します;制限を超えると、そのグループのすべての呼び出しは 429 で応答します。注文とストップリストメソッドの制限はレストランの数に応じて増加します。1 回の呼び出しで複数の組織を要求し、辞書とメニューをキャッシュし、単一の注文をポーリングしないでください。同じリクエストを大量に繰り返すと、API ログインがブロックされる可能性があります。
エラー:エラー応答には errorDescription としばしば error(コード)が含まれ、iiko サポートに引用するための correlationId も含まれます。401 はトークンまたは API ログインが拒否されたことを意味し、400 は間違ったフィールドを示し、408 は POS が時間内に応答しなかったことを意味します(レストランがオフラインの可能性があります)。
ステップ 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 — Microsoft Copilot にコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き(または新規作成し)、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name(例:
AnythingMCP)、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー(MCP Servers → 対象のサーバー → API keys)を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
iikoのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| ツール | 機能 |
|---|---|
iiko_list_organizations | API ログインがアクセスできる組織(レストラン)をリストします:ID、名前、コード、国、住所、座標、タイムゾーン設定… |
iiko_list_terminal_groups | 1 つ以上の組織の端末グループ(注文が送信される POS インストール)をリストします:組織ごとにグループと ID… |
iiko_check_terminal_groups_alive | 現在端末グループがオンラインかどうかを確認します:端末グループごとに isAlive が true または false です。誰かにレストランを伝える前に使用してください… |
iiko_get_nomenclature | 1 つの組織の完全なメニュー(命名法)をバックオフィスからエクスポートされた形式で読み取ります:グループ、製品カテゴリ、製品(料理… |
iiko_list_external_menus | 外部メニュー(ウェブバックオフィスで配達サイトやアプリ用に準備されたメニュー)とアカウントの価格カテゴリをリストします:ID… |
iiko_get_external_menu | 1 つの外部メニューをそのアイテムカテゴリ、アイテム、サイズ、組織ごとの価格、修正グループ、アレルゲン、栄養価… |
iiko_get_stop_lists | ストップリスト(在庫切れアイテム)を読み取ります:組織と端末グループごとに製品ID、サイズID、SKU、残高(残り… |
iiko_list_order_types | 組織ごとの注文タイプをリストします:ID、名前、orderServiceType(テーブルオーダー用の Common、DeliveryByCourier、DeliveryByClient 用の… |
iiko_list_payment_types | 支払いタイプをリストします:ID、コード、名前、paymentTypeKind(現金、カード、外部、ロイヤルティカードなど)、paymentProcessingType、端末… |
iiko_list_discounts | バックオフィスで設定された割引と追加料金を組織ごとにリストします:ID、名前、パーセントまたは固定金額、モード、最小注文金額… |
iiko_list_cancel_causes | 配達キャンセルの原因をリストします:ID、名前、isDeleted。配達をキャンセルするには ID が必要です。読み取り専用;応答をキャッシュします |
iiko_list_deliveries_by_date_and_status | 配達日とステータスによる配達およびピックアップオーダーをリストします:組織ごとに注文の ID、posId、creationStatus と注文… |
iiko_list_deliveries_by_phone | 電話番号の最近の配達注文を見つけます(過去 7 日間が保証されています):同じ注文の詳細が… |
iiko_list_delivery_history_by_phone | 注文履歴の電話番号の古い配達注文を見つけます(90 日間保持):同じ注文の詳細が、組織ごとにグループ化され、最大… |
iiko_search_deliveries | テキストによる配達注文を検索します(注文番号、顧客名、電話番号または住所のプレフィックス検索)で、日付、ステータス、サービスタイプのフィルター… |
iiko_get_deliveries_by_id | ID による最大 200 件の配達注文を読み取ります:creationStatus(成功、進行中、エラーとエラー情報)とステータス、顧客… |
iiko_get_table_orders_by_id | ID によるテーブル(ダインイン)オーダーを読み取ります:creationStatus とテーブルID、ステータス(新規、請求書、クローズ、削除)、ウェイター、顧客… |
iiko_list_table_orders_by_table | 指定されたテーブルのテーブル(ダインイン)オーダーをリストします。オプションでステータスと作成日で:iiko_get_table_orders_by_id と同じ詳細が… |
iiko_list_reserve_terminal_groups | テーブル予約と宴会を受け入れる指定された組織の端末グループをリストします:ID、名前、住所、タイムゾーン、… |
iiko_list_restaurant_sections | 予約を受け入れる端末グループのレストランセクション(ホール)をリストし、テーブルを表示します:セクション ID と名前、テーブルごとの ID… |
iiko_list_reserves | 指定された開始時間からレストランセクションで予約された予約と宴会をリストします:ID、テーブルID、推定開始時間、所要時間(分)… |
iiko_get_reserves_by_id | ID による予約と宴会を読み取ります:creationStatus、isDeleted と顧客、電話、ゲスト数、テーブル、推定開始… |
iiko_list_couriers | 配達員としての従業員を組織ごとにリストします:ID、名、姓、表示名、コード、isDeleted。読み取り専用 |
iiko_get_customer | 電話、メール、カード番号、カードトラックまたは ID によるロイヤルティ顧客(ゲスト)を検索します:ID、名前、姓、電話、メール、誕生日、性別… |
iiko_list_customer_categories | 組織のロイヤルティプログラムの顧客(ゲスト)カテゴリをリストします:ID、名前、isActive、isDefaultForNewGuests。読み取り専用 |
iiko_list_loyalty_programs | 組織のロイヤルティプログラムをリストします:ID、名前、説明、プログラムタイプ、isActive、有効期限、walletId、マーケティング… |
iiko_list_customer_transactions | 1 人の顧客のロイヤルティトランザクションを期間内にリストします(ボーナスの付与と書き消し、ウォレットの補充、クーポン):タイプ、タイプ名、合計… |
iiko_create_or_update_customer | ロイヤルティ顧客を作成するか、ID、電話、カードで見つけた顧客を更新します:名前、電話、メール、誕生日、性別、コメント、同意状況… |
iiko_get_command_status | コマンドの結果を確認します(デリバリーの作成またはキャンセル、ストップリストの変更):状態は進行中、成功、エラー… |
iiko_create_delivery | POS でデリバリーまたはピックアップオーダーを作成します。これはコマンドです:応答には correlationId と creationStatus を持つ orderInfo が含まれます… |
iiko_cancel_delivery | 配達注文をキャンセルします。キャンセル理由が必要です。元に戻せず、すでに印刷されたアイテムは書き消されます。これはコマンドです:結果を確認します… |
iiko_add_to_stop_list | 1 つの端末グループのストップリストに製品を追加し、残りの数量を指定します(売り切れの場合は 0)。ゲストは売り切れのアイテムを注文できなくなります… |
iiko_remove_from_stop_list | 1 つの端末グループのストップリストから製品を取り除き、再度注文できるようにします。ストップリストを変更するための追加の権限を持つ API ログインが必要です… |
例のプロンプト
- "今日の配達注文で、まだ配達中でないものはどのレストランですか?"
- "現在、各端末グループのストップリストには何がありますか?"
- "すべての POS 端末グループはオンラインですか?"
- "今夜の 18:00 からのメインレストランの予約を、ホールとテーブルとともに表示してください。"
- "電話番号 79161234567 のゲストを見つけ、ボーナス残高と最近の取引を表示してください。"
よくある質問
API ログインはどこから来ますか? 管理者がウェブバックオフィス (iiko の場合は iikoWeb、Syrve の場合は Syrve Web) にサインインし、Integrations、API keys (古いバージョンでは API settings) を開きます。コネクタ用の API ログインを作成し、アクセスできる組織を選択し、最長 2 年の有効期限を設定し、キーをコピーします。その後、API ホストとロイヤルティパスのために製品を選択します:iiko は api-ru.iiko.services を使用し、Syrve は api-eu.syrve.live を使用し、キーはそれぞれの製品のホストでのみ機能します。
何をカバーしていますか? 組織と端末グループのオンラインステータス、価格付きの外部メニューとバックオフィスメニュー、ストップリスト、日付、ステータス、電話またはテキスト検索による配達注文、テーブルオーダー、ホールとテーブルを含む予約、配達員、注文と支払いの種類、割引とキャンセル理由、ロイヤルティ顧客のウォレット残高とボーナストランザクションを含みます。ゲストのマスターデータを保存しますが、ウォレットを補充したり、保持したり、書き消したりせず、支払いを記録せず、予約を作成しません。
どのツールがオフにスイッチされてインストールされますか? iiko_create_delivery、iiko_cancel_delivery、iiko_add_to_stop_list、iiko_remove_from_stop_list。作成された注文はキッチンに直接届き、キャンセルは元に戻せず、ストップリストツールには追加のストップリスト権限を持つ API ログインが必要です。AI がそれらを使用する必要がある場合のみ、コネクタページでオンにしてください。
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント(ライセンスまたは試用版)が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?