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

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

QLS + Gemini

Pakketdienst QLS (Нидерланды): посылки с этикетками и трекингом, продукты доставки и пункты выдачи, заказы фулфилмента со склада QLS, товары фулфилмента и остатки, бэкордеры, возвраты и входящие поставки. Удаление товаров и отмена заказов при установке выключены.

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

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

QLS_USERNAME, QLS_PASSWORD

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

Настройка занимает около 5 минут. Нужен аккаунт на mijn.pakketdienstqls.nl.

1. QLS проверяет API через HTTP Basic с логином и паролем портала mijn.pakketdienstqls.nl. Если аккаунт позволяет, заведите для API отдельного пользователя (обратитесь в IT-поддержку QLS по адресу [email protected]), чтобы смена пароля сотрудником не ломала коннектор.
2. Укажите имя пользователя (обычно email) в QLS_USERNAME, а пароль в QLS_PASSWORD.
3. Установите коннектор и запустите qls_list_companies. Он вернёт id компании (UUID), который все остальные инструменты принимают как company_id; qls_get_company показывает одну компанию.

Какой API: QLS Fulfilment and Parcel Service API на https://api.pakketdienstqls.nl (OpenAPI на https://api.pakketdienstqls.nl/swagger/). QLS публикует v1 и v2; коннектор использует v2 там, где QLS её предлагает (создание отправлений, возвраты, заказы поставки), и v1 для остального.

Какие id нужны сначала: id компании из qls_list_companies; id бренда из qls_list_brands (бренд хранит адреса отправителя, возврата и для таможни и нужен для отправлений и заказов); продукты доставки из qls_list_shipping_products, где combinations[].id это product_combination_id, options[].tag опции доставки, а также цены по странам и весовым диапазонам и максимальные размеры. Пункты выдачи даёт qls_list_service_points или, для одного продукта доставки, qls_list_product_service_points; их servicepoint_code указывается в отправлении или заказе.

Что он читает: посылки со статусом (created, printed, pre_transit, in_transit, delivered, returned_to_sender), штрихкодом, id и ссылкой трекинга, с фильтрами по референсу, штрихкоду, статусу, бренду, полям получателя, датам или свободному поиску; одно отправление с весом и, при with_label, ссылками на этикетку в PDF и ZPL; возвратное отправление посылки; заказы фулфилмента со статусом, заказанным, зарезервированным и отгруженным количеством, получателем, доставками и отправлениями, покинувшими склад; товары фулфилмента с EAN, SKU, артикулом, ценами, итогами остатков и ячейками склада (зона, стеллаж, полка, срок годности); остатки по товару (всего, в резерве, доступно, к продаже, продано, бэкордер, в пути, прогноз) и по ячейкам с партией; бэкордеры; возвраты со статусом, покупателем, исходным отправлением и заказом и возвращёнными товарами с причиной; заказы поставки (заявленные входящие поставки) со статусом, товарами, поставщиками и доставками, включая находящиеся в пути; поставщиков.

Что он записывает: qls_create_shipment оформляет посылку у перевозчика и возвращает штрихкод, ссылку трекинга и label_pdf_url; адреса отправителя и возврата по умолчанию берутся из бренда. qls_create_fulfillment_order поручает QLS собрать, упаковать и отправить товары с вашего склада. qls_update_fulfillment_order ставит заказ на удержание, снимает его или меняет дату обработки, референс, примечания или пункт выдачи. qls_create_fulfillment_product и qls_update_fulfillment_product ведут товары; qls_create_return_from_order заявляет возврат; qls_create_purchase_order заявляет товар, который едет на склад. Отправление стоит денег, а заказ фулфилмента отгружает реальный товар, поэтому перед каждой записью ИИ показывает получателя, товары и количества и продукт доставки и ждёт вашего «да».

Выключено при установке: qls_delete_fulfillment_product и qls_cancel_fulfillment_order, действие которых нельзя отменить. Администратор включает их, когда это нужно команде.

Форматы данных: каждый ответ обёрнут как {"meta": {"code": 200}, "errors": [], "data": ..., "pagination": ...}; данные лежат в data. Вес в граммах, цены и наложенный платёж в евро, размеры в миллиметрах. Id компаний, брендов, заказов, товаров и отправлений это строки UUID; id продуктов доставки и комбинаций целые числа. Статусы заказов фулфилмента: error_validation, concept, received, pending, partically_sent (написание QLS) и sent. Фильтры дат для остатков и заказов поставки принимают d-m-Y H:i (например 1-10-2026 00:00), остальные дату или дату со временем вида 2026-10-01 00:00:00.

Постраничная выдача: списки возвращают до 100 записей на страницу. pagination содержит page, pageCount, count и nextPage; ИИ запрашивает следующую page, пока nextPage равно true.

Частые ошибки: 401 означает неверные имя пользователя или пароль: это логин mijn.pakketdienstqls.nl. 404 (Niet Gevonden) означает неизвестный id или чужой id компании: берите id из инструментов списков. 422 или непустой список errors это ошибка валидации; QLS отвечает по-нидерландски.

Коннектор не отменяет посылки, не читает счета QLS и не меняет бренды и настройки компании: для этого нет инструментов.

Шаг 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 теперь может вызывать инструменты QLS.

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

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

• «Какие продукты доставки QLS доступны нам для Нидерландов и Бельгии и сколько они стоят по весовым диапазонам?»
• «Найди пункты выдачи DHL рядом с индексом 3011 AB.»
• «Создай посылку PostNL для заказа 1042 на Jan de Vries, Роттердам, 1200 граммов. Сначала покажи получателя, продукт и вес.»
• «У каких товаров фулфилмента доступно меньше 20 штук и что по ним в пути?»
• «Покажи заказы фулфилмента за эту неделю, которые ещё в статусе pending или partically_sent.»

FAQ

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

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

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