Кратко
API продавца Prom.ua для магазинов на украинском маркетплейсе: заказы с данными покупателя и доставки, изменение статусов заказов, товары и группы товаров, клиенты и сообщения покупателей. Bearer-токен из кабинета продавца.
Пошаговая настройка
Подключи Prom.ua к Microsoft Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Prom.ua в пошаговой настройке и добавь свой MCP URL в Microsoft Copilot. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Prom.ua
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Prom.ua, вставьте учётные данные, создайте MCP API key — готово. Без Docker, без
git clone, без локального сервера.
Prom.ua + Microsoft Copilot
API продавца Prom.ua для магазинов на украинском маркетплейсе: заказы с данными покупателя и доставки, изменение статусов заказов, товары и группы товаров, клиенты и сообщения покупателей. Bearer-токен из кабинета продавца.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
PROM_UA_API_TOKEN
Шаг 1 — Получите учётные данные
- В кабинете продавца Prom.ua откройте Settings → API token management (Налаштування → Управління API-токенами) и создайте токен.
- Откройте токену доступ к разделам, с которыми должен работать ассистент (заказы, товары, клиенты, сообщения), и вставьте его в
PROM_UA_API_TOKEN. Токен видит только ту компанию, для которой он создан; на неверный или отозванный токен API отвечает HTTP 401. - Начните с
prom_ua_list_orders(фильтр по статусу или датам), затем вызовитеprom_ua_get_order, чтобы получить данные покупателя, доставки и позиции заказа.prom_ua_list_order_statusesпоказывает статусы этой компании, включая пользовательские.
prom_ua_set_order_status изменяет реальные заказы, и покупатель это видит, поэтому ассистент показывает ID заказов и новый статус и ждёт вашего согласия; для отмены нужен cancellation_reason. Даты указываются в UTC (2026-10-01T12:00:00). Списки отсортированы от новых к старым и листаются с помощью limit и last_id: для следующей страницы передайте наименьший полученный ID в last_id.
Шаг 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 агента: попроси о том, для чего нужны инструменты
Prom.ua. - Нажми 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 |
|---|---|
prom_ua_list_orders | List Prom.ua orders of the company, newest first, with buyer, contact, delivery and payment details and the ordered products |
prom_ua_get_order | Get one Prom.ua order by its numeric id: buyer and contact data, delivery method and address, payment, status and the products with… |
prom_ua_list_order_statuses | List the order statuses available to this Prom.ua company, including custom statuses and their ids |
prom_ua_set_order_status | Change the status of one or more Prom.ua orders (received, delivered, canceled, paid) or set a custom status |
prom_ua_list_products | List products of the Prom.ua store with name, SKU, price, availability, group and images |
prom_ua_get_product | Get one Prom.ua product by its numeric Prom id, with description, prices, stock state, group and images |
prom_ua_get_product_by_external_id | Get one Prom.ua product by the id it has in the seller's own accounting or ERP system (external_id) |
prom_ua_list_groups | List the product groups (store categories) of the Prom.ua company with ids, names and parent groups |
prom_ua_list_clients | List the store's Prom.ua clients (buyers) with contact data, or search them by name, phone number or e-mail |
prom_ua_get_client | Get one Prom.ua client by numeric id, with contact details and order statistics |
prom_ua_list_messages | List messages that buyers sent to the store through Prom.ua (questions about products and orders), filtered by read status or date |
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
Это руководство помогло?