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

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

EasyPost + Cursor

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

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

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

EASYPOST_API_KEY

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

1. Создайте бесплатный аккаунт EasyPost по адресу https://app.easypost.com/signup. Прежде чем показать API-ключи, EasyPost попросит настроить кошелёк (wallet) и адрес отправителя, а новому аккаунту, возможно, сначала придётся пройти короткую проверку безопасности с данными компании. Ключи появятся, когда EasyPost её одобрит.
2. Откройте страницу API-ключей https://app.easypost.com/account/settings?tab=api-keys (Account settings → API keys). Скопируйте ключ Test (бесплатный, этикетки недействительны) или ключ Production (покупает настоящие этикетки).
3. Вставьте его в EASYPOST_API_KEY и установите коннектор.
4. Запустите easypost_list_addresses, чтобы проверить ключ. В новом аккаунте список может быть пустым.

Тест или рабочий режим: это определяет ключ. С тестовым ключом этикетки ничего не стоят и недействительны, а отслеживание принимает только тестовые коды EasyPost от EZ1000000001 до EZ7000000007, каждый из которых соответствует одному статусу (ещё не отправлено, доставлено, возвращено отправителю и т. д.). Для списка подключённых аккаунтов перевозчиков (easypost_list_carrier_accounts) нужен рабочий ключ.

Покупка стоит денег, поэтому сначала подтверждение: с рабочим ключом easypost_buy_shipment и easypost_insure_shipment сразу списывают деньги с кошелька EasyPost. Перед покупкой ИИ называет перевозчика, услугу, цену и оба адреса и ждёт вашего согласия. Страховка, добавленная после покупки, стоит 1 процент от страховой суммы, минимум 1 USD. easypost_refund_shipment аннулирует неиспользованную этикетку, после чего её нельзя использовать; возврат денег занимает от нескольких дней до нескольких недель (этикетки USPS можно вернуть в течение 30 дней, UPS и FedEx в течение 90 дней).

Как проходит отправка: easypost_create_shipment получает получателя, адрес отправителя и посылку и возвращает актуальные тарифы ваших перевозчиков с ценой и сроком доставки. Вы выбираете тариф вместе с ИИ, он покупает этикетку через easypost_buy_shipment и получает ссылку на этикетку (PNG, а через easypost_convert_label также PDF и ZPL), трек-номер и публичную страницу отслеживания. Следите за посылкой через easypost_get_tracker или начните отслеживать любой трек-номер, в том числе для этикеток, купленных в другом месте, через easypost_create_tracker. ИИ также проверяет адреса и создаёт scan forms, чтобы перевозчик при заборе сканировал один лист.

Единицы и международные отправки: вес в унциях, размеры в дюймах (1 кг = 35,27 oz, 1 см = 0,394 in), суммы в USD, если валюта не указана. Для международной отправки ИИ сначала создаёт таможенные позиции и таможенную декларацию и прикрепляет её к отправке.

Частые ошибки: 401 UNAUTHORIZED или 403 APIKEY.INACTIVE: ключ отсутствует, неверен или отключён. 403 MODE.UNAUTHORIZED: для вызова нужен рабочий ключ. 402 PAYMENT_REQUIRED: на кошельке нет средств. Ошибки 422, например ADDRESS.VERIFY.FAILURE, SHIPMENT.POSTAGE.FAILURE или SHIPMENT.CUSTOMS_INFO.REQUIRED, называют проблему с адресом, покупкой или недостающими таможенными данными. 429: слишком много запросов, подождите и повторите.

Коннектор не работает с забором посылок, заказами, возвратами, вебхуками, пользователями и API-ключами, отчётами и подключением аккаунтов перевозчиков.

Шаг 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. Начинай общаться: агент теперь может вызывать инструменты EasyPost.

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

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

• «Сравните тарифы для посылки весом 3 lb и размером 12 x 10 x 6 дюймов с нашего склада по этому адресу в Чикаго и покажите самый дешёвый и самый быстрый вариант.»
• «Где посылка с трек-номером 1Z999AA10123456784 и когда она должна прибыть?»
• «Проверьте этот адрес клиента и скажите, нужно ли что-то исправить перед отправкой.»
• «Купите этикетку для этой отправки по самому дешёвому тарифу USPS, но перед покупкой покажите перевозчика, услугу, цену и оба адреса.»

FAQ

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

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

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