Mercado Libre MCP с Microsoft Copilot

💡 Без установки? Используйте 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.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

MERCADO_LIBRE_CLIENT_ID, MERCADO_LIBRE_CLIENT_SECRET, MERCADO_LIBRE_SITE_DOMAIN

Шаг 1 — Получите учётные данные

1. Откройте центр разработчиков вашей страны по адресу https://developers.mercadolibre.com/devcenter и создайте приложение.
2. Зарегистрируйте redirect URI https://cloud.anythingmcp.com/api/mcp-oauth/callback точно в таком виде. Если вы размещаете AnythingMCP у себя, адрес будет <your AnythingMCP URL>/api/mcp-oauth/callback.
3. Скопируйте App ID в MERCADO_LIBRE_CLIENT_ID, а Secret Key в MERCADO_LIBRE_CLIENT_SECRET.
4. Укажите в MERCADO_LIBRE_SITE_DOMAIN сайт вашей страны: mercadolivre.com.br, mercadolibre.com.ar, mercadolibre.com.mx, mercadolibre.cl, mercadolibre.com.co, mercadolibre.com.pe или mercadolibre.com.uy. От этого зависит, страница входа какой страны откроется.
5. Установите коннектор, нажмите Authorize with Provider и войдите под аккаунтом продавца. Оставьте scopes offline_access read write: инструментам для объявлений нужен write.

Сайты и ID: MLB соответствует Бразилии, MLA Аргентине, MLM Мексике, MLC Чили, MCO Колумбии, MPE Перу и MLU Уругваю. ID товаров и категорий содержат префикс сайта, например MLB1234567890. Инструменты продавца отвечают только для продавца, который вошёл в систему; mercado_libre_get_user с me возвращает ваш ID продавца.

Создание объявления: у Mercado Libre нет песочницы, поэтому новое объявление сразу публикуется и может сразу продаваться. ИИ действует по такому порядку:

1. Определяет категорию по названию товара.
2. Читает атрибуты категории (передаёт все обязательные, часто это бренд, модель и GTIN), условия гарантии, типы объявлений (gold_special соответствует классическому, gold_pro премиальному) и ограничения, например максимальную длину заголовка, количество фотографий и минимальную цену.
3. Проверяет полностью заполненное объявление без публикации.
4. Создаёт объявление, затем добавляет описание обычным текстом.

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 объявление приостанавливается, пока товар снова не появится. Объявления можно приостанавливать и снова активировать, а их описание заменять. Заголовок, состояние товара и способ покупки блокируются, как только у объявления появляются продажи.

Сначала подтверждение: каждая запись затрагивает ваш реальный магазин, поэтому ИИ подтверждает у вас каждое действие. При установке выключены три инструмента: mercado_libre_close_listing, который закрывает объявление навсегда (обратимой альтернативой служит приостановка), mercado_libre_post_answer и mercado_libre_remove_item_from_promotion.

Заказы, комиссии, вопросы, акции и Product Ads: ИИ также читает отдельные заказы и стоимость их доставки, рассчитывает комиссию за продажу для заданной цены и во что вам обойдётся бесплатная доставка, а также читает до 20 объявлений за один вызов. Он показывает просмотры ваших объявлений, самые популярные поисковые запросы категории, а для объявлений в каталоге — других продавцов на той же странице товара и цену, с которой вы бы её выиграли. Он выводит неотвеченные вопросы покупателей, читает приглашения в акции и кампании, добавляет объявление в акцию и читает кампании, рекламные объявления и метрики Product Ads (до 90 дней назад; Product Ads должен быть включён в Mercado Ads). mercado_libre_post_answer выключен, потому что ответ сразу становится публичным в объявлении и его нельзя отредактировать, а mercado_libre_remove_item_from_promotion — потому что объявление возвращается к обычной цене. Включайте их осознанно на странице коннектора; ИИ спрашивает перед каждым изменением.

Уже установили? Новые инструменты попадают в ранее установленный коннектор через обновление каталога: откройте коннектор в AnythingMCP, в разделе Catalog update available проверьте список новых инструментов и нажмите Apply update. Ваши учётные данные и инструменты, добавленные вами, остаются без изменений, а инструменты закрытия, ответа и удаления из акций приходят выключенными, как и при новой установке.

Лимиты запросов: Mercado Libre отвечает 429, когда приложение отправляет слишком много запросов, поэтому крупные пакеты изменений объявлений выполняются последовательно, а не параллельно.

Шаг 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 использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь 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, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты Mercado Libre.
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-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.

Доступные инструменты

Примеры запросов

• «Покажите мои активные объявления с ценой и остатком и отметьте те, где осталось меньше 5 штук.»
• «Создайте объявление для нового Apple iPhone 15 128GB за 4 999 R$ с остатком 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, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse