Packy Tracking MCP

Packy Tracking MCP

Packy Tracking MCP เชื่อมต่อไคลเอนต์ AI ที่เข้ากันได้กับ Packy Tracking API ผ่าน Model Context Protocol (MCP)

พื้นที่เก็บข้อมูลนี้ประกอบด้วยเอกสารการผสานรวมสาธารณะและตัวอย่างการกำหนดค่า ตัว MCP เองเป็นบริการที่โฮสต์ไว้ ไม่จำเป็นต้องติดตั้งเซิร์ฟเวอร์ในเครื่อง

เซิร์ฟเวอร์ MCP ดำเนินการในนามของบัญชี Packy ที่เชื่อมต่ออยู่ ไม่ได้ให้สิทธิ์เกินกว่าที่มีอยู่ในคีย์ API ที่เลือกระหว่างการอนุญาต OAuth

เอนด์พอยต์

เอนด์พอยต์ MCP สำหรับการใช้งานจริง:

https://mcp.parceltracking.app/mcp

การรับรองความถูกต้อง

OAuth เป็นวิธีการรับรองความถูกต้องที่แนะนำ ไคลเอนต์จะเปิดหน้าอนุญาตของ Packy ซึ่งคุณลงชื่อเข้าใช้และเลือกคีย์ API ที่ใช้งานอยู่ หลังจากที่คุณอนุมัติการเข้าถึง แอปพลิเคชัน MCP จะเชื่อมต่อกับคีย์นั้น

สิทธิ์ OAuth จะถูกตรวจสอบโดยเซิร์ฟเวอร์ MCP และจะไม่ถูกส่งต่อไปยัง API ของผลิตภัณฑ์ คำขอผลิตภัณฑ์จะทำด้วยคีย์ API ของบัญชีที่เลือก

โมเดลการเข้าถึง

• ระหว่างการยินยอม OAuth ผู้ใช้เลือกคีย์ API ที่ใช้งานอยู่หนึ่งคีย์ซึ่งเป็นของบัญชี Packy ปัจจุบัน
• แอปพลิเคชัน MCP จะผูกกับคีย์ที่เลือกหลังจากกด Allow
• แอปพลิเคชัน MCP หลายตัวสามารถผูกกับคีย์ API เดียวกันได้ แต่ละแอปพลิเคชันมีการอนุญาต OAuth ของตัวเอง
• การตัดการเชื่อมต่อแอปพลิเคชันหนึ่งจะเพิกถอนเฉพาะการเข้าถึง OAuth ของแอปพลิเคชันนั้นเท่านั้น และไม่ได้ปิดใช้งานคีย์ API หรือส่งผลต่อแอปพลิเคชันอื่น
• เซิร์ฟเวอร์ MCP ตรวจสอบการอนุญาต OAuth และสถานะของคีย์ก่อนส่งต่อการดำเนินการไปยัง Packy API

OAuth กับ Claude

ก่อนเชื่อมต่อ ลงชื่อเข้าใช้ที่ https://lk.parceltracking.app สร้างคีย์ API และตรวจสอบให้แน่ใจว่าคีย์นั้นใช้งานอยู่

1. เปิด Claude Settings → Connectors → Add custom connector

2. ป้อนเอนด์พอยต์ MCP:

   https://mcp.parceltracking.app/mcp
   

3. เปิดใช้งานการรับรองความถูกต้อง OAuth ไว้ และอนุญาตให้ Claude ลงทะเบียนไคลเอนต์โดยอัตโนมัติ

4. ลงชื่อเข้าใช้ Packy ในเบราว์เซอร์ หน้า Continue authorization สั้นๆ จะเปลี่ยนเส้นทางโดยอัตโนมัติ ไม่มีอะไรให้คลิก ลิงก์ใช้ได้ครั้งเดียวและหมดอายุหลังจากสองนาที

5. บนหน้า Allow access? เลือกคีย์ API ที่ใช้งานอยู่ซึ่งการเชื่อมต่อนี้จะใช้ และเลือก Allow

6. กลับไปที่ Claude และยืนยันว่าคอนเนกเตอร์เชื่อมต่อแล้ว

โทเค็นการเข้าถึง OAuth มีอายุสั้นและรีเฟรชโดยอัตโนมัติ หากโฟลว์ล้มเหลว ให้เริ่มการเชื่อมต่อใหม่จาก Claude แทนการเปิด URL การอนุญาตก่อนหน้าอีกครั้ง

OAuth กับ Codex

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

เปิด URL การอนุญาตที่ Codex แสดง ลงชื่อเข้าใช้ Packy เลือกคีย์ API ที่ใช้งานอยู่ และเลือก Allow

Cursor กับคีย์ API

การตั้งค่า Cursor ที่บันทึกไว้ใช้คีย์ API เพิ่ม URL เซิร์ฟเวอร์และส่วนหัว Authorization: Bearer <YOUR_API_KEY> ในโปรเจกต์หรือผู้ใช้ mcp.json ของ Cursor จากนั้นรีสตาร์ท MCP/เอเจนต์ ดู examples/cursor/mcp.json

