Packy Tracking MCP

Packy Tracking MCP

Packy Tracking MCP menghubungkan klien AI yang kompatibel ke Packy Tracking API melalui Model Context Protocol (MCP).

Repositori ini berisi dokumentasi integrasi publik dan contoh konfigurasi. Implementasi MCP itu sendiri adalah layanan yang di-hosting; tidak diperlukan instalasi server lokal.

Server MCP bertindak atas nama akun Packy yang terhubung. Server ini tidak memberikan izin di luar yang tersedia untuk kunci API yang dipilih selama otorisasi OAuth.

Endpoint

Endpoint MCP produksi:

https://mcp.parceltracking.app/mcp

Autentikasi

OAuth adalah metode autentikasi yang direkomendasikan. Klien membuka halaman otorisasi Packy, tempat Anda masuk dan memilih kunci API yang aktif. Setelah Anda menyetujui akses, aplikasi MCP terhubung ke kunci tersebut.

Izin OAuth diperiksa oleh server MCP dan tidak diteruskan ke API produk. Permintaan produk dibuat dengan kunci API akun yang dipilih.

Model akses

• Selama persetujuan OAuth, pengguna memilih satu kunci API aktif milik akun Packy saat ini.
• Aplikasi MCP terikat ke kunci yang dipilih setelah Izinkan.
• Beberapa aplikasi MCP dapat terikat ke kunci API yang sama; setiap aplikasi memiliki otorisasi OAuth sendiri.
• Memutuskan satu aplikasi hanya mencabut akses OAuth aplikasi tersebut dan tidak menonaktifkan kunci API atau memengaruhi aplikasi lain.
• Server MCP memvalidasi otorisasi OAuth dan status kunci sebelum meneruskan tindakan ke Packy API.

OAuth dengan Claude

Sebelum menghubungkan, masuk ke https://lk.parceltracking.app, buat kunci API, dan pastikan kunci tersebut aktif.

1. Buka Claude Settings → Connectors → Add custom connector.

2. Masukkan endpoint MCP:

   https://mcp.parceltracking.app/mcp
   

3. Biarkan autentikasi OAuth tetap aktif dan izinkan Claude mendaftarkan klien secara otomatis.

4. Masuk ke Packy di browser. Halaman Continue authorization singkat akan dialihkan secara otomatis; tidak ada yang perlu diklik. Tautan hanya dapat digunakan sekali dan kedaluwarsa setelah dua menit.

5. Pada Allow access?, pilih kunci API aktif yang akan digunakan koneksi ini dan pilih Izinkan.

6. Kembali ke Claude dan konfirmasi bahwa konektor telah terhubung.

Token akses OAuth berumur pendek dan disegarkan secara otomatis. Jika alur gagal, mulailah percobaan koneksi baru dari Claude, jangan membuka kembali URL otorisasi sebelumnya.

OAuth dengan Codex

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

Buka URL otorisasi yang ditampilkan Codex, masuk ke Packy, pilih kunci API aktif, dan pilih Izinkan.

Cursor dengan kunci API

Pengaturan Cursor yang didokumentasikan menggunakan kunci API. Tambahkan URL server dan header Authorization: Bearer <YOUR_API_KEY> di proyek atau pengguna mcp.json Cursor, lalu mulai ulang MCP/agen. Lihat examples/cursor/mcp.json.

Cadangan kunci API

Klien yang tidak mendukung MCP OAuth dapat menggunakan kunci API Packy secara langsung. Kunci API tersebut adalah kunci yang sama yang digunakan dengan Packy Tracking API biasa.

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

Ganti <YOUR_API_KEY> dengan kunci aktif dari akun Packy. Jangan pernah memublikasikan atau membagikan kunci tersebut.

Server juga menerima header yang setara:

X-API-Key: <YOUR_API_KEY>

Alur OAuth direkomendasikan karena kunci dipilih di Packy dan tidak disalin ke konfigurasi klien.

Alat

Alat	Operasi Tracking API
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}

Operasi yang mengubah data tersimpan adalah trackings_create, trackings_delete, webhooks_create, webhooks_update, dan webhooks_delete. Jalankan hanya jika Anda secara eksplisit berniat mengubah data akun.

Hanya trackings_create yang mengonsumsi kredit: satu kredit per nomor pelacakan unik, termasuk setiap nomor pelacakan dalam batch. Alat kurir, deteksi, baca, hapus, dan webhook tidak mengonsumsi kredit. MCP tidak ditagih terpisah dari Tracking API.

Putuskan koneksi dan pencabutan

Untuk menghentikan satu aplikasi MCP:

1. Masuk ke akun Packy di https://lk.parceltracking.app.
2. Buka Aplikasi yang terhubung.
3. Pilih aplikasi dan pilih Putuskan / Cabut.

Mencabut aplikasi menghentikan permintaan baru dari koneksi OAuth tersebut. Ini tidak menonaktifkan kunci API itu sendiri, dan aplikasi lain yang terhubung ke kunci yang sama tetap independen.

Anda juga dapat menonaktifkan atau mengganti kunci API di bagian Kunci API. Ini memengaruhi setiap integrasi yang menggunakan kunci tersebut, termasuk aplikasi MCP.

Verifikasi layanan

Endpoint liveness publik ini tidak memerlukan kunci API:

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

Respons yang diharapkan:

{"status":"ok"}

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

/ready juga mengonfirmasi bahwa layanan MCP dapat mencapai gateway API-nya.

Pemecahan masalah

• Jika tidak ada alat yang muncul, periksa endpoint, gunakan nama server packy-tracking-mcp, dan mulai ulang klien.
• Jika OAuth tidak selesai, masuk ke akun Packy yang dituju, pastikan akun tersebut memiliki kunci API aktif, dan mulailah percobaan koneksi baru.
• Jika akses ditolak, verifikasi bahwa kunci yang dipilih aktif dan milik akun yang dituju.
• Jika akses harus dihentikan segera, putuskan aplikasi di Aplikasi yang terhubung atau nonaktifkan kunci API.

Tautan

• Situs web Packy: https://packyapp.com
• Akun Packy: https://lk.parceltracking.app
• Endpoint MCP: https://mcp.parceltracking.app/mcp

Dukungan

Untuk permintaan akun dan dukungan, kirim email ke wasup@clickor.net.

Untuk pertanyaan teknis tentang Tracking API dan integrasi MCP, bergabunglah dengan Komunitas Pengembang Packy di Discord. Semua opsi kontak resmi tersedia di https://packyapp.com/contacts.

Cakupan repositori

Repositori ini hanya berisi dokumentasi integrasi. Repositori ini tidak berisi kode sumber Packy API, kredensial, kunci API, token OAuth, atau konfigurasi deployment.