Packy Tracking MCP

oficial

Seguimiento de paquetes con múltiples transportistas

¿Qué puedes hacer con Packy Tracking MCP?

Crear seguimientos — Solicita registrar un nuevo envío mediante trackings_create, incluidos números de seguimiento por lotes, para comenzar a monitorear las entregas.
Listar e inspeccionar seguimientos — Usa trackings_list y trackings_get para ver todos los envíos u obtener detalles de un ID de seguimiento específico.
Gestionar webhooks — Crea, actualiza, lista o elimina endpoints de webhook con webhooks_create, webhooks_update, webhooks_list y webhooks_delete para notificaciones de eventos de entrega.
Detectar mensajeros — Usa courier_detections_create para identificar el transportista de un número de seguimiento antes de crear un registro de seguimiento completo.
Listar mensajeros compatibles — Consulta couriers_list para ver qué transportistas de entrega están disponibles a través de la API de Packy Tracking.

Documentación

Packy Tracking MCP

Packy Tracking MCP conecta clientes de IA compatibles con la API de Packy Tracking a través del Protocolo de Contexto de Modelo (MCP).

Este repositorio contiene documentación pública de integración y ejemplos de configuración. La implementación de MCP en sí es un servicio alojado; no se requiere instalación local de servidor.

El servidor MCP actúa en nombre de la cuenta de Packy conectada. No proporciona permisos más allá de los disponibles para la clave de API seleccionada durante la autorización OAuth.

Endpoint

Endpoint de producción de MCP:

https://mcp.parceltracking.app/mcp

Autenticación

OAuth es el método de autenticación recomendado. El cliente abre la página de autorización de Packy, donde inicias sesión y seleccionas una clave de API activa. Después de que apruebes el acceso, la aplicación MCP se conecta a esa clave.

Los permisos de OAuth son verificados por el servidor MCP y no se reenvían a la API del producto. Las solicitudes de producto se realizan con la clave de API de la cuenta seleccionada.

Modelo de acceso

Durante el consentimiento OAuth, el usuario selecciona una clave de API activa perteneciente a la cuenta de Packy actual.
La aplicación MCP se vincula a esa clave seleccionada después de hacer clic en Permitir.
Varias aplicaciones MCP pueden vincularse a la misma clave de API; cada aplicación tiene su propia autorización OAuth.
Desconectar una aplicación revoca solo el acceso OAuth de esa aplicación y no desactiva la clave de API ni afecta a otras aplicaciones.
El servidor MCP valida la autorización OAuth y el estado de la clave antes de reenviar una acción a la API de Packy.

OAuth con Claude

Antes de conectarte, inicia sesión en https://lk.parceltracking.app, crea una clave de API y asegúrate de que esté activa.

Abre Configuración de Claude → Conectores → Agregar conector personalizado.
Ingresa el endpoint de MCP:
```
https://mcp.parceltracking.app/mcp
```
Mantén habilitada la autenticación OAuth y permite que Claude registre un cliente automáticamente.
Inicia sesión en Packy en el navegador. Una página breve de Continuar autorización se redirige automáticamente; no hay nada que hacer clic. El enlace es de un solo uso y caduca después de dos minutos.
En ¿Permitir acceso?, selecciona la clave de API activa que usará esta conexión y elige Permitir.
Regresa a Claude y confirma que el conector está conectado.

Los tokens de acceso OAuth son de corta duración y se actualizan automáticamente. Si el flujo falla, inicia un nuevo intento de conexión desde Claude en lugar de reabrir la URL de autorización anterior.

OAuth con Codex

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

Abre la URL de autorización impresa por Codex, inicia sesión en Packy, selecciona una clave de API activa y elige Permitir.

Cursor con una clave de API

La configuración documentada de Cursor usa una clave de API. Agrega la URL del servidor y el encabezado Authorization: Bearer <YOUR_API_KEY> en el mcp.json de proyecto o usuario de Cursor, luego reinicia MCP/el agente. Consulta examples/cursor/mcp.json.

Respaldo con clave de API

Los clientes que no admiten MCP OAuth pueden usar una clave de API de Packy directamente. La clave de API es la misma que se usa con la API regular de Packy Tracking.

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

Reemplaza <YOUR_API_KEY> con una clave activa de la cuenta de Packy. Nunca publiques ni compartas la clave.

El servidor también acepta el encabezado equivalente:

X-API-Key: <YOUR_API_KEY>

Se recomienda el flujo OAuth porque la clave se selecciona en Packy y no se copia en la configuración del cliente.

Herramientas

Herramienta	Operación de la API de 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}`

Las operaciones que modifican datos almacenados son trackings_create, trackings_delete, webhooks_create, webhooks_update y webhooks_delete. Ejecútalas solo cuando tengas la intención explícita de modificar datos de la cuenta.

Solo trackings_create consume créditos: un crédito por número de seguimiento único, incluido cada número de seguimiento en un lote. Las herramientas de mensajería, detección, lectura, eliminación y webhook no consumen créditos. MCP no se factura por separado de la API de Tracking.

Desconexión y revocación

Para detener una aplicación MCP:

Inicia sesión en la cuenta de Packy en https://lk.parceltracking.app.
Abre Aplicaciones conectadas.
Selecciona la aplicación y elige Desconectar / Revocar.

Revocar una aplicación detiene nuevas solicitudes desde esa conexión OAuth. No desactiva la clave de API en sí, y otras aplicaciones conectadas a la misma clave permanecen independientes.

También puedes desactivar o reemplazar la clave de API en la sección Claves de API. Esto afecta a todas las integraciones que usan esa clave, incluidas las aplicaciones MCP.

Verificar el servicio

Estos endpoints públicos de disponibilidad no requieren clave de API:

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

Respuestas esperadas:

{"status":"ok"}

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

/ready también confirma que el servicio MCP puede alcanzar su puerta de enlace de API.

Solución de problemas

Si no aparecen herramientas, verifica el endpoint, usa el nombre de servidor packy-tracking-mcp y reinicia el cliente.
Si OAuth no se completa, inicia sesión en la cuenta de Packy prevista, confirma que tiene una clave de API activa e inicia un nuevo intento de conexión.
Si se deniega el acceso, verifica que la clave seleccionada esté activa y pertenezca a la cuenta prevista.
Si el acceso debe detenerse de inmediato, desconecta la aplicación en Aplicaciones conectadas o desactiva la clave de API.

Enlaces

Sitio web de Packy: https://packyapp.com
Cuenta de Packy: https://lk.parceltracking.app
Endpoint de MCP: https://mcp.parceltracking.app/mcp

Soporte

Para solicitudes de cuenta y soporte, envía un correo a wasup@clickor.net.

Para preguntas técnicas sobre la API de Tracking y la integración MCP, únete a la Comunidad de Desarrolladores de Packy en Discord. Todas las opciones oficiales de contacto están disponibles en https://packyapp.com/contacts.

Alcance del repositorio

Este repositorio contiene solo documentación de integración. No contiene código fuente de la API de Packy, credenciales, claves de API, tokens OAuth ni configuración de implementación.