Как подключить Allegro к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Allegro, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Allegro + Gemini

Управляйте аккаунтом продавца Allegro (allegro.pl, .cz, .sk, .hu) из любого AI-агента: предложения с ценой, остатком и статусом, заказы со статусом выполнения и трек-номерами, возвраты и возмещения, сообщения покупателей, обсуждения и рекламации, комиссии, кошелёк и оценки. Вход через OAuth аккаунтом продавца; возмещения и решения по рекламациям отключены при установке.

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

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

ALLEGRO_CLIENT_ID, ALLEGRO_CLIENT_SECRET

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

Настройка занимает около 10 минут. Нужен аккаунт продавца Allegro, на который будет работать ИИ. Allegro, allegro.cz, allegro.sk и allegro.hu обслуживаются одним API (https://api.allegro.pl).

1. Войдите на https://apps.developer.allegro.pl аккаунтом продавца. Для тестов используйте https://apps.developer.allegro.pl.allegrosandbox.pl и sandbox-аккаунт.
2. Зарегистрируйте новое приложение того типа, который работает через браузер и перенаправление, а не device flow.
3. В поле redirect URI укажите <your AnythingMCP URL>/api/mcp-oauth/callback, в AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback, символ в символ.
4. Дайте приложению права, которые использует коннектор: чтение профиля, чтение и запись предложений, чтение настроек продаж, чтение и запись заказов, сообщения, обсуждения, оценки, чтение биллинга и чтение платежей (запись платежей, только если нужны возмещения). Коннектор не запрашивает явный scope, поэтому Allegro выдаёт то, что объявлено в приложении; при отсутствии права соответствующие инструменты отвечают 403.
5. Вставьте Client ID в ALLEGRO_CLIENT_ID, а Client Secret в ALLEGRO_CLIENT_SECRET и сохраните.
6. На странице коннектора нажмите Authorize with Provider и войдите аккаунтом продавца.
7. Запустите allegro_get_me: он покажет подключённый аккаунт и подтвердит вход.

Токены доступа действуют 12 часов и обновляются через refresh-токен, который остаётся действительным 3 месяца после каждого использования. Если коннектор простаивает дольше, авторизуйте его снова. Для sandbox измените в настройках коннектора базовый URL на https://api.allegro.pl.allegrosandbox.pl, а адреса OAuth на страницы входа в https://allegro.pl.allegrosandbox.pl/auth/oauth/.

Чей это аккаунт: все, кто пользуется этим коннектором, действуют от имени продавца, который его авторизовал. Сообщения, ответы на оценки, статусы заказов и изменения предложений видят покупатели.

Что он читает: аккаунт, его оценку качества продаж с историей до 30 дней и статистику оценок. Собственные предложения с ценой, остатком, числом продаж, статусом и категорией, с фильтром по названию, статусу, диапазону цены или вашему SKU (внешний ID), и события предложений за последние 24 часа. Каталог товаров Allegro по названию, EAN/GTIN или MPN, дерево категорий с параметрами категорий, а также тарифы доставки, правила возврата и условия гарантии продавца. Заказы со статусом, статусом выполнения, позициями и суммами, по каждому заказу данные покупателя, доставки и счёта, события заказов, посылки и историю их отслеживания. Возвраты покупателей и возмещения. Ветки и сообщения центра сообщений. Обсуждения и рекламации с их сообщениями. Комиссии (записи биллинга) и платёжные операции кошелька. Оценки с комментариями и ответами.

Что он записывает: создаёт предложения на основе товара из каталога (черновиком с INACTIVE или сразу в продаже с ACTIVE), меняет поля предложения, цену и остаток, активирует или завершает предложения, задаёт статус выполнения заказа, добавляет трек-номера посылок (покупатель получает уведомление), отвечает покупателям и начинает переписку по заказу, отмечает ветки прочитанными, пишет в обсуждениях и рекламациях и публично отвечает на оценки. Перед сообщением, ответом на оценку, сменой статуса или цены или новым активным предложением ИИ показывает точный текст или изменение и ждёт вашего «да».

Отключено при установке: allegro_delete_draft_offer, allegro_reject_customer_return, allegro_create_refund (перемещает деньги и необратимо; дополнительно нужно право allegro:api:payments:write) и allegro_change_claim_status (формальное решение по рекламации, о котором покупатель узнаёт сразу). Администратор включает те, что нужны команде.

Форматы данных: суммы передаются объектом вида {"amount": "129.99", "currency": "PLN"}, где сумма это десятичная строка, и цены отправляются так же. Даты в ISO 8601 по UTC. ID заказов, позиций, платежей и товаров это UUID; ID предложений и пользователей это числа, передаваемые строками. ID маркетплейсов выглядят как allegro-pl, allegro-cz, allegro-sk и allegro-hu. Создание или изменение предложения может вернуть 202; тогда ИИ отслеживает операцию через allegro_get_offer_operation до завершения.

Пагинация и ограничения: большинство списков принимают offset и limit и возвращают count и totalCount; заказы идут до 100 на страницу, списки сообщений не более 20. allegro_search_products листает через page_id (nextPage.id), инструменты событий через from с ID последнего события. Allegro ограничивает число запросов на Client ID в минуту, отправку сообщений одним в секунду и подсказки категорий пятью в секунду. Остаток 0 для активного предложения не принимается: вместо этого завершите предложение.

Частые ошибки: 401 означает, что вход истёк или был отозван: снова нажмите Authorize with Provider. При входе invalid_client означает неверный Client ID или Secret, а ошибка перенаправления указывает, что redirect URI не совпадает точно. 403 означает, что у приложения нет нужного права или ресурс принадлежит другому продавцу. 404 это неизвестный ID. 409 при смене статуса выполнения означает, что заказ изменился: возьмите новую revision из allegro_get_order. 422 перечисляет ошибки валидации в errors[].userMessage. 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 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Allegro.

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

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

• «Какие заказы оплачены и всё ещё имеют статус выполнения NEW? Покажи покупателя, товары и сумму.»
• «Снизь цену моего предложения с SKU MUG-450 до 49,99 PLN. Сначала покажи предложение.»
• «Покажи непрочитанные ветки покупателей и подготовь ответ на каждую, я его подтвержу.»
• «Сколько комиссий Allegro начислил за прошлый месяц, с разбивкой по типам?»
• «Добавь к этому заказу трек-номер DPD 1234567890123 и поставь статус SENT.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

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

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