インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、eMAG Marketplace をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
eMAG ルーマニア、ブルガリア、ハンガリー（および Fashion Days）の出品者向け eMAG Marketplace API：商品と出品、価格と在庫、受付と状態変更を含む注文、AWB 配送ラベル、返品（RMA）、カテゴリーと特性、キャンペーン、請求書。呼び出し元 IP を eMAG にホワイトリスト登録してもらう必要があります。
こう聞いてみよう
eMAG Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → eMAG Marketplace をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
eMAG Marketplace + Microsoft Copilot
eMAG ルーマニア、ブルガリア、ハンガリー（および Fashion Days）の出品者向け eMAG Marketplace API：商品と出品、価格と在庫、受付と状態変更を含む注文、AWB 配送ラベル、返品（RMA）、カテゴリーと特性、キャンペーン、請求書。呼び出し元 IP を eMAG にホワイトリスト登録してもらう必要があります。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
EMAG_API_HOST, EMAG_USERNAME, EMAG_PASSWORD
ステップ 1 — 認証情報を取得
設定は約 10 分、加えて eMAG が IP アドレスを登録するまでの時間がかかります。
- eMAG Marketplace の出品者エリアで、API 権限を持つユーザーを使います（なければアカウント所有者に作成してもらいます）。
- IP ホワイトリスト: eMAG は登録済みの IP アドレスからの API 呼び出ししか受け付けません。このコネクタが呼び出す公開 IP アドレスを eMAG Marketplace サポートに送ってください。セルフホストならサーバーのアドレス、AnythingMCP Cloud なら、Cloud がすべての呼び出しに使う固定の IPv4 アドレス
104.248.242.235です。eMAG が登録するまで、すべての呼び出しはYou are not allowed to use this API.を返します。 EMAG_API_HOSTにプラットフォームのホストをパスなしで設定します：https://marketplace-api.emag.ro（ルーマニア）、https://marketplace-api.emag.bg（ブルガリア）、https://marketplace-api.emag.hu（ハンガリー）、https://marketplace-ro-api.fashiondays.comまたはhttps://marketplace-bg-api.fashiondays.com（Fashion Days）。プラットフォームごとに別アカウントなので、国ごとに 1 つのコネクタをインストールします。- API ユーザーを
EMAG_USERNAMEに、そのパスワードをEMAG_PASSWORDに入力します（HTTP Basic 認証）。 - コネクタをインストールし、
emag_marketplace_list_vat_ratesを実行します。認証情報と IP を確認する軽い呼び出しです。
API の仕組み: コネクタは eMAG Marketplace API 3（ドキュメント v4.5.2）を使います。各リソースは POST <resource>/read、count、save として呼び出します。読み取りはフィルターとページングを最上位のフィールド（currentPage、itemsPerPage は最大 100）で受け取り、保存はオブジェクトのリストを受け取ってコネクタが data に包みます。読み取りは POST でも読み取り専用として扱われます。応答はすべて {"isError": false, "messages": [], "results": [...]} の形で、isError: true はメッセージ付きの失敗として報告されます。例外が 1 つあり、ドキュメントに問題のある新商品を保存すると isError: true が返っても出品は保存されているため、AI は emag_marketplace_list_product_offers で読み直します。
読み取れるデータ: 価格、倉庫ごとの在庫、ハンドリングタイム、ステータス、ドキュメントと出品の検証ステータス、doc_errors、カートボタン順位、キャンペーンを含む商品と出品（ID、品番、PNK、ステータスで絞り込み、同じ条件で件数も取得）；EAN で eMAG に既存商品があるか（一度に最大 100 件）。既存商品に出品を紐づけるために使います；特性、許容値、必須フラグを含むカテゴリー；VAT 税率とハンドリングタイム；顧客、配送先住所、商品、バウチャー、支払方法、送料、添付を含む注文；荷物の寸法情報；配送業者、ステータス履歴、重量、代金引換額を含む AWB（PDF の A4、A5、A6 または ZPL）；理由、集荷先住所、AWB を含む返品依頼；地域、配送業者アカウント、集荷先と返送先の住所、定義済みの荷物；ルールと締め切りを含むキャンペーン、最大キャンペーン価格付きの参加可能な出品、キャンペーンバッジ、Smart Deals 価格；eMAG からあなたへの請求書と、注文に対する請求書。
注文と配送: 注文ステータスは 1 新規、2 処理中、3 準備済み、4 完了、0 キャンセル、5 返品。流れは、新規注文、emag_marketplace_acknowledge_order（2 へ）、emag_marketplace_save_order でステータス 3、emag_marketplace_create_awb で AWB、その後ステータス 4 です。emag_marketplace_save_order には読み取った注文全体を渡し、変更する項目だけを変えます。注文を編集できるのはステータス 2 か 3 のときだけです。バウチャーは注文データの一部です（vouchers、product_voucher_split）。AWB では、AI が配送業者アカウント、差出人住所、地域 ID を選び、その後ラベルを読み直します。
返品（RMA）: request_status は 2 新規、3 受付済み、6 受領、7 完了、4 拒否、5 キャンセル。emag_marketplace_save_return は返品を次の状態へ進めます：2 から 3 か 5、3 から 6 か 5、6 から 4 か 7。
書き込める内容: 出品の価格、在庫、ハンドリングタイム、ステータス（emag_marketplace_update_offers、emag_marketplace_update_offer_stock）、出品付きの新商品（emag_marketplace_save_product_offers）、寸法、注文の受付とステータス、注文の添付（請求書はタイプ 1、保証書はタイプ 3）、配送業者のロック解除、AWB、返品ステータス、キャンペーン提案。いずれも稼働中のストアと実際の配送業者に作用します。書き込みの前に、AI は変更内容（出品 ID と変更前後の価格や在庫、注文と新しいステータス、AWB のデータ）を示してあなたの同意を待ちます。インストール時にオフのツールはありません。チームが使わない書き込みツールは管理者がオフにできます。
データの読み方: 出品の id はあなた自身の出品者商品 ID（ext_id）、part_number_key（PNK）は eMAG の商品キーです。出品が販売中になるのは、在庫が 0 より多く、status 1、offer_validation_status 1、validation_status が 3、9、11、12 のいずれかの場合だけです。価格はプラットフォーム通貨での税抜です（ルーマニアは RON、ブルガリアは 2026 年 1 月 1 日から EUR、ハンガリーは HUF）。日付はプラットフォーム現地時間の YYYY-mm-dd HH:ii:ss です。
ページングと制限: 一覧は 1 ページ最大 100 件です。AI はまず件数を数え、currentPage でページを進めます。キャンペーン参加可能な出品はカーソル方式で、最後の ext_id を lastId に渡します。件数取得での注文日付フィルターは両端が必要で、間隔は最大 1 か月です。保存呼び出しは最大 50 件（推奨 10〜50 件）、1 リクエストあたり入力フィールド 4000 個までです。eMAG の上限は注文が毎秒 12 リクエスト、その他のリソースは合計で毎秒 3 リクエストで、超えると 429 を返します。
よくあるエラー: You are not allowed to use this API. または 403 は、IP がまだホワイトリストにないことを意味します。401 はユーザー名かパスワードの誤り、API 権限のないユーザー、またはアカウントとは別のプラットフォームのホストです。429 はレート制限です。少し待ってください。その他の isError 応答には、特性の不足や無効な価格などの eMAG のメッセージが含まれます。
このコネクタは出品者アカウントの開設や eMAG への IP 登録は行わず、プラットフォームをまたいだ操作もしません。1 つのコネクタが 1 つの国を担当します。
ステップ 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 ウィンドウで試します。
eMAG 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 |
|---|---|
emag_marketplace_list_vat_rates | List the VAT rates of the platform with their vat_id, which every offer you save must carry |
emag_marketplace_list_handling_times | List the handling time values (days until you hand an order to the courier) the platform accepts for the handling_time of an offer |
emag_marketplace_list_categories | Read eMAG categories |
emag_marketplace_count_categories | Count the eMAG categories you may read, to know how many pages emag_marketplace_list_categories has |
emag_marketplace_list_product_offers | Read your products and offers: price, stock per warehouse, handling time, status (1 active, 0 inactive, 2 end of life), documentation and… |
emag_marketplace_count_product_offers | Count your products and offers with the same filters as emag_marketplace_list_product_offers, e.g. how many are inactive or have an invalid… |
emag_marketplace_find_products_by_ean | Check whether products already exist on eMAG by EAN (up to 100 at once): part_number_key, name, brand, category, whether you may add an… |
emag_marketplace_list_orders | Read orders with customer, delivery address, products (price, quantity, status, campaign), vouchers, payment method, shipping tax and… |
emag_marketplace_count_orders | Count orders with the same filters as emag_marketplace_list_orders, e.g. how many new (status 1) orders wait |
emag_marketplace_list_order_attachments | Read the attachments of an order (invoices, warranties, manuals, AWBs) with their type and URL |
emag_marketplace_get_order_volumetry | Read the weight and dimensions eMAG knows for each product of an order, to fill the packages of an AWB |
emag_marketplace_get_awb | Read an AWB (shipping label) issued through the API: order or return id, AWB number and barcode, courier, status history, weight and cash… |
emag_marketplace_get_awb_pdf | Download an AWB issued through the API as a PDF in A4, A5 or A6 (or as ZPL), to print the shipping label |
emag_marketplace_get_awb_zpl | Read an AWB issued through the API in ZPL (base64), for thermal label printers |
emag_marketplace_list_returns | Read return requests (RMA) with order, products, return reason, pickup address, AWBs and status (1 incomplete, 2 new, 3 acknowledged, 4… |
emag_marketplace_count_returns | Count return requests with the same filters as emag_marketplace_list_returns, e.g. how many new (2) returns wait |
emag_marketplace_list_localities | Read localities (cities with their region, zip code and emag_id) for the sender and receiver of an AWB |
emag_marketplace_list_courier_accounts | List your courier accounts (id, courier name, type order or return, lockers or offices, status) to choose the courier_account_id of an AWB |
emag_marketplace_list_addresses | List your pickup, return and invoice addresses (address_id, type, locality, street) to use as sender or return address of an AWB or return |
emag_marketplace_list_awb_packages | List your predefined AWB packages (label, length, width, height, weight, default), used when issuing AWBs without explicit packages |
emag_marketplace_list_campaigns | Read the eMAG campaigns (Black Friday, discount, voucher, multi deals) with start, end and offer deadline and their participation rules… |
emag_marketplace_list_campaign_categories | Read the categories eligible for campaigns with restricted categories (participationRules.restrictedCategories true): id, name and parent.… |
emag_marketplace_list_campaign_eligible_offers | Read your offers that may join a campaign: current price, lowest price of the last 30 days (cmmp), maximum campaign price, stock… |
emag_marketplace_get_offer_campaign_badges | Read the campaign badges (Black Friday, Genius Days and others) active or planned for one of your offers, with label text and dates. eMAG… |
emag_marketplace_check_smart_deals_price | Get the price an offer must reach to qualify for the Smart Deals badge |
emag_marketplace_list_invoice_categories | List the categories of the invoices eMAG issues to you (e.g |
emag_marketplace_list_invoices | Read the invoices eMAG issued to you (commission, services and others): number, date, lines, totals with and without VAT and currency |
emag_marketplace_list_customer_invoices | Read the invoices issued to your customers on eMAG orders (normal or storno): order id, number, date, lines and totals |
emag_marketplace_update_offers | Update existing offers only (light offer API, up to 50 per call): price, recommended, minimum and maximum price, stock and handling time… |
emag_marketplace_update_offer_stock | Set the stock of one offer per warehouse (PATCH, stock only) |
emag_marketplace_save_product_offers | Create new products with their offer, or update offers, up to 50 per call |
emag_marketplace_save_measurements | Save the volume measurements of products (length, width, height in millimetres, weight in grams) |
emag_marketplace_acknowledge_order | Acknowledge a new order: moves it from 1 (new) to 2 (in progress) and stops eMAG notifying you about it |
emag_marketplace_save_order | Update an order: set status 3 (prepared), 4 (finalized) or 0 (canceled with reason_cancellation), remove or add products, or storno a… |
emag_marketplace_unlock_courier | Unlock the courier selection of an order so a different courier account can be used for its AWB |
emag_marketplace_save_order_attachments | Attach documents to orders by URL: invoice (type 1), warranty (type 3, with order_product_id) and other types |
emag_marketplace_create_awb | Issue an AWB (shipping label) with your eMAG courier account for an order or a return: sender, receiver (with locality_id), parcels or… |
emag_marketplace_save_return | Update a return request (RMA), mainly its request_status: 2 new to 3 acknowledged or 5 canceled, 3 to 6 received, 6 to 4 refused or 7… |
emag_marketplace_propose_campaign_offers | Propose your offers in a campaign with the campaign price (and voucher discount, maximum quantity per order or date intervals where the… |
プロンプトの例
- 「eMAG の出品のうち、非アクティブなものや出品検証ステータスが無効なものは何件ありますか？」
- 「今日の eMAG の新規注文（ステータス 1）を商品と支払方法付きで一覧にしてください。」
- 「出品 10452 の価格を税抜 189.90 RON に下げ、在庫を 25 にしてください。先に変更前後の値を見せてください。」
- 「注文 412398765 の AWB を 当社の配送業者アカウントで発行し、A6 の PDF をください。先に AWB のデータを見せてください。」
- 「Black Friday キャンペーンに参加できる出品はどれで、それぞれの最大キャンペーン価格はいくらですか？」
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" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?