Packy Tracking MCP

officiel

Suivi de colis multi-transporteurs

GitHubEssayer ce MCPSponsorisé

Que pouvez-vous faire avec Packy Tracking MCP ?

Créer des suivis — Demandez l'enregistrement d'un nouvel envoi via trackings_create, y compris les numéros de suivi par lot, pour commencer à surveiller les livraisons.
Lister et inspecter les suivis — Utilisez trackings_list et trackings_get pour afficher tous les envois ou récupérer les détails d'un ID de suivi spécifique.
Gérer les webhooks — Créez, mettez à jour, listez ou supprimez des points de terminaison webhook avec webhooks_create, webhooks_update, webhooks_list et webhooks_delete pour les notifications d'événements de livraison.
Détecter les transporteurs — Utilisez courier_detections_create pour identifier le transporteur d'un numéro de suivi avant de créer un enregistrement de suivi complet.
Lister les transporteurs pris en charge — Interrogez couriers_list pour voir quels transporteurs de livraison sont disponibles via l'API Packy Tracking.

Documentation

Packy Tracking MCP

Packy Tracking MCP connecte des clients IA compatibles à l'API Packy Tracking via le Model Context Protocol (MCP).

Ce dépôt contient la documentation publique d'intégration et des exemples de configuration. L'implémentation MCP elle-même est un service hébergé ; aucune installation de serveur local n'est requise.

Le serveur MCP agit au nom du compte Packy connecté. Il ne fournit pas de permissions au-delà de celles disponibles pour la clé API sélectionnée lors de l'autorisation OAuth.

Point de terminaison

Point de terminaison MCP de production :

https://mcp.parceltracking.app/mcp

Authentification

OAuth est la méthode d'authentification recommandée. Le client ouvre la page d'autorisation Packy, où vous vous connectez et sélectionnez une clé API active. Après avoir approuvé l'accès, l'application MCP est connectée à cette clé.

Les permissions OAuth sont vérifiées par le serveur MCP et ne sont pas transmises à l'API produit. Les requêtes produit sont effectuées avec la clé API du compte sélectionné.

Modèle d'accès

Lors du consentement OAuth, l'utilisateur sélectionne une clé API active appartenant au compte Packy actuel.
L'application MCP est liée à cette clé sélectionnée après avoir cliqué sur Autoriser.
Plusieurs applications MCP peuvent être liées à la même clé API ; chaque application possède sa propre autorisation OAuth.
Déconnecter une application révoque uniquement l'accès OAuth de cette application et ne désactive pas la clé API ni n'affecte les autres applications.
Le serveur MCP valide l'autorisation OAuth et le statut de la clé avant de transmettre une action à l'API Packy.

OAuth avec Claude

Avant de vous connecter, connectez-vous à https://lk.parceltracking.app, créez une clé API et assurez-vous qu'elle est active.

Ouvrez les paramètres Claude → Connecteurs → Ajouter un connecteur personnalisé.
Saisissez le point de terminaison MCP :
```
https://mcp.parceltracking.app/mcp
```
Gardez l'authentification OAuth activée et autorisez Claude à enregistrer un client automatiquement.
Connectez-vous à Packy dans le navigateur. Une courte page Continuer l'autorisation redirige automatiquement ; il n'y a rien à cliquer. Le lien est à usage unique et expire après deux minutes.
Sur Autoriser l'accès ?, sélectionnez la clé API active que cette connexion utilisera et choisissez Autoriser.
Revenez à Claude et confirmez que le connecteur est connecté.

Les jetons d'accès OAuth sont de courte durée et sont renouvelés automatiquement. Si le flux échoue, démarrez une nouvelle tentative de connexion depuis Claude au lieu de rouvrir l'URL d'autorisation précédente.

OAuth avec Codex

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

Ouvrez l'URL d'autorisation affichée par Codex, connectez-vous à Packy, sélectionnez une clé API active et choisissez Autoriser.

Cursor avec une clé API

La configuration Cursor documentée utilise une clé API. Ajoutez l'URL du serveur et l'en-tête Authorization: Bearer <YOUR_API_KEY> dans le projet ou l'utilisateur mcp.json de Cursor, puis redémarrez MCP/l'agent. Voir examples/cursor/mcp.json.

Repli sur la clé API

Les clients qui ne prennent pas en charge MCP OAuth peuvent utiliser directement une clé API Packy. La clé API est la même que celle utilisée avec l'API Packy Tracking standard.

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

Remplacez <YOUR_API_KEY> par une clé active du compte Packy. Ne publiez et ne partagez jamais la clé.

Le serveur accepte également l'en-tête équivalent :

X-API-Key: <YOUR_API_KEY>

Le flux OAuth est recommandé car la clé est sélectionnée dans Packy et n'est pas copiée dans la configuration du client.

Outils

Outil	Opération de l'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}`

Les opérations qui modifient les données stockées sont trackings_create, trackings_delete, webhooks_create, webhooks_update et webhooks_delete. Exécutez-les uniquement lorsque vous avez explicitement l'intention de modifier les données du compte.

Seul trackings_create consomme des crédits : un crédit par numéro de suivi unique, y compris chaque numéro de suivi dans un lot. Les outils de transporteur, de détection, de lecture, de suppression et de webhook ne consomment pas de crédits. MCP n'est pas facturé séparément de l'API Tracking.

Déconnexion et révocation

Pour arrêter une application MCP :

Connectez-vous au compte Packy à https://lk.parceltracking.app.
Ouvrez Applications connectées.
Sélectionnez l'application et choisissez Déconnecter / Révoquer.

Révoquer une application arrête les nouvelles requêtes de cette connexion OAuth. Cela ne désactive pas la clé API elle-même, et les autres applications connectées à la même clé restent indépendantes.

Vous pouvez également désactiver ou remplacer la clé API dans la section Clés API. Cela affecte toutes les intégrations utilisant cette clé, y compris les applications MCP.

Vérifier le service

Ces points de terminaison publics de disponibilité ne nécessitent pas de clé API :

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

Réponses attendues :

{"status":"ok"}

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

/ready confirme également que le service MCP peut atteindre sa passerelle API.

Dépannage

Si aucun outil n'apparaît, vérifiez le point de terminaison, utilisez le nom de serveur packy-tracking-mcp et redémarrez le client.
Si OAuth ne se termine pas, connectez-vous au compte Packy prévu, confirmez qu'il possède une clé API active et démarrez une nouvelle tentative de connexion.
Si l'accès est refusé, vérifiez que la clé sélectionnée est active et appartient au compte prévu.
Si l'accès doit être arrêté immédiatement, déconnectez l'application dans Applications connectées ou désactivez la clé API.

Liens

Site Web Packy : https://packyapp.com
Compte Packy : https://lk.parceltracking.app
Point de terminaison MCP : https://mcp.parceltracking.app/mcp

Support

Pour les demandes de compte et d'assistance, envoyez un e-mail à wasup@clickor.net.

Pour les questions techniques sur l'API Tracking et l'intégration MCP, rejoignez la Communauté des développeurs Packy sur Discord. Toutes les options de contact officielles sont disponibles à https://packyapp.com/contacts.

Portée du dépôt

Ce dépôt contient uniquement la documentation d'intégration. Il ne contient pas le code source de l'API Packy, les identifiants, les clés API, les jetons OAuth ou la configuration de déploiement.