Packy Tracking MCP

resmi

Çoklu taşıyıcı paket takibi

GitHub

Packy Tracking MCP ile neler yapabilirsiniz?

Kargo takibi oluştur — trackings_create ile yeni bir gönderiyi kaydetmeyi isteyin; toplu takip numaraları dahil, paketleri izlemeye başlamak için.
Takip kayıtlarını listele ve getir — Tüm gönderileri görüntülemek veya belirli bir takip kimliği için ayrıntıları almak üzere trackings_list ve trackings_get kullanın.
Webhook’ları yönet — Etkinlik bildirimleri için webhooks_create, webhooks_update, webhooks_list ve webhooks_delete ile webhook uç noktaları oluşturun, güncelleyin, listeleyin veya silin.
Desteklenen kuryeleri listele — Hesabınız için mevcut kargo taşıyıcılarını görmek üzere couriers_list sorgulayın.
Kuryeleri otomatik algıla — Takip numarasından taşıyıcıyı belirlemek için courier_detections_create kullanın.
Takip kayıtlarını sil — Takip listenizi temizlemek için trackings_delete ile istenmeyen gönderi kayıtlarını kaldırın.

Dokümantasyon

Packy Tracking MCP

Packy Tracking MCP, uyumlu AI istemcilerini Model Context Protocol (MCP) aracılığıyla Packy Tracking API'sine bağlar.

Bu depo, genel entegrasyon belgelerini ve yapılandırma örneklerini içerir. MCP uygulamasının kendisi barındırılan bir hizmettir; yerel sunucu kurulumu gerekmez.

MCP sunucusu, bağlı Packy hesabı adına hareket eder. OAuth yetkilendirmesi sırasında seçilen API anahtarının sahip olduğu izinlerin ötesinde izin sağlamaz.

Uç Nokta

Üretim MCP uç noktası:

https://mcp.parceltracking.app/mcp

Kimlik Doğrulama

OAuth önerilen kimlik doğrulama yöntemidir. İstemci, Packy yetkilendirme sayfasını açar; burada oturum açarsınız ve etkin bir API anahtarı seçersiniz. Erişimi onayladıktan sonra MCP uygulaması bu anahtara bağlanır.

OAuth izinleri MCP sunucusu tarafından kontrol edilir ve ürün API'sine iletilmez. Ürün istekleri, seçilen hesap API anahtarıyla yapılır.

Erişim modeli

OAuth onayı sırasında kullanıcı, mevcut Packy hesabına ait etkin bir API anahtarı seçer.
MCP uygulaması, İzin Ver'den sonra seçilen anahtara bağlanır.
Aynı API anahtarına birden fazla MCP uygulaması bağlanabilir; her uygulamanın kendi OAuth yetkilendirmesi vardır.
Bir uygulamanın bağlantısını kesmek yalnızca o uygulamanın OAuth erişimini iptal eder ve API anahtarını devre dışı bırakmaz veya diğer uygulamaları etkilemez.
MCP sunucusu, Packy API'sine bir eylem iletmeden önce OAuth yetkilendirmesini ve anahtar durumunu doğrular.

Claude ile OAuth

Bağlanmadan önce https://lk.parceltracking.app adresine giriş yapın, bir API anahtarı oluşturun ve etkin olduğundan emin olun.

Claude Ayarları → Bağlayıcılar → Özel bağlayıcı ekle'yi açın.
MCP uç noktasını girin:
```
https://mcp.parceltracking.app/mcp
```
OAuth kimlik doğrulamasını etkin tutun ve Claude'un otomatik olarak bir istemci kaydetmesine izin verin.
Tarayıcıda Packy'ye giriş yapın. Kısa bir Yetkilendirmeye devam et sayfası otomatik olarak yönlendirir; tıklanacak bir şey yoktur. Bağlantı tek kullanımlıktır ve iki dakika sonra sona erer.
Erişime izin ver? ekranında bu bağlantının kullanacağı etkin API anahtarını seçin ve İzin Ver'i seçin.
Claude'a dönün ve bağlayıcının bağlı olduğunu doğrulayın.

OAuth erişim belirteçleri kısa ömürlüdür ve otomatik olarak yenilenir. Akış başarısız olursa, önceki yetkilendirme URL'sini yeniden açmak yerine Claude'dan yeni bir bağlantı denemesi başlatın.

Codex ile OAuth

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

