Model Context Protocol
ให้ AI ส่งพัสดุผ่าน iShip แทนคุณ
เชื่อม Claude, Cursor หรือ AI agent ที่รองรับ MCP เข้ากับบัญชี iShip แล้วสั่งงานเป็นภาษาธรรมดา เช่น เทียบราคาขนส่ง สร้างรายการ พิมพ์ใบปะหน้า และติดตามพัสดุ
POST
https://mcp.iship.cloud/mcp
เริ่มใช้งานใน 3 ขั้น
ขั้นที่ 1ขอ API token จากบัญชี iShip ของคุณ
ขั้นที่ 2เพิ่ม iShip MCP ในโปรแกรม AI ที่ใช้ พร้อมใส่ token
ขั้นที่ 3พิมพ์สั่ง เช่น “เช็คราคาส่งกล่อง 2 กก. ไปเชียงใหม่”
ไม่มี token ก็ใช้ได้ เฉพาะติดตามพัสดุ ดูขนาดกล่อง และเทียบราคาขนส่งมาตรฐาน
1. ขอ API token
ใช้เบอร์โทรและรหัสผ่านที่ใช้เข้าสู่ระบบ iShip:
curl -X POST https://app.iship.cloud/api/auth/requestToken \
-H "Content-Type: application/json" \
-d '{"phone":"0812345678","password":"รหัสผ่านของคุณ"}'
นำค่า data.accessToken ในผลลัพธ์ไปใช้ในขั้นถัดไป
อ่านก่อนขอ token ใหม่: บัญชีหนึ่งมี token ได้ครั้งละ 1 ชุด การขอใหม่จะทำให้ token เดิมใช้ไม่ได้ทันที
ถ้าร้านหรือระบบของคุณเชื่อม iShip API อยู่แล้ว ให้ใช้ token เดิม ไม่อย่างนั้นระบบเดิมจะสร้างรายการไม่ได้
2. เพิ่มในโปรแกรม AI
แทน <TOKEN> ด้วย token จากขั้นที่ 1
รันคำสั่งนี้ใน Terminal:
claude mcp add --transport http iship https://mcp.iship.cloud/mcp \
--header "Authorization: Bearer <TOKEN>"
เปิด Settings → Developer → Edit Config แล้วเพิ่มใน claude_desktop_config.json จากนั้นปิดแล้วเปิด Claude Desktop ใหม่ (ต้องติดตั้ง Node.js)
{
"mcpServers": {
"iship": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp.iship.cloud/mcp",
"--header", "Authorization:${ISHIP_AUTH}"
],
"env": { "ISHIP_AUTH": "Bearer <TOKEN>" }
}
}
}
เพิ่มใน ~/.cursor/mcp.json:
{
"mcpServers": {
"iship": {
"url": "https://mcp.iship.cloud/mcp",
"headers": { "Authorization": "Bearer <TOKEN>" }
}
}
}
โปรแกรมใดก็ได้ที่รองรับ MCP แบบ Streamable HTTP ตั้งค่าดังนี้:
- URL:
https://mcp.iship.cloud/mcp - Header:
Authorization: Bearer <TOKEN>
โปรแกรมที่ใส่ header เองไม่ได้ (เช่น connector บนเว็บที่รองรับเฉพาะ OAuth) จะใช้ได้เฉพาะเครื่องมือที่ไม่ต้องใช้ token
เครื่องมือที่มีให้
ถ้า AI จะสร้างรายการ ยกเลิก หรือเรียกขนส่ง จะถูกกำหนดให้สรุปรายละเอียดและขอคำยืนยันจากคุณก่อนทุกครั้ง
| เครื่องมือ | ทำอะไร | สิทธิ์ |
|---|---|---|
track_parcel | ติดตามสถานะพัสดุจากเลขพัสดุ | ไม่ต้องใช้ token |
list_boxes | ขนาดกล่องมาตรฐาน | ไม่ต้องใช้ token |
recommend_couriers | เทียบราคามาตรฐานทุกขนส่ง | ไม่ต้องใช้ token |
list_couriers | ขนส่งที่บัญชีใช้ได้ | ต้องใช้ token |
check_price | ราคาตามบัญชีของคุณ | ต้องใช้ token |
check_balance | เครดิตคงเหลือ | ต้องใช้ token |
query_orders | ค้นหารายการตามวันที่ สถานะ ขนส่ง | ต้องใช้ token |
get_order / trace_order | รายละเอียดและเส้นทางพัสดุของบัญชี | ต้องใช้ token |
list_order_statuses | รหัสสถานะสำหรับกรองรายการ | ต้องใช้ token |
get_label_url | ลิงก์ PDF ใบปะหน้า | ต้องใช้ token |
create_order | สร้างรายการส่งพัสดุ (ตัดเครดิต) | ต้องยืนยัน |
cancel_order | ยกเลิกรายการที่ยังไม่เข้ารับ | ต้องยืนยัน |
request_pickup | เรียกขนส่งเข้ารับพัสดุ | ต้องยืนยัน |
ตัวอย่างคำสั่ง
“กล่อง 20×14×6 ซม. หนัก 1 กก. ส่งจากสายไหมไปขุนยวม แม่ฮ่องสอน ขนส่งไหนถูกสุด”
“สร้างรายการส่งให้คุณสมชาย 0891234567 ที่ 12/3 ต.สุเทพ อ.เมือง เชียงใหม่ 50200 COD 590 บาท”
“เมื่อวานมีพัสดุไหนที่ยังไม่พิมพ์ใบปะหน้า ขอลิงก์ใบปะหน้าทั้งหมด”
“พัสดุ TH0147… ถึงไหนแล้ว”
ความปลอดภัย
- Token ทำได้ทุกอย่างที่บัญชีของคุณทำได้ รวมถึงสร้างรายการที่ตัดเครดิต ดูแลเหมือนรหัสผ่าน อย่าแชร์หรือวางในที่สาธารณะ
- เซิร์ฟเวอร์นี้ไม่เก็บ token ไม่เก็บรายการ และไม่บันทึกข้อมูลลูกค้า ทุกคำสั่งส่งต่อไปยัง iShip API โดยตรงแล้วจบในครั้งนั้น
- ถ้าสงสัยว่า token รั่ว ให้ขอ token ใหม่ตามขั้นที่ 1 token เดิมจะใช้ไม่ได้ทันที
- ลิงก์ใบปะหน้ามีชื่อ ที่อยู่ และเบอร์โทรผู้รับ ส่งให้เฉพาะคนที่ต้องใช้