Packy Tracking MCP

официальный

Отслеживание посылок нескольких перевозчиков

GitHub

Что можно делать с Packy Tracking MCP?

Создание трекингов — Запросите регистрацию новой отправки через trackings_create, включая пакетные номера отслеживания, чтобы начать мониторинг посылок.
Список и получение трекингов — Используйте trackings_list и trackings_get, чтобы просмотреть все отправления или получить детали для конкретного идентификатора трекинга.
Управление вебхуками — Создавайте, обновляйте, просматривайте или удаляйте конечные точки вебхуков с помощью webhooks_create, webhooks_update, webhooks_list и webhooks_delete для уведомлений о событиях.
Список поддерживаемых курьеров — Запросите couriers_list, чтобы увидеть доступных перевозчиков для вашей учетной записи.
Автоматическое определение курьеров — Используйте courier_detections_create, чтобы определить перевозчика по номеру отслеживания.
Удаление трекингов — Удалите ненужные записи об отправлениях через trackings_delete, чтобы очистить список отслеживания.

Документация

Packy Tracking MCP

Packy Tracking MCP подключает совместимые AI-клиенты к API Packy Tracking через протокол Model Context Protocol (MCP).

Этот репозиторий содержит публичную документацию по интеграции и примеры конфигурации. Сама реализация MCP — это размещённый сервис; локальная установка сервера не требуется.

MCP-сервер действует от имени подключённого аккаунта Packy. Он не предоставляет прав, выходящих за пределы возможностей API-ключа, выбранного при авторизации OAuth.

Конечная точка

Продакшн-конечная точка MCP:

https://mcp.parceltracking.app/mcp

Аутентификация

OAuth — рекомендуемый метод аутентификации. Клиент открывает страницу авторизации Packy, где вы входите в систему и выбираете активный API-ключ. После одобрения доступа MCP-приложение подключается к этому ключу.

Права OAuth проверяются MCP-сервером и не передаются в продуктовый API. Запросы к продукту выполняются с выбранным API-ключом аккаунта.

Модель доступа

Во время согласия OAuth пользователь выбирает один активный API-ключ, принадлежащий текущему аккаунту Packy.
MCP-приложение привязывается к выбранному ключу после нажатия Allow.
Несколько MCP-приложений могут быть привязаны к одному API-ключу; каждое приложение имеет собственную авторизацию OAuth.
Отключение одного приложения отзывает только доступ OAuth этого приложения и не деактивирует API-ключ и не влияет на другие приложения.
MCP-сервер проверяет авторизацию OAuth и статус ключа перед передачей действия в API Packy.

OAuth с Claude

Перед подключением войдите в https://lk.parceltracking.app, создайте API-ключ и убедитесь, что он активен.

Откройте Claude Settings → Connectors → Add custom connector.
Введите конечную точку MCP:
```
https://mcp.parceltracking.app/mcp
```
Оставьте аутентификацию OAuth включённой и разрешите Claude автоматически зарегистрировать клиент.
Войдите в Packy в браузере. Короткая страница Continue authorization перенаправляет автоматически; нажимать ничего не нужно. Ссылка одноразовая и истекает через две минуты.
На странице Allow access? выберите активный API-ключ, который будет использовать это подключение, и нажмите Allow.
Вернитесь в Claude и подтвердите, что коннектор подключён.

Токены доступа OAuth краткосрочные и обновляются автоматически. Если процесс завершился сбоем, начните новую попытку подключения из Claude, а не открывайте предыдущий URL авторизации.

OAuth с Codex

codex mcp add packy-tracking-mcp \
  --url https://mcp.parceltracking.app/mcp \
  --oauth-resource https://mcp.parceltracking.app/mcp

Откройте URL авторизации, выведенный Codex, войдите в Packy, выберите активный API-ключ и нажмите Allow.

Cursor с API-ключом

Документированная настройка Cursor использует API-ключ. Добавьте URL сервера и заголовок Authorization: Bearer <YOUR_API_KEY> в проект или пользовательский mcp.json в Cursor, затем перезапустите MCP/агента. См. examples/cursor/mcp.json.

