DHL Paket MCP: подключить к Gemini CLI

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

DHL Parcel DE Shipping + Gemini

Оформляйте отправления DHL Paket из ИИ по собственному договору бизнес-клиента DHL (Geschäftskundenkonto) через официальный API Parcel DE Shipping v2: проверка отправлений перед оформлением, оформление с получением трек-номеров и этикеток, повторная загрузка этикеток, отмена отправлений, дневное закрытие (Tagesabschluss) и получение манифеста.

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

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

DHL_API_KEY, DHL_API_SECRET, DHL_GKP_USERNAME, DHL_GKP_PASSWORD

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

Настройка занимает около 15 минут плюс время, пока DHL одобрит ваше приложение. Нужен договор бизнес-клиента DHL с доступом к DHL Geschäftskundenportal (GKP) и аккаунт на developer.dhl.com.

1. На developer.dhl.com откройте My Apps → Create App и добавьте API Parcel DE Shipping (Post & Parcel Germany). Когда DHL одобрит приложение, скопируйте его API Key в DHL_API_KEY, а API Secret в DHL_API_SECRET.
2. В Geschäftskundenportal выберите пользователя, которому разрешено создавать отправления, и укажите его имя пользователя в DHL_GKP_USERNAME, а пароль в DHL_GKP_PASSWORD. Лучше всего отдельный системный пользователь: Benutzerverwaltung → Systembenutzer anlegen. Личный пользователь GKP тоже подойдёт, но его пароль регулярно истекает.
3. Установите коннектор. Шага Authorize with Provider нет: AnythingMCP обменивает четыре значения на access token (OAuth2 password grant) и сам его обновляет.
4. Найдите свои номера для расчётов в GKP в разделе Vertragsdaten, затем попробуйте dhl_parcel_de_validate_shipments с тестовым отправлением: DHL проверит его как настоящее оформление, но ничего не будет создано или выставлено к оплате.

Номер для расчётов (Abrechnungsnummer): каждому отправлению нужен billingNumber из 14 символов: ваш 10-значный номер клиента (EKP), 2 цифры процедуры продукта и 2 цифры участия (Teilnahme, обычно 01). Для DHL Paket (процедура 01) с участием 01 это ваш EKP, за которым следует 0101. Сообщите ИИ свой EKP один раз, и он сам соберёт номер.

Продукты: V01PAK DHL Paket (процедура 01), V62KP DHL Kleinpaket (62, заменяет Warenpost), V53WPAK DHL Paket International (53), V54EPAK DHL Europaket для бизнес-клиентов в Европе (54) и V66WPI Warenpost International (66). Какие услуги можно добавить (выбранный сосед, выбранное место или день, вручение только указанному лицу, без вручения соседям, визуальная проверка возраста, подпись получателя, дополнительная страховка, наложенный платёж, крупногабаритный груз, Premium, GoGreen Plus, DHL Retoure, перенаправление в отделение), зависит от продукта и вашего договора.

Что он делает:

• dhl_parcel_de_validate_shipments проверяет адреса, продукт, услуги и номер для расчётов и возвращает те же сообщения, что и оформление. Ничего не создаётся и не выставляется к оплате.
• dhl_parcel_de_create_shipments оформляет до 30 отправлений за вызов и возвращает для каждого номер отправления (трек-номер) с этикеткой, ссылкой или, с includeDocs: include, в base64. DHL выставляет счёт за каждое оформленное отправление, если его не отменить в тот же день, поэтому ИИ спрашивает вас перед оформлением и сначала проверяет новые данные.
• dhl_parcel_de_get_labels повторно загружает этикетки и таможенные документы, до 30 номеров отправлений за раз.
• dhl_parcel_de_cancel_shipments отменяет отправления, которые ещё не закрыты, обычно до конца дня. За отменённое отправление счёт не выставляется, а его этикетка становится недействительной.
• dhl_parcel_de_close_out сразу выполняет дневное закрытие (Tagesabschluss) для некоторых или всех отправлений, не дожидаясь автоматического закрытия вечером. Закрытые отправления больше нельзя отменить.
• dhl_parcel_de_get_manifest возвращает манифест (Einlieferungsliste) за день: PDF с закрытыми отправлениями по номерам для расчётов и сведения о том, на каком листе какое отправление.

После установки включены все 6 инструментов, в том числе те, что оформляют, отменяют и закрывают отправления. Если ИИ должен только проверять данные отправлений, отключите dhl_parcel_de_create_shipments, dhl_parcel_de_cancel_shipments и dhl_parcel_de_close_out на странице коннектора.

Как читать ответ: в ответе есть status и список items, по одной записи на отправление в порядке запроса. HTTP 207 означает, что часть отправлений не прошла: sstatus и validationMessages каждой записи объясняют почему. Слабое предупреждение об адресе («Die Adresse konnte nicht geprüft werden») не мешает оформлению; с mustEncode: true DHL отклоняет адреса, которые не может распознать.

Отслеживание: чтобы следить за оформленным отправлением, используйте коннектор DHL Shipment Tracking с номером отправления.

Ограничения: до 30 отправлений в запросе. Если вызовы идут слишком часто, DHL отвечает 429: подождите немного и повторите.

Частые ошибки: 401 означает, что DHL отклонил вход. Проверьте, что DHL_API_KEY и DHL_API_SECRET относятся к одобренному приложению с API Parcel DE Shipping и что имя пользователя и пароль GKP верны. Личный пароль GKP истекает, и его нужно обновить на портале.

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

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

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

• «Проверь без оформления DHL Paket весом 2 кг для Anna Schmidt, Hauptstraße 5, 79098 Freiburg.»
• «Оформи отправление и дай мне трек-номер и ссылку на этикетку.»
• «Отмени отправление 00340434161234567890, клиент отменил заказ.»
• «Сделай дневное закрытие за сегодня и дай мне манифест.»
• «Загрузи ещё раз этикетки для этих трёх номеров отправлений.»

FAQ

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

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

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