Packy Tracking MCP

официальный

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

GitHubПопробовать этот MCPСпонсировано

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

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

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

Packy Tracking MCP

Packy Tracking MCP подключает совместимые AI-клиенты к Packy Tracking API через протокол 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.
К одному API-ключу может быть привязано несколько MCP-приложений; у каждого приложения своя авторизация OAuth.
Отключение одного приложения отзывает доступ OAuth только для этого приложения и не деактивирует API-ключ и не влияет на другие приложения.
MCP-сервер проверяет авторизацию OAuth и статус ключа перед передачей действия в Packy API.

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-ключ — это тот же ключ, что используется с обычным Packy Tracking API.

{
  "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 и не копируется в конфигурацию клиента.

Инструменты

Инструмент	Операция Tracking 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 не тарифицируется отдельно от Tracking 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.

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

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

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