Packy Tracking MCP

Packy Tracking MCP

Packy Tracking MCP verbindet kompatible KI-Clients über das Model Context Protocol (MCP) mit der Packy Tracking API.

Dieses Repository enthält öffentliche Integrationsdokumentation und Konfigurationsbeispiele. Die MCP-Implementierung selbst ist ein gehosteter Dienst; es ist keine lokale Serverinstallation erforderlich.

Der MCP-Server handelt im Namen des verbundenen Packy-Kontos. Er gewährt keine Berechtigungen über die hinaus, die dem während der OAuth-Autorisierung ausgewählten API-Schlüssel zur Verfügung stehen.

Endpunkt

Produktions-MCP-Endpunkt:

https://mcp.parceltracking.app/mcp

Authentifizierung

OAuth ist die empfohlene Authentifizierungsmethode. Der Client öffnet die Packy-Autorisierungsseite, auf der Sie sich anmelden und einen aktiven API-Schlüssel auswählen. Nachdem Sie den Zugriff genehmigt haben, wird die MCP-Anwendung mit diesem Schlüssel verbunden.

OAuth-Berechtigungen werden vom MCP-Server überprüft und nicht an die Produkt-API weitergeleitet. Produktanfragen werden mit dem ausgewählten Konto-API-Schlüssel durchgeführt.

Zugriffsmodell

• Während der OAuth-Einwilligung wählt der Benutzer einen aktiven API-Schlüssel aus, der zum aktuellen Packy-Konto gehört.
• Die MCP-Anwendung wird nach Zulassen an den ausgewählten Schlüssel gebunden.
• Mehrere MCP-Anwendungen können an denselben API-Schlüssel gebunden werden; jede Anwendung hat ihre eigene OAuth-Autorisierung.
• Das Trennen einer Anwendung widerruft nur den OAuth-Zugriff dieser Anwendung und deaktiviert weder den API-Schlüssel noch wirkt es sich auf andere Anwendungen aus.
• Der MCP-Server validiert die OAuth-Autorisierung und den Schlüsselstatus, bevor er eine Aktion an die Packy-API weiterleitet.

OAuth mit Claude

Melden Sie sich vor dem Verbinden bei https://lk.parceltracking.app an, erstellen Sie einen API-Schlüssel und stellen Sie sicher, dass er aktiv ist.

1. Öffnen Sie Claude-Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen.

2. Geben Sie den MCP-Endpunkt ein:

   https://mcp.parceltracking.app/mcp
   

3. Lassen Sie die OAuth-Authentifizierung aktiviert und erlauben Sie Claude, einen Client automatisch zu registrieren.

4. Melden Sie sich im Browser bei Packy an. Eine kurze Autorisierung fortsetzen-Seite leitet automatisch weiter; es gibt nichts zu klicken. Der Link ist nur einmal verwendbar und läuft nach zwei Minuten ab.

5. Wählen Sie bei Zugriff erlauben? den aktiven API-Schlüssel aus, den diese Verbindung verwenden soll, und wählen Sie Zulassen.

6. Kehren Sie zu Claude zurück und bestätigen Sie, dass der Connector verbunden ist.

OAuth-Zugriffstokens sind kurzlebig und werden automatisch erneuert. Wenn der Ablauf fehlschlägt, starten Sie einen neuen Verbindungsversuch von Claude aus, anstatt die vorherige Autorisierungs-URL erneut zu öffnen.

OAuth mit Codex

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

Öffnen Sie die von Codex ausgegebene Autorisierungs-URL, melden Sie sich bei Packy an, wählen Sie einen aktiven API-Schlüssel und wählen Sie Zulassen.

Cursor mit einem API-Schlüssel

Die dokumentierte Cursor-Einrichtung verwendet einen API-Schlüssel. Fügen Sie die Server-URL und den Authorization: Bearer <YOUR_API_KEY>-Header in Cursors Projekt- oder Benutzer-mcp.json hinzu und starten Sie dann MCP/den Agenten neu. Siehe examples/cursor/mcp.json.