Запасной вариант с API-ключом

Клиенты, не поддерживающие MCP OAuth, могут использовать API-ключ Packy напрямую. API-ключ — это тот же ключ, который используется с обычным API Packy Tracking.

{
  "mcpServers": {
    "packy-tracking-mcp": {
      "url": "https://mcp.parceltracking.app/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

Замените <YOUR_API_KEY> на активный ключ из аккаунта Packy. Никогда не публикуйте и не передавайте ключ.

Сервер также принимает эквивалентный заголовок:

X-API-Key: <YOUR_API_KEY>

Рекомендуется использовать поток OAuth, поскольку ключ выбирается в Packy и не копируется в конфигурацию клиента.

Инструменты

Инструмент	Операция API отслеживания
`trackings_create`	`POST /v1/trackings`
`trackings_list`	`GET /v1/trackings`
`trackings_get`	`GET /v1/trackings/{id}`
`trackings_delete`	`DELETE /v1/trackings/{id}`
`couriers_list`	`GET /v1/couriers`
`courier_detections_create`	`POST /v1/courier-detections`
`webhooks_list`	`GET /v1/webhooks`
`webhooks_create`	`POST /v1/webhooks`
`webhooks_update`	`PATCH /v1/webhooks/{id}`
`webhooks_delete`	`DELETE /v1/webhooks/{id}`

Операции, изменяющие сохранённые данные: trackings_create, trackings_delete, webhooks_create, webhooks_update и webhooks_delete. Запускайте их только тогда, когда явно намерены изменить данные аккаунта.

Только trackings_create расходует кредиты: один кредит за уникальный номер отслеживания, включая каждый номер в пакете. Инструменты курьера, обнаружения, чтения, удаления и вебхуков не расходуют кредиты. MCP не тарифицируется отдельно от API отслеживания.

Отключение и отзыв доступа

Чтобы остановить одно MCP-приложение:

Войдите в аккаунт Packy на https://lk.parceltracking.app.
Откройте Connected applications.
Выберите приложение и нажмите Disconnect / Revoke.

Отзыв приложения останавливает новые запросы от этого OAuth-подключения. Это не деактивирует сам API-ключ, и другие приложения, подключённые к тому же ключу, остаются независимыми.

Вы также можете деактивировать или заменить API-ключ в разделе API keys. Это повлияет на все интеграции, использующие этот ключ, включая MCP-приложения.

Проверка сервиса

Эти публичные конечные точки проверки доступности не требуют API-ключа:

curl -fsS https://mcp.parceltracking.app/health
curl -fsS https://mcp.parceltracking.app/ready

Ожидаемые ответы:

{"status":"ok"}

{"status":"ok","checks":{"api_gateway":"healthy"}}

/ready также подтверждает, что MCP-сервис может связаться со своим API-шлюзом.

Устранение неполадок

Если инструменты не отображаются, проверьте конечную точку, используйте имя сервера packy-tracking-mcp и перезапустите клиент.
Если OAuth не завершается, войдите в нужный аккаунт Packy, убедитесь, что у него есть активный API-ключ, и начните новую попытку подключения.
Если доступ отклонён, проверьте, что выбранный ключ активен и принадлежит нужному аккаунту.
Если доступ нужно немедленно остановить, отключите приложение в Connected applications или деактивируйте API-ключ.

Ссылки

Веб-сайт Packy: https://packyapp.com
Аккаунт Packy: https://lk.parceltracking.app
Конечная точка MCP: https://mcp.parceltracking.app/mcp

Поддержка

По вопросам аккаунта и поддержки пишите на wasup@clickor.net.

По техническим вопросам об API отслеживания и интеграции MCP присоединяйтесь к сообществу разработчиков Packy в Discord. Все официальные контактные варианты доступны на https://packyapp.com/contacts.

Область репозитория

Этот репозиторий содержит только документацию по интеграции. Он не содержит исходный код API Packy, учётные данные, API-ключи, OAuth-токены или конфигурацию развёртывания.