MCP server
เชื่อม AI assistant เช่น Claude Code กับ inbox ของ Khuivo ผ่าน remote MCP server ด้วย API key พร้อมรายการ tool และสิทธิ์ที่ต้องใช้
MCP (Model Context Protocol) ทำให้ AI assistant เช่น Claude หรือ Claude Code ทำงานกับ inbox จริงของคุณด้วยภาษาธรรมชาติ เช่น "สรุป ticket ที่ยังเปิดอยู่ของ Shopee" หรือ "เขียนโน้ตใน ticket นี้ว่าลูกค้าชำระแล้ว" โดยใช้ API key เดียวกับ Open API
ภาพรวม #
- Khuivo มี remote MCP server ไม่ต้องติดตั้งอะไร
- Endpoint:
https://api.khuivo.com/v1/mcp(ค่าจริงแสดงในแท็บ MCP ที่ ตั้งค่า → Developer) - Transport แบบ streamable HTTP ส่ง key ใน header
x-api-key - ชื่อ server:
khuivo - สิทธิ์ตรวจแยกตาม tool: tool ไหนต้องใช้ scope ที่ key ไม่มี จะเรียกไม่ได้
แท็บ MCP ในหน้า Developer
เชื่อมกับ Claude Code #
- 1
สร้าง key ที่ API keys เริ่มจากสิทธิ์อ่านอย่างเดียว
- 2
เปิด terminal แล้วรันคำสั่งด้านล่าง โดยแทน
khv_live_***ด้วย key ของคุณ - 3
เปิด Claude Code แล้วลองถาม เช่น "มี ticket ที่เปิดอยู่กี่ใบ"
Claude Code
claude mcp add --transport http khuivo https://api.khuivo.com/v1/mcp --header "x-api-key: khv_live_***"เชื่อมกับ client อื่น #
Client ที่รองรับ remote MCP server แบบ HTTP ใช้ config ลักษณะนี้ได้ ชื่อ field อาจต่างกันเล็กน้อยในแต่ละโปรแกรม ดูคู่มือของ client นั้นประกอบ
mcp.json
{
"mcpServers": {
"khuivo": {
"type": "http",
"url": "https://api.khuivo.com/v1/mcp",
"headers": {
"x-api-key": "khv_live_***"
}
}
}
}Tools #
| Tool | ทำอะไร | Scope ที่ต้องใช้ |
|---|---|---|
list_tickets | รายการ ticket ใหม่สุดก่อน (เริ่มต้นเฉพาะที่เปิดอยู่) | tickets:read |
search_tickets | ค้นหา ticket จากหัวข้อหรือข้อความล่าสุด | tickets:read |
get_ticket | ticket หนึ่งใบ พร้อมลูกค้าและผู้รับผิดชอบถ้า key อ่านได้ | tickets:read |
get_conversation | บทสนทนา พร้อมข้อความล่าสุดถ้า key อ่านข้อความได้ | conversations:read |
search_contacts | ค้นหาลูกค้าจากชื่อ เบอร์ หรืออีเมล | contacts:read |
get_contact | ข้อมูลลูกค้าหนึ่งราย | contacts:read |
update_ticket_fields | แก้ฟิลด์ ความสำคัญ หรือหัวข้อของ ticket | tickets:write |
close_ticket | ปิด ticket พร้อมเหตุผล (ไม่บังคับ) | tickets:write |
add_note | เขียนโน้ตภายใน (ลูกค้าไม่เห็น) | messages:write |
send_reply | ส่งข้อความตอบลูกค้าในช่องทางของบทสนทนา | messages:write |
list_accounts | ช่องทางที่เชื่อมไว้และสถานะ | accounts:read |
analytics_summary | สรุปรายงาน (ปริมาณงาน เวลาตอบ เวลาปิดงาน CSAT) | analytics:read |
ความปลอดภัย #
- ใช้ key แยกสำหรับ MCP โดยเฉพาะ และตั้งชื่อให้รู้ว่าใช้กับเครื่องหรือโปรแกรมไหน
- ให้สิทธิ์น้อยที่สุด: เริ่มจากอ่านอย่างเดียว แล้วค่อยเพิ่มสิทธิ์เขียนเฉพาะที่ใช้จริง
- ไม่ต้องให้สิทธิ์ข้อมูลที่ tool ไม่ได้ใช้ เช่น ผู้ใช้ หรือ ทีม ถ้าไม่จำเป็น
- ไฟล์ config มี key อยู่ อย่าแชร์หรือ commit ลง git
- ลบหรือออก secret ใหม่ทันทีเมื่อเลิกใช้ หรือสงสัยว่า key รั่ว ดู ออก secret ใหม่
เคล็ดลับ #
- บอก AI ให้สรุปก่อนลงมือ เช่น "แสดงรายการก่อน ยังไม่ต้องปิด" เพื่อตรวจก่อนทำจริง
- ทุกการเรียกผ่าน MCP นับรวมใน rate limit และประวัติการใช้ของ key เหมือน Open API
ปัญหาที่พบบ่อย #
- Tool แจ้งว่าไม่มีสิทธิ์ (ต้องใช้ scope …) — key ไม่มี scope ที่ tool ต้องการ แก้ สิทธิ์ต่อข้อมูล ของ key
- เชื่อมไม่ได้หรือได้ 401 — key ผิดหรือหมดอายุ หรือ header ไม่ใช่
x-api-keyตรวจ config แล้วลองใหม่ - Client ไม่รู้จัก config — client นั้นอาจไม่รองรับ remote MCP แบบ HTTP หรือใช้ชื่อ field ต่างไป ดูคู่มือของ client
หน้านี้มีประโยชน์ไหม?