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

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

Shippo + Gemini

Дайте ИИ заниматься доставкой через Shippo: проверять адреса, сравнивать актуальные тарифы ваших перевозчиков, покупать этикетки и возвращать за них деньги, отслеживать посылки, готовить таможенные документы и создавать scan forms. Тестовый режим бесплатный.

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

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

SHIPPO_API_TOKEN

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

1. Зарегистрируйтесь бесплатно на apps.goshippo.com/join, затем откройте портал API по адресу portal.goshippo.com/api-config/api и перейдите в API Configuration → Developer keys.
2. Нажмите Create new test key, чтобы бесплатно всё попробовать, или Create new live key, чтобы покупать настоящие этикетки. Сразу скопируйте ключ: Shippo показывает его только один раз. Тестовые ключи начинаются с shippo_test_, боевые с shippo_live_.
3. Вставьте ключ в SHIPPO_API_TOKEN в точности так, как он показан, без слова ShippoToken, и установите коннектор.
4. Начните с shippo_list_carrier_accounts: он должен показать собственные аккаунты перевозчиков Shippo (например, USPS), готовые к работе в США, а также названия перевозчиков, которые ожидает shippo_get_tracking.

Тест или боевой режим: это определяет ключ. С тестовым ключом этикетки бесплатные и помечены водяным знаком «SAMPLE - DO NOT MAIL», трек-номера никогда не обновляются, возвраты всегда проходят успешно, а манифесты (scan forms) недоступны. Тестовый ключ видит только тестовые данные, боевой только боевые. Аккаунты перевозчиков, которые вы подключаете в Shippo со своими учётными данными перевозчика, работают только в том режиме, в котором были добавлены.

Покупка этикетки стоит денег: с боевым ключом shippo_buy_label сразу списывает стоимость этикетки (плюс страховку, если она есть) с вашего аккаунта Shippo, поэтому ИИ сначала называет перевозчика, услугу, цену и оба адреса и ждёт вашего подтверждения. shippo_create_shipment только получает актуальные тарифы и ничего не покупает. Ссылка на этикетку через некоторое время перестаёт работать; shippo_get_label выдаёт новую. shippo_request_refund аннулирует этикетку, после чего ею нельзя пользоваться, и запрашивает у перевозчика возврат денег. Это возможно только для неиспользованных этикеток не старше 90 дней, а сам возврат занимает от нескольких дней до нескольких недель.

Разрешения и режим только для чтения: ключ может делать всё, что может ваш аккаунт Shippo. Чтобы ИИ никогда не тратил деньги и не аннулировал этикетки, отключите shippo_buy_label, shippo_request_refund и shippo_create_manifest. ИИ по-прежнему сможет проверять адреса, сравнивать тарифы, отслеживать посылки и смотреть прошлые этикетки.

Международные отправления: для них нужна таможенная декларация. ИИ создаёт по одной позиции на товар через shippo_create_customs_item (описание, количество, вес нетто, стоимость, страна происхождения, код ТН ВЭД), затем через shippo_create_customs_declaration саму декларацию с лицом, которое подтверждает данные, и прикрепляет её к отправлению. Держите под рукой коды и стоимость ваших товаров.

Проверка адресов: shippo_validate_address сохраняет проверенный и приведённый к стандарту адрес (например, с кодом ZIP+4) как новый адрес и не меняет исходный; отправления затем идут на новый. С тестовым ключом адреса за пределами США возвращаются без проверки; с боевым ключом их проверка платная.

Лимиты: в минуту Shippo допускает 500 операций создания и 4 000 чтений отдельных объектов, но только 50 запросов списков (10 с тестовым ключом). При превышении лимита Shippo отвечает 429: подождите минуту и повторите попытку.

Частые ошибки: 401 Token does not exist означает, что ключ неверный или удалён: создайте новый в API Configuration → Developer keys и вставьте его без слова ShippoToken. В ответе 400 указано поле, которое отсутствует или заполнено неверно, например адрес, который отклоняет перевозчик. 422 или этикетка со статусом ERROR означает, что перевозчик отказал, например потому что услуга не работает на этом маршруте или не хватает таможенных данных; причина указана в сообщениях. Этикетка или возврат со статусом QUEUED или WAITING ещё обрабатывается: запросите статус ещё раз через несколько секунд.

Коннектор не работает с пакетами отправлений (batches), заказами, вызовом курьера, вебхуками, кроме регистрации отслеживания, и не подключает ваши собственные аккаунты перевозчиков.

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

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

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

• «Сравните тарифы UPS и USPS для посылки весом 2 кг (30 x 20 x 15 см) с нашего сохранённого адреса склада на 350 5th Ave, New York, NY 10118 и покажите самый дешёвый и самый быстрый вариант.»
• «Где сейчас посылка с трек-номером USPS 9400111899223197428490 и когда она должна прийти?»
• «Купите самую дешёвую этикетку USPS для заказа Acme Ltd на адрес 233 S Wacker Dr, Chicago, IL 60606 и пришлите трек-номер и ссылку на этикетку.»
• «Подготовьте таможенные документы для 3 керамических кружек общей стоимостью 45 USD для клиента в Торонто, Канада, а затем покажите доступные тарифы.»

FAQ

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

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

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