Как подключить BEX Express к Cursor через MCP

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

BEX Express + Cursor

Курьерская служба BEX Express (Сербия) в AI-агенте: история статусов отправления по его номеру, адресные этикетки в PDF, адресный справочник BEX с общинами, населёнными пунктами и улицами, а также пункты выдачи и склады. Создание и отмена отправлений включены, но при установке отключены.

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

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

BEX_API_TOKEN

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

Настройка занимает около 5 минут, когда BEX уже прислал ключ. Нужны договор с BEX Express, сербской курьерской службой, и API-ключ, который BEX выдаёт под этот договор.

1. Если вы ещё не клиент BEX, запросите предложение по адресу [email protected]: API доступен только клиентам с договором.
2. Напишите на [email protected], запросите доступ к API и укажите договор, для которого он нужен.
3. BEX пришлёт API-ключ и ваш KlijentId. Вставьте ключ в BEX_API_TOKEN; он передаётся в заголовке X-AUTH-TOKEN. Сохраните KlijentId: он обозначает вашу компанию как отправителя.
4. Установите коннектор и запустите bex_express_list_municipalities. Если вернулся список общин, ключ работает.

Что он читает: историю статусов отправления по номеру BEX (тому, что напечатан на этикетке) с каждым сканированием, статусом, датой, местом и следующим ожидаемым событием; адресные этикетки отправления в PDF; адресный справочник BEX с общинами (opštine), населёнными пунктами (mesta) с индексом и улицами; а также около 120 пунктов выдачи и складов с кодом, адресом, часами работы и координатами.

Коды статусов: 1 зарегистрировано, 11 забрано у отправителя, 21 доставлено, 25 будет возвращено отправителю, 30 возвращено отправителю, -21 проверка адреса колл-центром, -51 на таможне. ИИ объяснит их простыми словами.

Этикетки: одна этикетка A6 на страницу или четыре этикетки на листе A4, для всех мест отправления или только для одного. PDF большой, поэтому ИИ запрашивает его только тогда, когда вы хотите напечатать или сохранить этикетку.

Адреса задаются через идентификаторы BEX: BEX описывает адрес общиной, населённым пунктом и улицей. ИИ ищет их по шагам, по одной общине или одному населённому пункту за раз. Коннектор никогда не запрашивает у BEX сразу все улицы Сербии (почти 100 000).

Два хоста и порт 62503: отслеживание, этикетки и адресный справочник работают через обычный HTTPS-порт, а список пунктов выдачи, создание и отмена отправлений идут через https://api.bex.rs:62503. Этот порт доступен из AnythingMCP Cloud; на собственном сервере за файрволом, который пропускает только порт 443, эти три инструмента не работают.

Отключено при установке: bex_express_create_shipments и bex_express_cancel_shipment. Они регистрируют реальные отправления для забора курьером или отменяют их, поэтому администратор включает их осознанно. Даже тогда ИИ сначала показывает отправление целиком (отправитель, получатель, места, наложенный платёж, страховка, кто платит) или номер отправления для отмены и ждёт вашего согласия. Отправление, которое курьер уже забрал, отменить нельзя.

Частые ошибки: 401 означает неверный или отсутствующий ключ. 403 означает, что ключ работает, но метод не подключён для вашего договора: обратитесь на [email protected]. Многие методы BEX отвечают HTTP 200, но с state false и причиной в err, поэтому ИИ проверяет эти поля, прежде чем сообщить результат. Исключение: список пунктов выдачи, где BEX присылает state false с текстом ok, даже если список полный.

Коннектор не работает со счетами и выплатами наложенного платежа и не создаёт и не отменяет отправления, пока администратор не включит эти инструменты.

Шаг 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 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты BEX Express.

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

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

• «Где сейчас отправление 206897445 и когда ожидается следующий шаг?»
• «Какие из этих отправлений вернулись отправителю: 206897445, 206897446 и 206897447?»
• «Какие пункты выдачи BEX есть в Нови-Саде и работают ли они по субботам?»
• «Подготовь этикетки отправления 206897445, по четыре на лист A4, я их распечатаю.»
• «Есть ли в справочнике BEX улица Bulevar oslobođenja в Нови-Саде? Дай идентификаторы населённого пункта и улицы для адреса отправления.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

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

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