API-Schlüssel-Fallback

Clients, die MCP-OAuth nicht unterstützen, können direkt einen Packy-API-Schlüssel verwenden. Der API-Schlüssel ist derselbe Schlüssel, der auch mit der regulären Packy Tracking API verwendet wird.

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

Ersetzen Sie <YOUR_API_KEY> durch einen aktiven Schlüssel aus dem Packy-Konto. Veröffentlichen oder teilen Sie den Schlüssel niemals.

Der Server akzeptiert auch den entsprechenden Header:

X-API-Key: <YOUR_API_KEY>

Der OAuth-Ablauf wird empfohlen, da der Schlüssel in Packy ausgewählt und nicht in die Client-Konfiguration kopiert wird.

Tools

Tool	Tracking-API-Operation
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}

Operationen, die gespeicherte Daten ändern, sind trackings_create, trackings_delete, webhooks_create, webhooks_update und webhooks_delete. Führen Sie sie nur aus, wenn Sie ausdrücklich beabsichtigen, Kontodaten zu ändern.

Nur trackings_create verbraucht Credits: ein Credit pro eindeutiger Sendungsnummer, einschließlich jeder Sendungsnummer in einem Stapel. Kurier-, Erkennungs-, Lese-, Lösch- und Webhook-Tools verbrauchen keine Credits. MCP wird nicht separat von der Tracking-API abgerechnet.

Trennen und Widerruf

Um eine MCP-Anwendung zu stoppen:

1. Melden Sie sich beim Packy-Konto unter https://lk.parceltracking.app an.
2. Öffnen Sie Verbundene Anwendungen.
3. Wählen Sie die Anwendung aus und wählen Sie Trennen / Widerrufen.

Das Widerrufen einer Anwendung stoppt neue Anfragen von dieser OAuth-Verbindung. Es deaktiviert den API-Schlüssel selbst nicht, und andere Anwendungen, die mit demselben Schlüssel verbunden sind, bleiben unabhängig.

Sie können den API-Schlüssel auch im Abschnitt API-Schlüssel deaktivieren oder ersetzen. Dies wirkt sich auf jede Integration aus, die diesen Schlüssel verwendet, einschließlich MCP-Anwendungen.

Dienst überprüfen

Diese öffentlichen Liveness-Endpunkte erfordern keinen API-Schlüssel:

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

Erwartete Antworten:

{"status":"ok"}

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

/ready bestätigt auch, dass der MCP-Dienst sein API-Gateway erreichen kann.

Fehlerbehebung

• Wenn keine Tools angezeigt werden, überprüfen Sie den Endpunkt, verwenden Sie den Servernamen packy-tracking-mcp und starten Sie den Client neu.
• Wenn OAuth nicht abgeschlossen wird, melden Sie sich beim beabsichtigten Packy-Konto an, bestätigen Sie, dass es einen aktiven API-Schlüssel hat, und starten Sie einen neuen Verbindungsversuch.
• Wenn der Zugriff verweigert wird, überprüfen Sie, ob der ausgewählte Schlüssel aktiv ist und zum beabsichtigten Konto gehört.
• Wenn der Zugriff sofort gestoppt werden muss, trennen Sie die Anwendung unter Verbundene Anwendungen oder deaktivieren Sie den API-Schlüssel.

Links

• Packy-Website: https://packyapp.com
• Packy-Konto: https://lk.parceltracking.app
• MCP-Endpunkt: https://mcp.parceltracking.app/mcp

Support

Für Konto- und Supportanfragen senden Sie eine E-Mail an wasup@clickor.net.

Für technische Fragen zur Tracking-API und MCP-Integration treten Sie der Packy Developer Community auf Discord bei. Alle offiziellen Kontaktmöglichkeiten finden Sie unter https://packyapp.com/contacts.

Repository-Umfang

Dieses Repository enthält nur Integrationsdokumentation. Es enthält keinen Packy-API-Quellcode, keine Anmeldeinformationen, API-Schlüssel, OAuth-Tokens oder Bereitstellungskonfiguration.