MCP 経由で Shoper を Microsoft Copilot に接続する方法

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

Shoper + Microsoft Copilot

Shoper オンラインショップ（ポーランド）：明細行と配送パッケージ付きの注文、商品とバリエーションごとの在庫、カテゴリ、登録顧客、注文ステータス、配送方法と支払方法。在庫数を設定できます。顧客にメールが届くことがある注文ステータスの変更は、インストール時にオフです。

前提条件

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

SHOPER_SHOP_HOST, SHOPER_API_LOGIN, SHOPER_API_PASSWORD

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

設定は約 5 分です。ショップの Shoper 管理パネルへの管理者アクセスが必要です。

1. Shoper 管理パネルで Ustawienia、Ogólne、Administratorzy sklepu（設定、一般、ショップ管理者）を開きます。WIĘCEJ、Dodaj grupę administratorów をクリックし、名前（例：AI）を付け、アクセス種別 dostęp do webapi を選んで保存します。
2. グループを開き、Uprawnienia（権限）タブで、注文、商品、顧客、および AI に見せたい設定の閲覧を許可します。商品の編集は AI に在庫を設定させる場合だけ、注文の編集はステータス変更をオンにする場合だけ許可します。保存します。
3. Administratorzy タブで DODAJ ADMINISTRATORA をクリックし、ログインとパスワードを作成して SHOPER_API_LOGIN と SHOPER_API_PASSWORD に入力します。登録済みの Shoper アプリは、代わりに client_id と client_secret を使えます。
4. SHOPER_SHOP_HOST には https:// とパスを除いたショップのアドレスを設定します（例 myshop.shoparena.pl または独自ドメイン sklep.example.pl）。
5. コネクタをインストールし、shoper_list_orders を実行します。注文が一覧表示され、ログインが確認できます。

コネクタは /webapi/rest/auth に HTTP Basic でサインインし、30 日間有効なトークンを受け取って自動で更新します。

読み取れるデータ: 日付、ステータス、顧客、請求先と配送先住所、合計、支払済み金額と支払済みフラグ、配送方法と支払方法、送料、メモ、流入元、タグ、パッケージ数を含む注文；受取拠点と追加フィールドを含む 1 件の注文の全情報；商品、バリエーション（stock id）、名前、コード、オプション、数量、単位、価格、割引、税、重量を含む注文明細；追跡番号、発送済みフラグと発送日、代金引換、保険を含むパッケージ；翻訳、カテゴリ、メーカー、在庫、オプション、属性、関連商品、寸法、税を含む商品；販売可能なバリエーションである商品在庫（数量、倉庫ごとの数量、価格、特価、卸価格、仕入価格、在庫状況）；カテゴリとカテゴリツリー全体；ログイン、メール、名前、顧客グループ、割引、ニュースレター同意、登録日、最終訪問、ポイントを含む登録顧客；注文ステータス（email_change 付き）、配送方法、支払方法です。

注文の探し方: AI は filters と order（例：日付フィルターと新しい順の -date）で注文を一覧し、shoper_get_order で 1 件を読み、続いて shoper_list_order_products で明細を、shoper_list_parcels で追跡番号を、どちらも order_id フィルターで取得します。ステータス、支払方法、配送方法の名前は shoper_list_statuses、shoper_list_payments、shoper_list_shippings から得ます。ゲスト注文には user_id がないため、AI は注文のメールアドレスを使います。

フィルター: filters は AND で結合されるフィールド条件のオブジェクトです。値だけを書くと等しいという意味です。演算子は =、!=、>、>=、<、<=、LIKE（% を使用）、NOT LIKE、IN、NOT IN（リストを使用）です。入れ子のフィールドはドットで指定します（例 translations.pl_PL.name）。

書き込める内容: shoper_update_product_stock はインストール時にオンです。1 つのバリエーションの数量（ショップが倉庫機能を使う場合は倉庫ごとの数量）を上書きし、顧客が注文できる数をすぐに変えるため、AI は先に stock id、現在の数量、新しい数量をあなたに確認します。

インストール時はオフ: shoper_update_order_status です。email_change が 1 のステータスは、注文がそのステータスになるとすぐ顧客にメールを送るため、管理者が意図的にこのツールをオンにします。オンにした後も、AI は注文、現在のステータス、新しいステータスを示してあなたの同意を待ちます。

形式: 一覧は count、pages、page、list で応答します。日付はショップのタイムゾーンの YYYY-MM-DD HH:MM:SS、金額はショップ通貨の文字列です。テキストは translations の下に言語ごと（例 pl_PL、en_GB）にあります。

制限: 1 ページ最大 50 件で、AI は page が pages と等しくなるまで次の page で呼び出します。Shoper のリーキーバケットでは、約 10 回のバーストの後は毎秒 2 回までです。

よくあるエラー: 401 はログインまたはパスワードの誤り、または webapi アクセスのないグループを意味します。403（insufficient_scope または access_denied）は管理者グループにその領域の権限がないことを意味します。Uprawnienia で権限を追加してください。すべての呼び出しで 404 になる場合は、たいてい SHOPER_SHOP_HOST が間違っています。429 はレート制限に達したことを意味します。Retry-After を待ってください。

このコネクタは注文、商品、価格、顧客の作成や変更、パッケージや配送ラベルの作成は行わず、何も削除しません。

ステップ 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 はこれに対応しています。

1. Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
2. Server name（例: AnythingMCP）、コネクタでできることを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。
3. 認証で API key を選び、Type を Header、ヘッダー名を X-API-Key にして Create を選びます。
4. Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
5. エージェントの Test ウィンドウで試します。Shoper のツールが必要になる依頼をしてみましょう。
6. 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 は使えません。

利用可能なツール

プロンプトの例

• 「月曜日以降に入った注文と、そのうちまだ支払われていないものを教えてください。」
• 「注文 1234 の明細と追跡番号を表示してください。」
• 「在庫が 5 個以下の商品バリエーションはどれですか？」
• 「[email protected] の今年の注文を探して、何を購入したか教えてください。」
• 「バリエーション SKU-1-RED の在庫を 20 に設定してください。先に現在の数量を見せてください。」

FAQ

どの 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" と入力すると新しいバージョンになります。

次のステップ

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