Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте eMAG Marketplace одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
eMAG Marketplace API для продавцов на eMAG Румыния, Болгария и Венгрия (и Fashion Days): товары и предложения, цены и остатки, заказы с подтверждением и сменой статуса, транспортные этикетки AWB, возвраты (RMA), категории и характеристики, кампании и счета. eMAG должен внести вызывающий IP в белый список.
Попробуй спросить
Примеры промптов для eMAG Marketplace
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → eMAG Marketplace, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
eMAG Marketplace + Microsoft Copilot
eMAG Marketplace API для продавцов на eMAG Румыния, Болгария и Венгрия (и Fashion Days): товары и предложения, цены и остатки, заказы с подтверждением и сменой статуса, транспортные этикетки AWB, возвраты (RMA), категории и характеристики, кампании и счета. eMAG должен внести вызывающий IP в белый список.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
EMAG_API_HOST, EMAG_USERNAME, EMAG_PASSWORD
Шаг 1 — Получите учётные данные
Настройка занимает около 10 минут плюс время, которое eMAG тратит на внесение вашего IP в белый список.
- В кабинете продавца eMAG Marketplace используйте пользователя с правами на API (или попросите владельца аккаунта его создать).
- Белый список IP: eMAG принимает вызовы API только с зарегистрированных у них IP-адресов. Отправьте в поддержку eMAG Marketplace публичный IP, с которого обращается этот коннектор: при self-hosted установке адрес вашего сервера, в AnythingMCP Cloud фиксированный IPv4-адрес
104.248.242.235, с которого Cloud делает все вызовы. Пока 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). Каждая площадка это отдельный аккаунт, поэтому ставьте по коннектору на страну. - Укажите пользователя 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 сообщается как неудачный вызов с сообщениями. Исключение одно: при сохранении нового товара с проблемой в документации eMAG отвечает isError: true, но предложение всё равно сохраняется, поэтому ИИ перечитывает его через emag_marketplace_list_product_offers.
Что он читает: ваши товары и предложения с ценой, остатком по складам, сроком обработки, статусом, статусом проверки документации и предложения, doc_errors, позицией в buy button и кампанией, с фильтрами по id, артикулу, PNK или статусу и подсчётом по тем же фильтрам; есть ли товар на eMAG по EAN (до 100 за раз), чтобы привязать предложение к существующему товару; категории с характеристиками, допустимыми значениями и признаком обязательности; ставки НДС и сроки обработки; заказы с покупателем, адресом доставки, товарами, ваучерами, способом оплаты, стоимостью доставки и вложениями; габариты посылок; 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, AWB через emag_marketplace_create_awb, затем статус 4. emag_marketplace_save_order требует заказ целиком в прочитанном виде, отличаться должны только изменённые поля; редактировать заказ можно только в статусе 2 или 3. Ваучеры входят в данные заказа (vouchers, product_voucher_split). Для AWB ИИ выбирает курьерский аккаунт, адрес отправителя и 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, статус возвратов и предложения в кампании. Всё это действует на живой магазин и реальных курьеров. Перед каждой записью ИИ показывает, что изменится (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 в Румынии, EUR в Болгарии с 1 января 2026 года, HUF в Венгрии). Даты в формате YYYY-mm-dd HH:ii:ss по местному времени площадки.
Пагинация и лимиты: списки возвращают не больше 100 записей на страницу; ИИ сначала считает, затем листает через currentPage. Допустимые предложения кампаний листаются курсором: последний ext_id передаётся как lastId. Фильтры дат заказов при подсчёте требуют обе границы, не дальше месяца друг от друга. Вызовы сохранения принимают не больше 50 объектов (рекомендуется 10–50) и 4000 полей ввода на запрос. eMAG допускает 12 запросов в секунду для заказов и 3 в секунду для всех остальных ресурсов вместе; сверх этого отвечает 429.
Частые ошибки: You are not allowed to use this API. или 403 означает, что IP ещё не в белом списке. 401 означает неверные имя пользователя или пароль, пользователя без прав на API или хост другой площадки, чем у аккаунта. 429 это лимит частоты: подождите немного. Другие ответы с isError содержат сообщения eMAG, например о недостающих характеристиках или неверной цене.
Коннектор не открывает аккаунт продавца, не регистрирует ваш IP в eMAG и не работает сразу с несколькими площадками: один коннектор обслуживает одну страну.
Шаг 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 поддерживает.
- В 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, вставь MCP API-ключ из AnythingMCP (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-адрес своего экземпляра вместо https://cloud.anythingmcp.com. 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. Сначала покажи старые и новые значения.»
- «Оформи AWB для заказа 412398765 через наш курьерский аккаунт и дай PDF в формате A6. Сначала покажи данные 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, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
Это руководство помогло?