Packy Tracking MCP

resmi

Pelacakan Paket Multi-Kurir

GitHub

Apa yang bisa Anda lakukan dengan Packy Tracking MCP?

Membuat pelacakan — Minta untuk mendaftarkan kiriman baru melalui trackings_create, termasuk nomor pelacakan batch, untuk mulai memantau paket.
Mencantumkan dan mengambil pelacakan — Gunakan trackings_list dan trackings_get untuk melihat semua kiriman atau mengambil detail untuk ID pelacakan tertentu.
Mengelola webhook — Buat, perbarui, cantumkan, atau hapus endpoint webhook dengan webhooks_create, webhooks_update, webhooks_list, dan webhooks_delete untuk notifikasi peristiwa.
Mencantumkan kurir yang didukung — Kueri couriers_list untuk melihat operator pengiriman yang tersedia untuk akun Anda.
Mendeteksi kurir secara otomatis — Gunakan courier_detections_create untuk mengidentifikasi operator dari nomor pelacakan.
Menghapus pelacakan — Hapus catatan kiriman yang tidak diinginkan melalui trackings_delete untuk membersihkan daftar pelacakan Anda.

Dokumentasi

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 Allow.
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.

Buka Claude Settings → Connectors → Add custom connector.
Masukkan endpoint MCP:
```
https://mcp.parceltracking.app/mcp
```
Biarkan autentikasi OAuth tetap aktif dan izinkan Claude mendaftarkan klien secara otomatis.
Masuk ke Packy di browser. Halaman Continue authorization singkat dialihkan secara otomatis; tidak ada yang perlu diklik. Tautan hanya dapat digunakan sekali dan kedaluwarsa setelah dua menit.
Pada Allow access?, pilih kunci API aktif yang akan digunakan koneksi ini dan pilih Allow.
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 alih-alih 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 dicetak oleh Codex, masuk ke Packy, pilih kunci API aktif, dan pilih Allow.

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.

Fallback 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 satu batch. Alat kurir, deteksi, baca, hapus, dan webhook tidak mengonsumsi kredit. MCP tidak ditagih secara terpisah dari Tracking API.

Putuskan koneksi dan pencabutan

Untuk menghentikan satu aplikasi MCP:

Masuk ke akun Packy di https://lk.parceltracking.app.
Buka Connected applications.
Pilih aplikasi dan pilih Disconnect / Revoke.

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 API keys. 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 menjangkau 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 dimaksud, konfirmasi bahwa akun tersebut memiliki kunci API aktif, dan mulailah percobaan koneksi baru.
Jika akses ditolak, verifikasi bahwa kunci yang dipilih aktif dan milik akun yang dimaksud.
Jika akses harus dihentikan segera, putuskan aplikasi di Connected applications 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.