Codex tarafından yazdırılan yetkilendirme URL'sini açın, Packy'ye giriş yapın, etkin bir API anahtarı seçin ve İzin Ver'i seçin.

API anahtarıyla Cursor

Belgelenen Cursor kurulumu bir API anahtarı kullanır. Sunucu URL'sini ve Authorization: Bearer <YOUR_API_KEY> başlığını Cursor'un proje veya kullanıcı mcp.json alanına ekleyin, ardından MCP/ajanı yeniden başlatın. Bkz. examples/cursor/mcp.json.

API anahtarı yedeği

MCP OAuth'u desteklemeyen istemciler doğrudan bir Packy API anahtarı kullanabilir. API anahtarı, normal Packy Tracking API'si ile kullanılan anahtarla aynıdır.

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

<YOUR_API_KEY> değerini Packy hesabındaki etkin bir anahtarla değiştirin. Anahtarı asla yayınlamayın veya paylaşmayın.

Sunucu ayrıca eşdeğer başlığı da kabul eder:

X-API-Key: <YOUR_API_KEY>

OAuth akışı önerilir çünkü anahtar Packy'de seçilir ve istemci yapılandırmasına kopyalanmaz.

Araçlar

Araç	Takip API işlemi
`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}`

Depolanan verileri değiştiren işlemler trackings_create, trackings_delete, webhooks_create, webhooks_update ve webhooks_delete işlemleridir. Bunları yalnızca hesap verilerini açıkça değiştirmeyi amaçladığınızda çalıştırın.

Yalnızca trackings_create kredi tüketir: benzersiz takip numarası başına bir kredi, bir toplu işteki her takip numarası dahil. Kurye, algılama, okuma, silme ve web kancası araçları kredi tüketmez. MCP, Takip API'sinden ayrı olarak faturalandırılmaz.

Bağlantıyı kesme ve iptal

Bir MCP uygulamasını durdurmak için:

https://lk.parceltracking.app adresindeki Packy hesabına giriş yapın.
Bağlı uygulamalar'ı açın.
Uygulamayı seçin ve Bağlantıyı kes / İptal et'i seçin.

Bir uygulamayı iptal etmek, bu OAuth bağlantısından gelen yeni istekleri durdurur. API anahtarının kendisini devre dışı bırakmaz ve aynı anahtara bağlı diğer uygulamalar bağımsız kalır.

Ayrıca API anahtarları bölümünde API anahtarını devre dışı bırakabilir veya değiştirebilirsiniz. Bu, MCP uygulamaları dahil bu anahtarı kullanan tüm entegrasyonları etkiler.

Hizmeti doğrulama

Bu genel canlılık uç noktaları bir API anahtarı gerektirmez:

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

Beklenen yanıtlar:

{"status":"ok"}

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

/ready ayrıca MCP hizmetinin API ağ geçidine ulaşabildiğini doğrular.

Sorun giderme

Araçlar görünmüyorsa, uç noktayı kontrol edin, packy-tracking-mcp sunucu adını kullanın ve istemciyi yeniden başlatın.
OAuth tamamlanmazsa, amaçlanan Packy hesabına giriş yapın, etkin bir API anahtarına sahip olduğunu doğrulayın ve yeni bir bağlantı denemesi başlatın.
Erişim reddedilirse, seçilen anahtarın etkin olduğunu ve amaçlanan hesaba ait olduğunu doğrulayın.
Erişimin derhal durdurulması gerekiyorsa, Bağlı uygulamalar bölümünde uygulamanın bağlantısını kesin veya API anahtarını devre dışı bırakın.

Bağlantılar

Packy web sitesi: https://packyapp.com
Packy hesabı: https://lk.parceltracking.app
MCP uç noktası: https://mcp.parceltracking.app/mcp

Destek

Hesap ve destek talepleri için wasup@clickor.net adresine e-posta gönderin.

Takip API'si ve MCP entegrasyonu hakkında teknik sorular için Discord'da Packy Geliştirici Topluluğu katılın. Tüm resmi iletişim seçenekleri https://packyapp.com/contacts adresinde mevcuttur.

Depo kapsamı

Bu depo yalnızca entegrasyon belgelerini içerir. Packy API kaynak kodunu, kimlik bilgilerini, API anahtarlarını, OAuth belirteçlerini veya dağıtım yapılandırmasını içermez.