概要
Kaufland Marketplace（旧real.de）の販売者API: 注文とそのユニット、ストアフロント、ユニット、チケット、倉庫に対応。HMAC署名付きリクエスト: 署名にはメソッド、URL、本文、タイムスタンプが含まれます。
ガイド付きセットアップ
Kaufland Marketplace を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Kaufland Marketplace を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Kaufland Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Kaufland Marketplace をクリック、認証情報を貼り付け、MCP API キーを発行 — 完了です。Docker も
git cloneもローカルサーバーも不要。
Kaufland Marketplace + Microsoft Copilot
Kaufland Marketplace（旧real.de）の販売者API: 注文とそのユニット、ストアフロント、ユニット、チケット、倉庫に対応。HMAC署名付きリクエスト: 署名にはメソッド、URL、本文、タイムスタンプが含まれます。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
KAUFLAND_CLIENT_KEY, KAUFLAND_SECRET_KEY
ステップ 1 — 認証情報を取得
Getting credentials
- You must already be a Kaufland Marketplace seller. In the Seller Portal open Settings → API keys and create a key pair.
- You receive a Client Key (public, identifies you) and a Secret Key (never sent — it signs the request). Set
KAUFLAND_CLIENT_KEYandKAUFLAND_SECRET_KEY.
The secret never travels. Kaufland does not accept a bearer token: every request carries Shop-Client-Key, Shop-Timestamp and Shop-Signature, where the signature is an HMAC-SHA256 over the canonical string
<METHOD>\n<FULL URL INCLUDING QUERY>\n<BODY>\n<UNIX TIMESTAMP>
…(continued in the in-app connector instructions)
チケット、返品、追跡番号: チケット一覧に加えて、1 件のチケットをやり取りごと読み取り、すべてのチケットの最新メッセージを確認できます。返品と返品された商品を 1 点ずつステータスと理由付きで一覧表示でき、たとえば到着して判断待ちの商品を確認できます。書き込みを行うツールは 2 つで、どちらもインストール時はオンです。kaufland_add_ticket_message はチケット内で購入者に返信を送り、kaufland_add_tracking_to_order_unit は発送済みとしてマークされた注文ユニットに配送業者コードと追跡番号を追加して、購入者が荷物を追跡できるようにします。AI はどちらの呼び出しの前にも、送信内容をそのまま示してあなたの承認を待ちます。読み取り専用にしたい場合は、コネクタページでこの 2 つをオフにしてください。
すでにインストール済みですか？ 以前にインストールしたコネクタにも、カタログ更新で新しいツールが届きます。AnythingMCP でコネクタを開き、Catalog update available の下で新しいツールの一覧を確認して Apply update をクリックしてください。認証情報や自分で追加したツールはそのまま残ります。
ステップ 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 ウィンドウで試します。
Kaufland Marketplaceのツールが必要になる依頼をしてみましょう。 - 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 は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
kaufland_list_warehouses | List the seller's warehouses with their id, name and address |
kaufland_list_orders | List orders in a time window: id, storefront, creation time and number of units |
kaufland_get_order | Read one order in full: the buyer, the billing and shipping address and every order unit with its own price, status and delivery window |
kaufland_list_order_units | List individual order units — the level Kaufland actually fulfils, cancels and pays out at |
kaufland_list_units | List the seller's units (offers) with their EAN, condition, price, stock and the storefront each is listed on |
kaufland_list_tickets | List customer service tickets with their subject, status and the order they relate to — where a buyer complaint shows up before it becomes a |
kaufland_list_storefronts | List the storefronts (one per country) Kaufland runs, with the currency and locale of each |
kaufland_get_ticket_details | Read one customer service ticket: status, open reason (product_not_as_described, product_defect, product_not_delivered, product_return… |
kaufland_list_ticket_messages | List the latest ticket messages across all tickets: ticket id, author role (seller, buyer, system, customer_service) and name, text and time |
kaufland_search_returns | List returns (Retouren): return id, storefront, status (return_requested, label_generated, package_sent, package_received, label_deleted)… |
kaufland_get_return_details | Read one return: status, carrier and tracking code, and its return units with the order unit each belongs to, unit status… |
kaufland_list_return_units | List return units, the returned items one by one: return unit id, return id, order unit id, status, reason and note |
kaufland_add_ticket_message | Answer a customer service ticket: the text is sent to the buyer (and Kaufland customer service) in the ticket conversation |
kaufland_add_tracking_to_order_unit | Add a shipment (carrier code and tracking number) to an order unit that is already marked as sent, so the buyer can follow the parcel.… |
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" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?