Khuivo
นักพัฒนา

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

    สร้าง key ที่ API keys เริ่มจากสิทธิ์อ่านอย่างเดียว

  2. 2

    เปิด terminal แล้วรันคำสั่งด้านล่าง โดยแทน khv_live_*** ด้วย key ของคุณ

  3. 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_ticketticket หนึ่งใบ พร้อมลูกค้าและผู้รับผิดชอบถ้า key อ่านได้tickets:read
get_conversationบทสนทนา พร้อมข้อความล่าสุดถ้า key อ่านข้อความได้conversations:read
search_contactsค้นหาลูกค้าจากชื่อ เบอร์ หรืออีเมลcontacts:read
get_contactข้อมูลลูกค้าหนึ่งรายcontacts:read
update_ticket_fieldsแก้ฟิลด์ ความสำคัญ หรือหัวข้อของ tickettickets: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

หน้านี้มีประโยชน์ไหม?