ทางเลือกสำรองด้วยคีย์ API

ไคลเอนต์ที่ไม่รองรับ MCP OAuth สามารถใช้คีย์ API ของ Packy ได้โดยตรง คีย์ API เป็นคีย์เดียวกับที่ใช้กับ Packy Tracking API ปกติ

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

แทนที่ <YOUR_API_KEY> ด้วยคีย์ที่ใช้งานอยู่จากบัญชี Packy ห้ามเผยแพร่หรือแชร์คีย์

เซิร์ฟเวอร์ยังยอมรับส่วนหัวที่เทียบเท่า:

X-API-Key: <YOUR_API_KEY>

แนะนำให้ใช้โฟลว์ OAuth เพราะคีย์ถูกเลือกใน Packy และไม่ถูกคัดลอกลงในการกำหนดค่าไคลเอนต์

เครื่องมือ

เครื่องมือ	การดำเนินการ 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}

การดำเนินการที่เปลี่ยนแปลงข้อมูลที่จัดเก็บคือ trackings_create, trackings_delete, webhooks_create, webhooks_update และ webhooks_delete เรียกใช้เฉพาะเมื่อคุณตั้งใจจะแก้ไขข้อมูลบัญชีอย่างชัดเจน

เฉพาะ trackings_create เท่านั้นที่ใช้เครดิต: หนึ่งเครดิตต่อหมายเลขติดตามที่ไม่ซ้ำกัน รวมถึงหมายเลขติดตามแต่ละหมายเลขในชุด เครื่องมือจัดส่ง การตรวจจับ การอ่าน การลบ และเว็บฮุคไม่ใช้เครดิต MCP ไม่ถูกเรียกเก็บเงินแยกจาก Tracking API

การตัดการเชื่อมต่อและการเพิกถอน

เพื่อหยุดแอปพลิเคชัน MCP หนึ่งตัว:

1. ลงชื่อเข้าใช้บัญชี Packy ที่ https://lk.parceltracking.app
2. เปิด Connected applications
3. เลือกแอปพลิเคชันและเลือก Disconnect / Revoke

การเพิกถอนแอปพลิเคชันจะหยุดคำขอใหม่จากการเชื่อมต่อ OAuth นั้น ไม่ได้ปิดใช้งานคีย์ API เอง และแอปพลิเคชันอื่นที่เชื่อมต่อกับคีย์เดียวกันยังคงเป็นอิสระ

คุณยังสามารถปิดใช้งานหรือแทนที่คีย์ API ในส่วน API keys ได้ ซึ่งส่งผลต่อทุกการผสานรวมที่ใช้คีย์นั้น รวมถึงแอปพลิเคชัน MCP

ตรวจสอบบริการ

เอนด์พอยต์ liveness สาธารณะเหล่านี้ไม่ต้องใช้คีย์ API:

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

การตอบสนองที่คาดหวัง:

{"status":"ok"}

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

/ready ยังยืนยันว่าเซิร์ฟเวอร์ MCP สามารถเข้าถึงเกตเวย์ API ของตนได้

การแก้ไขปัญหา

• หากไม่มีเครื่องมือปรากฏ ให้ตรวจสอบเอนด์พอยต์ ใช้ชื่อเซิร์ฟเวอร์ packy-tracking-mcp และรีสตาร์ทไคลเอนต์
• หาก OAuth ไม่เสร็จสิ้น ให้ลงชื่อเข้าใช้บัญชี Packy ที่ต้องการ ยืนยันว่ามีคีย์ API ที่ใช้งานอยู่ และเริ่มการเชื่อมต่อใหม่
• หากการเข้าถึงถูกปฏิเสธ ให้ตรวจสอบว่าคีย์ที่เลือกใช้งานอยู่และเป็นของบัญชีที่ต้องการ
• หากต้องหยุดการเข้าถึงทันที ให้ตัดการเชื่อมต่อแอปพลิเคชันใน Connected applications หรือปิดใช้งานคีย์ API

ลิงก์

• เว็บไซต์ Packy: https://packyapp.com
• บัญชี Packy: https://lk.parceltracking.app
• เอนด์พอยต์ MCP: https://mcp.parceltracking.app/mcp

การสนับสนุน

สำหรับคำขอเกี่ยวกับบัญชีและการสนับสนุน อีเมล wasup@clickor.net

สำหรับคำถามทางเทคนิคเกี่ยวกับ Tracking API และการผสานรวม MCP เข้าร่วม Packy Developer Community on Discord ตัวเลือกการติดต่ออย่างเป็นทางการทั้งหมดมีอยู่ที่ https://packyapp.com/contacts

ขอบเขตของพื้นที่เก็บข้อมูล

พื้นที่เก็บข้อมูลนี้มีเอกสารการผสานรวมเท่านั้น ไม่มีซอร์สโค้ด Packy API ข้อมูลรับรอง คีย์ API โทเค็น OAuth หรือการกำหนดค่าการปรับใช้