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

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

YunExpress + Gemini

OMS API YunExpress (云途物流): страны назначения, способы доставки и типы товаров, расчёт стоимости, заказы на отправку с трек-номерами, этикетки, перевозчики последней мили, события трекинга и начисленные сборы, изменение веса и перехват посылок. Удаление заказов при установке выключено.

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

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

YUNEXPRESS_API_TOKEN

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

Настройка занимает около 5 минут. Нужен клиентский аккаунт YunExpress с доступом к API.

1. Войдите в клиентский центр YunExpress (www.yunexpress.cn или ваш клиентский портал YunExpress) и откройте раздел API. Запишите код клиента (客户编号, например C12345) и API secret (API密钥); если ключа ещё нет, запросите его там.
2. YunExpress проверяет Authorization: Basic <token>, где токен это Base64 от кода клиента, амперсанда и API secret (именно &, а не двоеточие). Вычислите его один раз на своём компьютере, например printf '%s' 'C12345&YourApiSecret' | base64, и вставьте в YUNEXPRESS_API_TOKEN только результат. Он хранится в зашифрованном виде.
3. Установите коннектор и запустите yunexpress_list_countries: он вернёт страны назначения и подтвердит токен.

Какой API: коннектор работает с OMS API YunExpress (версия 1.4.x) на http://oms.api.yunexpress.com. Этот хост отвечает только по обычному HTTP. У YunExpress есть и более новая open platform (openapi.yunexpress.cn), которая подписывает каждый запрос меткой времени и токеном OAuth; этот коннектор её не использует.

Что он читает: страны назначения с двухбуквенными кодами; способы доставки (логистические продукты) вашего аккаунта с кодом, китайским и английским названием и признаком отслеживания, при желании только для одной страны; типы товаров, например обычные товары или товары с батареями; расчёт стоимости по каждому способу с базовым тарифом, сбором за регистрацию, топливным и прочими сборами, итогом, валютой, оплачиваемым весом и сроком доставки (yunexpress_get_price_quote, с почтовым индексом для надбавок за удалённые районы); заказы на отправку с номером накладной, номером заказа клиента, трек-номером, способом, статусом, весами, получателем, таможенными позициями и сборами; адрес отправителя заказа; трекинг с состоянием посылки, статусом отслеживания, перевозчиком последней мили, подтверждением доставки и событиями (yunexpress_get_tracking учитывает ваши настройки отображения, yunexpress_get_full_tracking отдаёт всю историю, если способ это поддерживает); перевозчика последней мили и его номер; фактически начисленные сборы после того, как YunExpress взвесил посылку и выставил счёт.

Отправить посылку: ИИ проверяет способы доставки для страны и тип товара, запрашивает расчёт, затем вызывает yunexpress_create_orders с 1–10 заказами за вызов. Каждый результат содержит Success, WayBillNumber, TrackingNumber и TrackType (1 трек-номер есть, 2 ожидается, 3 нет). Если трек-номер ещё ожидается, yunexpress_get_tracking_numbers получит его позже по номеру заказа клиента (результаты кешируются на 30 минут). yunexpress_get_labels возвращает этикетки до 50 заказов как временную ссылку на PDF.

Что он записывает: yunexpress_create_orders оформляет реальные отправления, yunexpress_update_weight меняет заявленный вес до взвешивания в YunExpress, а yunexpress_intercept_order просит YunExpress остановить посылку с указанием причины. Перед каждой записью ИИ показывает заказы (получатель, способ, вес, таможенная декларация) и ждёт вашего «да». После неясного тайм-аута он сначала читает заказ через yunexpress_get_order и только потом повторяет попытку, чтобы ничего не оформить дважды.

Выключено при установке: yunexpress_delete_order, который удаляет заказ, ещё не полученный YunExpress, без возможности отмены. Администратор включает его, когда это нужно команде.

Числа и единицы: вес в кг (до 3 знаков после запятой), размеры в целых сантиметрах, объявленная стоимость (UnitPrice) за единицу в указанной CurrencyCode. OrderNumber принимает номер накладной, номер заказа клиента или трек-номер; при перехвате и удалении OrderType указывает, что это (1 накладная, 2 заказ клиента, 3 трек-номер). Состояния посылки: 0 неизвестно, 1 передано, 2 в пути, 3 доставлено, 4 принято, 5 отменено, 6 доставка не удалась, 7 возвращено. Статус отслеживания: 0 не найдено, 10 предуведомление, 20 в пути, 30 готово к выдаче, 40 неудача, 50 доставлено, 60 исключение, 80 неизвестно, 90 возвращено, 100 отменено.

Лимиты: постраничной выдачи нет; списки приходят одним ответом. За вызов можно создать 10 заказов и получить 50 этикеток. Если YunExpress отвечает кодом 10000, лимит запросов исчерпан: подождите немного.

Частые ошибки: в каждом ответе есть Code (0000 означает успех), Message, данные в Item или Items и RequestId для поддержки YunExpress. HTTP 421 с ResultCode 401 или коды 1002 и 1003 означают неверный токен: вычислите его заново из кода клиента и секрета через &. 1004 это ошибка параметра, 1006 нет данных, 1011 частичный успех, 2004 дублирующийся номер заказа клиента, 2005 заказ уже существует, 2006 у этого способа нет трек-номера, 2009 вес не положительный, 2010 способ не обслуживает направление, 9999 ошибка платформы.

Коннектор не использует open platform YunExpress и не управляет аккаунтом, счетами или платежами: из данных о стоимости он читает только расчёты и сборы, начисленные по накладной.

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

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

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

• «Какие способы доставки YunExpress работают в Германию и какие из них с отслеживанием?»
• «Рассчитай посылку 0,35 кг и 20 x 15 x 5 см с батареей во Францию: по каждому способу итог и срок доставки.»
• «Создай заказ YunExpress для SO-1042 на Anna Muster в Берлине способом THPHR. Сначала покажи получателя, вес и таможенные позиции.»
• «Где посылка с трек-номером YT2430012345678901 и кто доставляет её на последней миле?»
• «Получи этикетки сегодняшних заказов с SO-1040 по SO-1045 одним PDF.»

FAQ

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

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

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