MCP

เซิร์ฟเวอร์ Zaapi MCP เชื่อมต่อผู้ช่วย AI — Claude, Claude Code, Cursor และเครื่องมืออื่นที่รองรับ MCP — เข้ากับ workspace ของ Zaapi โดยตรง เมื่อติดตั้งแล้ว สามารถสั่งให้ผู้ช่วยทำงานกับกล่องข้อความจริงด้วยภาษาธรรมดาได้ เช่น ค้นหาทิกเก็ต อ่านการสนทนา ดูข้อมูลติดต่อ อัปเดต Custom Fields เพิ่มโน้ตภายใน หรือแม้แต่ตอบกลับลูกค้า

MCP (Model Context Protocol) เป็นมาตรฐานเปิดสำหรับเชื่อมต่อผู้ช่วย AI กับเครื่องมือและข้อมูลภายนอก เซิร์ฟเวอร์ Zaapi MCP ทำงานบนเครื่องของตนเอง และสื่อสารกับ Zaapi Open API ผ่าน API key ที่สร้างขึ้น ข้อมูลจะคงอยู่ระหว่างเครื่อง ผู้ช่วย และ Zaapi

สิ่งที่สามารถทำได้

มีตัวอย่างการใช้งานที่พบบ่อยดังนี้:

• คัดแยกทิกเก็ต — "แสดงทิกเก็ตที่ยังเปิดอยู่ทั้งหมดซึ่งลูกค้ารอเกินสี่ชั่วโมง"

• ดูบริบทก่อนตอบกลับ — "สรุปการสนทนานี้ และบอกว่าพนักงานคนล่าสุดสัญญาอะไรไว้"

• การรายงาน — "ทีมซัพพอร์ตปิดทิกเก็ตไปกี่รายการในสัปดาห์ที่แล้ว และมีการแปลงเป็นลูกค้ากี่รายการ"

• ค้นหาข้อมูลแบบหลายรายการ — "ค้นหาข้อมูลติดต่อทั้งหมดที่กล่าวถึงการคืนเงินในเดือนนี้ และแสดงหมายเลขโทรศัพท์ทั้งหมด"

• ทำความสะอาดข้อมูล — "ตั้งค่าฟิลด์ Customer Tier เป็น Gold สำหรับข้อมูลติดต่อ 12 รายนี้"

• ร่างข้อความ — "ร่างข้อความตอบกลับลูกค้ารายนี้ แล้วบันทึกไว้เป็นโน้ตภายในเพื่อให้ตรวจทานได้"

ก่อนเริ่มต้น

ต้องใช้:

• Node.js 20 ขึ้นไป บนเครื่อง ตรวจสอบด้วย node --version

• API key ของ Zaapi — ทำตาม คำแนะนำเหล่านี้ เพื่อสร้างค่าใหม่

• ผู้ช่วยที่รองรับ MCP — Claude Desktop, Claude Code, Cursor หรือเครื่องมืออื่นที่รองรับ MCP

ติดตั้งเซิร์ฟเวอร์

การตั้งค่าจะเหมือนกันทุกที่ แทนที่ zaapi_*** ด้วยคีย์ที่เพิ่งสร้าง

{
  "mcpServers": {
    "zaapi": {
      "command": "npx",
      "args": ["-y", "@zaapi/open-api-mcp"],
      "env": {
        "ZAAPI_API_KEY": "zaapi_***"
      }
    }
  }
}

Claude Desktop

1. เปิด การตั้งค่า → Developer → Edit Config ซึ่งจะเปิด claude_desktop_config.json.

2. วางบล็อกด้านบน หากไฟล์มีอ็อบเจ็กต์ mcpServers อยู่แล้ว ให้เพิ่มรายการ "zaapi" ภายในนั้น แทนที่จะแทนที่ทั้งไฟล์

3. บันทึกไฟล์ แล้วปิดและเปิด Claude Desktop ใหม่ทั้งหมด

4. เครื่องมือของ Zaapi จะปรากฏในเมนูเครื่องมือในช่องป้อนข้อความแชท

Claude Code

รันคำสั่งนี้ในเทอร์มินัล:

claude mcp add zaapi --env ZAAPI_API_KEY=zaapi_*** -- npx -y @zaapi/open-api-mcp

เพิ่ม --scope user เพื่อให้ใช้งานได้กับทุกโปรเจกต์ ไม่ใช่เฉพาะโปรเจกต์ปัจจุบัน ตรวจสอบว่าลงทะเบียนแล้วด้วยคำสั่ง:

claude mcp list

Cursor

1. เปิด การตั้งค่า → MCP → เพิ่มเซิร์ฟเวอร์ MCP ใหม่ หรือสร้างไฟล์คอนฟิกโดยตรง:

   • เฉพาะโปรเจกต์: .cursor/mcp.json ใน repository

   • ทุกโปรเจกต์: ~/.cursor/mcp.json

2. วางบล็อกด้านบน

3. รีสตาร์ท Cursor เซิร์ฟเวอร์จะปรากฏใต้ การตั้งค่า → MCP พร้อมจุดสีเขียวเมื่อเชื่อมต่อแล้ว

VS Code (GitHub Copilot)

สร้าง .mcp.json ในรูทของ workspace หรือใช้ MCP: Add Server จาก command palette VS Code จะจัดวางเซิร์ฟเวอร์ไว้ใต้ servers แทนที่จะเป็น mcpServers:

{
  "servers": {
    "zaapi": {
      "command": "npx",
      "args": ["-y", "@zaapi/open-api-mcp"],
      "env": {
        "ZAAPI_API_KEY": "zaapi_***"
      }
    }
  }
}

ไคลเอนต์ MCP อื่น ๆ

ไคลเอนต์ใดก็ตามที่รองรับเซิร์ฟเวอร์ MCP แบบ stdio ใช้งานได้ทั้งหมด ให้ชี้ไปที่คำสั่ง npx พร้อมอาร์กิวเมนต์ -y @zaapi/open-api-mcp และตั้งค่า ZAAPI_API_KEY ตัวแปรสภาพแวดล้อมเป็นคีย์ที่สร้างไว้

ขั้นตอนที่ 3 — ตรวจสอบว่าใช้งานได้

ลองถามผู้ช่วย:

แสดงบัญชี Zaapi ที่เชื่อมต่ออยู่

ควรได้รับกล่องข้อความของช่องทางต่าง ๆ ในร้านค้า — LINE OA, หมายเลข WhatsApp, ร้านค้า Shopee และอื่น ๆ หากทำงานได้ แสดงว่าคีย์และการเชื่อมต่อถูกต้อง