Кратко
Дайте ИИ заниматься доставкой через Shippo: проверять адреса, сравнивать актуальные тарифы ваших перевозчиков, покупать этикетки и возвращать за них деньги, отслеживать посылки, готовить таможенные документы и создавать scan forms. Тестовый режим бесплатный.
Пошаговая настройка
Подключи Shippo к Microsoft Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Shippo в пошаговой настройке и добавь свой MCP URL в Microsoft Copilot. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Shippo
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Shippo, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Shippo + Microsoft Copilot
Дайте ИИ заниматься доставкой через Shippo: проверять адреса, сравнивать актуальные тарифы ваших перевозчиков, покупать этикетки и возвращать за них деньги, отслеживать посылки, готовить таможенные документы и создавать scan forms. Тестовый режим бесплатный.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
SHIPPO_API_TOKEN
Шаг 1 — Получите учётные данные
- Зарегистрируйтесь бесплатно на apps.goshippo.com/join, затем откройте портал API по адресу portal.goshippo.com/api-config/api и перейдите в API Configuration → Developer keys.
- Нажмите Create new test key, чтобы бесплатно всё попробовать, или Create new live key, чтобы покупать настоящие этикетки. Сразу скопируйте ключ: Shippo показывает его только один раз. Тестовые ключи начинаются с
shippo_test_, боевые сshippo_live_. - Вставьте ключ в
SHIPPO_API_TOKENв точности так, как он показан, без слова ShippoToken, и установите коннектор. - Начните с
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 — Добавьте коннектор в 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 агента: попроси о том, для чего нужны инструменты
Shippo. - Нажми 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 |
|---|---|
shippo_create_address | Save an address, optionally validated |
shippo_get_address | Read a saved address by object_id, with its fields, completeness and any validation results |
shippo_validate_address | Validate a saved address |
shippo_list_addresses | List saved addresses, newest first, with next and previous page links |
shippo_create_parcel | Save a parcel (dimensions and weight, or a carrier parcel template plus weight) |
shippo_get_parcel | Read a saved parcel by object_id: dimensions, weight, units and template |
shippo_list_parcel_templates | List carrier parcel templates (flat rate boxes and envelopes): token, name, carrier and dimensions |
shippo_create_shipment | Create a shipment and get live rates from the account's carriers |
shippo_get_shipment | Read a shipment with its addresses, parcels, rates and messages |
shippo_list_shipments | List shipments, newest first, with status and addresses (Shippo keeps the last 390 days) |
shippo_list_shipment_rates | List the rates of a shipment again (the same rates[] shippo_create_shipment returned), with paging |
shippo_get_rate | Read one rate: amount, currency, provider, service level, estimated days, duration terms and zone |
shippo_buy_label | Buy a shipping label for a rate |
shippo_list_labels | List purchased labels (transactions), newest first, with status, tracking number and tracking status |
shippo_get_label | Read one purchased label (transaction): status, tracking number and status, ETA, a fresh label_url and commercial invoice URL, and messages |
shippo_get_tracking | Read the tracking status and history of a parcel by carrier and tracking number, for labels bought anywhere |
shippo_register_tracking | Register a tracking number for status updates, which Shippo then sends to the account's "track updated" webhook (set up in the Shippo… |
shippo_list_carrier_accounts | List the carrier accounts usable for rates and labels: object_id, carrier, account_id, active, whether it is a Shippo-provided account, and… |
shippo_get_carrier_account | Read one carrier account by object_id: carrier, account number, active flag and parameters |
shippo_create_customs_item | Create a customs item (one line of a customs declaration) |
shippo_get_customs_item | Read a customs item by object_id: description, quantity, weight, value, origin and tariff number |
shippo_create_customs_declaration | Create a customs declaration for an international shipment from customs items |
shippo_get_customs_declaration | Read a customs declaration by object_id, with its items, contents type, incoterm and signer |
shippo_list_customs_declarations | List customs declarations, newest first, with contents type, items and certification details |
shippo_request_refund | Void a purchased label and ask for its price back |
shippo_list_refunds | List label refunds with their status (QUEUED, PENDING, SUCCESS, ERROR) and the label they belong to |
shippo_get_refund | Read one label refund by object_id: status, label (transaction) and dates |
shippo_create_manifest | Create a manifest (scan form) for a carrier pickup: one document listing the labels of one carrier account, ship date and origin address |
shippo_list_manifests | List manifests (scan forms), newest first, with carrier account, ship date, status and documents |
shippo_get_manifest | Read one manifest (scan form) with its status, the labels on it, document URLs and errors |
Примеры запросов
- «Сравните тарифы 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
Для какого 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
Это руководство помогло?