Packy Tracking MCP

Packy Tracking MCP

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

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

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

Endpoint

Production MCP endpoint:

https://mcp.parceltracking.app/mcp

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

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

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

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

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

OAuth กับ Claude

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

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

2. ป้อน MCP endpoint:

   https://mcp.parceltracking.app/mcp
   

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

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

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

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

OAuth access tokens มีอายุสั้นและจะรีเฟรชโดยอัตโนมัติ หากโฟลว์ล้มเหลว ให้เริ่มการเชื่อมต่อใหม่จาก 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 key ที่ใช้งานอยู่ และเลือก Allow

Cursor กับ API key

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

API-key fallback

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

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

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

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

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 ที่ใช้เครดิต: หนึ่งเครดิตต่อหมายเลขติดตามที่ไม่ซ้ำกัน รวมถึงหมายเลขติดตามแต่ละหมายเลขในชุด เครื่องมือจัดส่ง การตรวจจับ การอ่าน การลบ และ webhook ไม่ใช้เครดิต MCP ไม่ถูกเรียกเก็บเงินแยกจาก Tracking API

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

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

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

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

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

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

endpoint ความมีชีวิตสาธารณะเหล่านี้ไม่ต้องใช้ API key:

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

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

{"status":"ok"}

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

/ready ยังยืนยันว่า MCP service สามารถเข้าถึง API gateway ได้

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

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

ลิงก์

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

การสนับสนุน

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

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

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

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