Packy Tracking MCP

oficial

Rastreamento de pacotes multi-transportadora

GitHubExperimente este MCPPatrocinado

O que você pode fazer com Packy Tracking MCP?

Criar rastreamentos — Solicite o registro de um novo envio via trackings_create, incluindo números de rastreamento em lote, para começar a monitorar as entregas.
Listar e inspecionar rastreamentos — Use trackings_list e trackings_get para visualizar todos os envios ou buscar detalhes de um ID de rastreamento específico.
Gerenciar webhooks — Crie, atualize, liste ou exclua endpoints de webhook com webhooks_create, webhooks_update, webhooks_list e webhooks_delete para notificações de eventos de entrega.
Detectar transportadoras — Use courier_detections_create para identificar a transportadora de um número de rastreamento antes de criar um registro completo de rastreamento.
Listar transportadoras suportadas — Consulte couriers_list para ver quais transportadoras de entrega estão disponíveis através da API Packy Tracking.

Documentação

Packy Tracking MCP

O Packy Tracking MCP conecta clientes de IA compatíveis à API Packy Tracking por meio do Model Context Protocol (MCP).

Este repositório contém documentação pública de integração e exemplos de configuração. A implementação do MCP em si é um serviço hospedado; nenhuma instalação local de servidor é necessária.

O servidor MCP atua em nome da conta Packy conectada. Ele não fornece permissões além daquelas disponíveis para a chave de API selecionada durante a autorização OAuth.

Endpoint

Endpoint MCP de produção:

https://mcp.parceltracking.app/mcp

Autenticação

OAuth é o método de autenticação recomendado. O cliente abre a página de autorização do Packy, onde você faz login e seleciona uma chave de API ativa. Após aprovar o acesso, o aplicativo MCP é conectado a essa chave.

As permissões OAuth são verificadas pelo servidor MCP e não são encaminhadas para a API do produto. As solicitações de produto são feitas com a chave de API da conta selecionada.

Modelo de acesso

Durante o consentimento OAuth, o usuário seleciona uma chave de API ativa pertencente à conta Packy atual.
O aplicativo MCP é vinculado a essa chave selecionada após Permitir.
Vários aplicativos MCP podem ser vinculados à mesma chave de API; cada aplicativo tem sua própria autorização OAuth.
Desconectar um aplicativo revoga apenas o acesso OAuth desse aplicativo e não desativa a chave de API nem afeta outros aplicativos.
O servidor MCP valida a autorização OAuth e o status da chave antes de encaminhar uma ação para a API Packy.

OAuth com Claude

Antes de conectar, faça login em https://lk.parceltracking.app, crie uma chave de API e certifique-se de que ela esteja ativa.

Abra Configurações do Claude → Conectores → Adicionar conector personalizado.
Insira o endpoint MCP:
```
https://mcp.parceltracking.app/mcp
```
Mantenha a autenticação OAuth habilitada e permita que o Claude registre um cliente automaticamente.
Faça login no Packy no navegador. Uma página curta de Continuar autorização redireciona automaticamente; não há nada para clicar. O link é de uso único e expira após dois minutos.
Em Permitir acesso?, selecione a chave de API ativa que esta conexão usará e escolha Permitir.
Retorne ao Claude e confirme que o conector está conectado.

Os tokens de acesso OAuth são de curta duração e renovados automaticamente. Se o fluxo falhar, inicie uma nova tentativa de conexão pelo Claude em vez de reabrir o URL de autorização anterior.

OAuth com Codex

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

Abra o URL de autorização impresso pelo Codex, faça login no Packy, selecione uma chave de API ativa e escolha Permitir.

Cursor com uma chave de API

A configuração documentada do Cursor usa uma chave de API. Adicione o URL do servidor e o cabeçalho Authorization: Bearer <YOUR_API_KEY> nas mcp.json do projeto ou do usuário no Cursor e reinicie o MCP/o agente. Consulte examples/cursor/mcp.json.

Fallback de chave de API

Clientes que não suportam MCP OAuth podem usar uma chave de API Packy diretamente. A chave de API é a mesma usada com a API Packy Tracking regular.

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

Substitua <YOUR_API_KEY> por uma chave ativa da conta Packy. Nunca publique ou compartilhe a chave.

O servidor também aceita o cabeçalho equivalente:

X-API-Key: <YOUR_API_KEY>

O fluxo OAuth é recomendado porque a chave é selecionada no Packy e não é copiada para a configuração do cliente.

Ferramentas

Ferramenta	Operação da API Tracking
`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}`

Operações que alteram dados armazenados são trackings_create, trackings_delete, webhooks_create, webhooks_update e webhooks_delete. Execute-as somente quando você pretender explicitamente modificar dados da conta.

Apenas trackings_create consome créditos: um crédito por número de rastreamento único, incluindo cada número de rastreamento em um lote. As ferramentas de transportadora, detecção, leitura, exclusão e webhook não consomem créditos. O MCP não é cobrado separadamente da API Tracking.

Desconexão e revogação

Para interromper um aplicativo MCP:

Faça login na conta Packy em https://lk.parceltracking.app.
Abra Aplicativos conectados.
Selecione o aplicativo e escolha Desconectar / Revogar.

Revogar um aplicativo interrompe novas solicitações dessa conexão OAuth. Isso não desativa a chave de API em si, e outros aplicativos conectados à mesma chave permanecem independentes.

Você também pode desativar ou substituir a chave de API na seção Chaves de API. Isso afeta todas as integrações que usam essa chave, incluindo aplicativos MCP.

Verificar o serviço

Estes endpoints públicos de liveness não exigem chave de API:

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

Respostas esperadas:

{"status":"ok"}

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

/ready também confirma que o serviço MCP pode alcançar seu gateway de API.

Solução de problemas

Se nenhuma ferramenta aparecer, verifique o endpoint, use o nome do servidor packy-tracking-mcp e reinicie o cliente.
Se o OAuth não for concluído, faça login na conta Packy pretendida, confirme que ela tem uma chave de API ativa e inicie uma nova tentativa de conexão.
Se o acesso for negado, verifique se a chave selecionada está ativa e pertence à conta pretendida.
Se o acesso precisar ser interrompido imediatamente, desconecte o aplicativo em Aplicativos conectados ou desative a chave de API.

Suporte

Para solicitações de conta e suporte, envie um e-mail para wasup@clickor.net.

Para perguntas técnicas sobre a API Tracking e integração MCP, participe da Comunidade de Desenvolvedores Packy no Discord. Todas as opções oficiais de contato estão disponíveis em https://packyapp.com/contacts.

Escopo do repositório

Este repositório contém apenas documentação de integração. Ele não contém código-fonte da API Packy, credenciais, chaves de API, tokens OAuth ou configuração de implantação.

Packy Tracking MCP

O que você pode fazer com Packy Tracking MCP?

Documentação

Packy Tracking MCP

Endpoint

Autenticação

Modelo de acesso

OAuth com Claude

OAuth com Codex

Cursor com uma chave de API

Fallback de chave de API

Ferramentas

Desconexão e revogação

Verificar o serviço

Solução de problemas

Links

Suporte

Escopo do repositório