摘要
拉丁美洲最大的电商平台：读取商品、目录产品及在其上竞争的刊登、订单、运费、费用、访问量、趋势和买家提问，管理卖家自己的刊登（创建、校验、修改价格、库存和描述、暂停或关闭）和促销活动，并读取 Product Ads 广告系列和指标，覆盖巴西 (MLB)、阿根廷 (MLA)、墨西哥 (MLM)、智利 (MLC)、哥伦比亚 (MCO)、秘鲁 (MPE) 和乌拉圭 (MLU)。使用卖家的 Mercado Libre 账号登录。
引导式设置
2 分钟将 Mercado Libre 连接到 Microsoft Copilot
开始 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 key，即可完成。无 Docker、无
git clone、无本地服务器。
Mercado Libre + Microsoft Copilot
拉丁美洲最大的电商平台：读取商品、目录产品及在其上竞争的刊登、订单、运费、费用、访问量、趋势和买家提问，管理卖家自己的刊登（创建、校验、修改价格、库存和描述、暂停或关闭）和促销活动，并读取 Product Ads 广告系列和指标，覆盖巴西 (MLB)、阿根廷 (MLA)、墨西哥 (MLM)、智利 (MLC)、哥伦比亚 (MCO)、秘鲁 (MPE) 和乌拉圭 (MLU)。使用卖家的 Mercado Libre 账号登录。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
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，并用卖家账号登录。保留 scope
offline_access read write：刊登工具需要 write 权限。
站点和 ID：MLB 是巴西，MLA 是阿根廷，MLM 是墨西哥，MLC 是智利，MCO 是哥伦比亚，MPE 是秘鲁，MLU 是乌拉圭。商品 ID 和类目 ID 带有站点前缀，例如 MLB1234567890。卖家工具只对已登录的卖家返回结果；用 me 调用 mercado_libre_get_user 会返回你的卖家 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 会逐一向你确认。安装时默认关闭三个工具：会永久结束刊登的 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，因此大批量的刊登修改会依次执行，而不是并行执行。
步骤 2 — 安装 adapter
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 中输入 @ 并选择该智能体。
希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。
自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。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" 即可使用新版本。
下一步
这份指南对你有帮助吗?