Packy Tracking MCP

Packy Tracking MCP

Packy Tracking MCP, uyumlu yapay zeka 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ına sunulan 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.

1. Claude Ayarları → Bağlayıcılar → Özel bağlayıcı ekle'yi açın.

2. MCP uç noktasını girin:

   https://mcp.parceltracking.app/mcp
   

3. OAuth kimlik doğrulamasını etkin tutun ve Claude'un otomatik olarak bir istemci kaydetmesine izin verin.

4. 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 süresi dolar.

5. Erişime izin verilsin mi? ekranında, bu bağlantının kullanacağı etkin API anahtarını seçin ve İzin Ver'i seçin.

6. 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ı ile 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ı Yedekleme

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ç	İzleme 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 değiştirmeyi açıkça istediğinizde ç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 webhook araçları kredi tüketmez. MCP, İzleme API'sinden ayrı olarak faturalandırılmaz.

Bağlantıyı Kesme ve İptal

Bir MCP uygulamasını durdurmak için:

1. https://lk.parceltracking.app adresindeki Packy hesabına giriş yapın.
2. Bağlı uygulamalar bölümünü açın.
3. Uygulamayı seçin ve Bağlantıyı kes / İptal et seçeneğini belirleyin.

Bir uygulamayı iptal etmek, o 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 e-posta gönderin: wasup@clickor.net.

İzleme 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.