概要
中南米最大のマーケットプレイスです。商品、カタログ商品とそこで競合する出品、注文、送料、手数料、閲覧数、トレンド、購入者からの質問を取得し、出品者自身の出品（作成、検証、価格・在庫・説明文の変更、一時停止または終了）とプロモーションを管理し、Product Ads のキャンペーンと指標を読み取れます。対象はブラジル (MLB)、アルゼンチン (MLA)、メキシコ (MLM)、チリ (MLC)、コロンビア (MCO)、ペルー (MPE)、ウルグアイ (MLU) です。出品者の Mercado Libre アカウントでサインインします。
ガイド付きセットアップ
Mercado Libre を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Mercado Libre を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Mercado Libre のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Mercado Libre をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Mercado Libre + Microsoft Copilot
中南米最大のマーケットプレイスです。商品、カタログ商品とそこで競合する出品、注文、送料、手数料、閲覧数、トレンド、購入者からの質問を取得し、出品者自身の出品（作成、検証、価格・在庫・説明文の変更、一時停止または終了）とプロモーションを管理し、Product Ads のキャンペーンと指標を読み取れます。対象はブラジル (MLB)、アルゼンチン (MLA)、メキシコ (MLM)、チリ (MLC)、コロンビア (MCO)、ペルー (MPE)、ウルグアイ (MLU) です。出品者の Mercado Libre アカウントでサインインします。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
MERCADO_LIBRE_CLIENT_ID, MERCADO_LIBRE_CLIENT_SECRET, MERCADO_LIBRE_SITE_DOMAIN
ステップ 1 — 認証情報を取得
- お使いの国の開発者センター
https://developers.mercadolibre.com/devcenterを開き、アプリケーションを作成します。 - リダイレクト URI
https://cloud.anythingmcp.com/api/mcp-oauth/callbackを記載どおり正確に登録します。AnythingMCP をセルフホストしている場合は<your AnythingMCP URL>/api/mcp-oauth/callbackです。 - App ID を
MERCADO_LIBRE_CLIENT_IDに、Secret Key をMERCADO_LIBRE_CLIENT_SECRETにコピーします。 MERCADO_LIBRE_SITE_DOMAINに自国のサイト（mercadolivre.com.br、mercadolibre.com.ar、mercadolibre.com.mx、mercadolibre.cl、mercadolibre.com.co、mercadolibre.com.pe、mercadolibre.com.uyのいずれか）を設定します。どの国のサインインページが開くかは、この値で決まります。- コネクターをインストールし、Authorize with Provider をクリックして出品者アカウントでサインインします。スコープは
offline_access read writeのままにしてください。出品ツールには write が必要です。
サイトと ID: MLB はブラジル、MLA はアルゼンチン、MLM はメキシコ、MLC はチリ、MCO はコロンビア、MPE はペルー、MLU はウルグアイです。商品 ID とカテゴリ ID には MLB1234567890 のようにサイトの接頭辞が付きます。出品者向けツールは、サインイン中の出品者についてのみ応答します。mercado_libre_get_user に me を渡すと、あなたの出品者 ID が返ります。
出品の作成: Mercado Libre にはサンドボックスがないため、新しい出品はすぐに公開され、そのまま売れる可能性があります。AI は次の流れで出品します。
- 商品タイトルからカテゴリを予測します。
- カテゴリの属性（必須属性はすべて送信します。多くの場合ブランド、モデル、GTIN です）、保証条件、出品タイプ（gold_special はクラシック、gold_pro はプレミアム）、上限（タイトルの最大文字数、画像の枚数、最低価格など）を読み取ります。
- 公開はせずに、完成した出品内容を検証します。
- 出品を作成し、続けて説明文をプレーンテキストで追加します。
family_name か title か: User Products モデル（2025 年以降、大半の出品者が対象）の出品者は、family_name（「Apple iPhone 15 128GB」のような汎用的な商品名）を送り、title は送りません。タイトルは Mercado Libre が自動で作成します。旧モデルのままの出品者は title を送ります。「The fields [title] are invalid」というエラーは、family_name が必要という意味です。family_name を持つ出品は、タイトルの変更を受け付けません。
出品の変更: 価格、在庫、画像、属性、販売条件を変更できます。画像と属性は、リスト全体が置き換わります。在庫を 0 にすると、在庫が戻るまで出品は一時停止します。出品は一時停止と再開ができ、説明文も差し替えられます。販売実績がついた出品は、タイトル、商品の状態、購入方式を変更できません。
まず確認: 書き込みはすべて実際のショップに反映されるため、AI は一つひとつあなたに確認します。インストール時にオフになっているツールは 3 つです。出品を完全に終了する mercado_libre_close_listing（元に戻せる代替手段は一時停止です）、mercado_libre_post_answer、mercado_libre_remove_item_from_promotion です。
注文、手数料、質問、プロモーション、Product Ads: AI は個々の注文とその配送の送料も読み取り、ある価格での販売手数料と、送料無料にした場合の出品者負担額を計算し、最大 20 件の出品をまとめて取得します。出品の閲覧数、カテゴリーで最も検索されているキーワード、カタログ出品の場合は同じ商品ページの他の出品者と、そのページを獲得できる価格を表示します。未回答の購入者の質問を一覧にし、プロモーションの招待とキャンペーンを読み取り、出品をプロモーションに追加し、Product Ads のキャンペーン、広告、指標を読み取ります（最大 90 日前まで。Mercado Ads で Product Ads が有効になっている必要があります）。回答は出品ページですぐに公開され後から編集できないため mercado_libre_post_answer はオフ、出品が通常価格に戻るため mercado_libre_remove_item_from_promotion もオフになっています。必要な場合はコネクターページで意図的にオンにしてください。AI は変更のたびに確認します。
すでにインストール済みですか？ 以前にインストールしたコネクターには、カタログ更新を通じて新しいツールが追加されます。AnythingMCP でコネクターを開き、Catalog update available で新しいツールの一覧を確認して Apply update をクリックします。認証情報や自分で追加したツールはそのまま残り、終了、回答、プロモーションからの削除の各ツールは新規インストール時と同じくオフの状態で追加されます。
レート制限: アプリケーションのリクエストが多すぎると、Mercado Libre は 429 を返します。そのため、出品の大量変更は並列ではなく 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 ウィンドウで試します。
Mercado Libreのツールが必要になる依頼をしてみましょう。 - 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 |
|---|---|
mercado_libre_get_item | Fetch full details for a Mercado Libre item by id |
mercado_libre_get_user | Get a user's public profile (typically used to inspect a seller) |
mercado_libre_list_orders | List orders for an authenticated seller |
mercado_libre_predict_category | Suggest the category for a new listing from its title (the category predictor) |
mercado_libre_get_category | Read a category and the rules a listing in it must follow: path_from_root, listing_allowed, status, and settings such as max_title_length… |
mercado_libre_get_category_attributes | List the attributes (technical specifications) of a category: id, name, value_type, allowed values with their value_id, and tags |
mercado_libre_get_category_sale_terms | List the sale terms of a category, such as WARRANTY_TYPE and WARRANTY_TIME with their allowed values and units, to fill sale_terms when… |
mercado_libre_list_listing_types | List the listing types of a site (e.g. gold_pro, gold_special, free) with their names |
mercado_libre_list_seller_items | List the ids of a seller's listings, 50 per page by default (max 100), optionally filtered by status or SKU |
mercado_libre_validate_listing | Check a new listing without publishing it |
mercado_libre_create_listing | Publish a new listing on the seller's account; it goes live and can sell at once |
mercado_libre_update_listing | Change a listing: price, stock (available_quantity), pictures, attributes, sale terms, video or shipping |
mercado_libre_set_listing_status | Pause a listing (hidden from buyers, can be reactivated) or reactivate a paused one |
mercado_libre_close_listing | End a listing for good (status closed) |
mercado_libre_get_listing_description | Read the description text of a listing (plain_text), with its creation and update dates |
mercado_libre_add_listing_description | Add the description to a listing that has none yet, typically right after mercado_libre_create_listing |
mercado_libre_update_listing_description | Replace the description of a listing |
mercado_libre_get_items | Read up to 20 listings in one call (items multiget) |
mercado_libre_get_order | Get one order by id: status, date, buyer nickname, order_items (listing, variation, quantity, unit price), payments, total_amount, shipping… |
mercado_libre_get_shipment_costs | Get the cost breakdown of a shipment: what the buyer paid (receiver) and what the seller pays (senders), with discounts and the gross amount |
mercado_libre_get_free_shipping_cost | Quote what the seller pays to offer free shipping (Mercado Envios) for a listing or for a package size: returns the coverage cost the… |
mercado_libre_get_listing_prices | Work out the selling fees for a price on a site: per listing type, the sale_fee_amount Mercado Libre keeps on each sale (with… |
mercado_libre_get_item_visits | Get the total visits of one or more listings between two dates |
mercado_libre_get_item_visits_by_day | Get the daily visits of one listing over the last N days (time window up to 150 days) |
mercado_libre_get_product | Get a catalog product by id: name, family, attributes, pictures, main features, the domain and buy_box_winner (the listing currently… |
mercado_libre_list_product_items | List the listings that compete on a catalog product page: item_id, seller_id, price, currency, condition, listing type, shipping (free… |
mercado_libre_get_item_price_to_win | Check how a catalog listing competes for the product page: status (winning, sharing_first_place, competing, listed), price_to_win (the… |
mercado_libre_get_category_trends | Get the most searched keywords of a category on a site, by recent growth and volume |
mercado_libre_search_questions | Search buyers' questions on the seller's listings: by seller (all listings) or by one listing, optionally only UNANSWERED ones |
mercado_libre_post_answer | Publish the seller's answer to a buyer's question on a listing |
mercado_libre_list_seller_promotions | List the promotions the seller is invited to or runs (seller-promotions API): id, type (DEAL, MARKETPLACE_CAMPAIGN, PRICE_DISCOUNT… |
mercado_libre_get_promotion | Get the details of one promotion: name, type, status, dates, deadline to join, benefits and, for seller campaigns, the discount rules |
mercado_libre_list_promotion_items | List the seller's listings in a promotion with their status there (candidate = invited, pending, started, finished), price and… |
mercado_libre_get_item_promotions | List every promotion a listing takes part in or is invited to: promotion id, type, status (candidate, pending, started), the price in the… |
mercado_libre_add_item_to_promotion | Add a listing to a promotion, or accept an invitation, at a promotional price |
mercado_libre_remove_item_from_promotion | Take a listing out of a promotion; it goes back to its normal price |
mercado_libre_list_advertisers | List the Mercado Ads advertiser accounts the signed-in user can reach for Product Ads: advertiser_id, site_id and name |
mercado_libre_search_ad_campaigns | List Product Ads campaigns of an advertiser with their status, budget, strategy and ACOS target and, with a date range and metrics, their… |
mercado_libre_get_ad_campaign | Get one Product Ads campaign: name, status, budget, strategy, ACOS or ROAS target and, with a date range and metrics, its results (clicks… |
mercado_libre_search_product_ads | List the Product Ads (one per promoted listing) of an advertiser with their status and campaign and, with a date range and metrics, each… |
mercado_libre_search_ad_groups | Find the Product Ads ad groups of an advertiser, e.g. the ad group of given listings: returns each ad group's id, name, status, campaign_id… |
プロンプトの例
- 「出品中の商品を価格と在庫付きで一覧表示し、残りが 5 個未満のものに印を付けてください。」
- 「新品の Apple iPhone 15 128GB を R$ 4,999、在庫 10 個で出品してください。公開する前に検証して、結果を見せてください。」
- 「出品 MLB1234567890 の価格を 10% 下げて、説明文を新しい保証の文面に更新してください。」
- 「過去 7 日間の注文を、ステータスと合計金額付きで表示してください。」
- 「自分の出品に寄せられた未回答の質問を一覧にし、それぞれの回答案を作成してください。」
- 「出品 MLB1234567890 について、過去 30 日間の閲覧数、現在の価格での販売手数料、カタログ商品ページを獲得できる価格を表示してください。」
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" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?