> For the complete documentation index, see [llms.txt](https://help.zaapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.zaapi.com/th/developers/mcp.md).

# MCP

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

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

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

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

* **คัดแยกทิกเก็ต** — "แสดงทิกเก็ตที่ยังเปิดอยู่ทั้งหมดซึ่งลูกค้ารอเกินสี่ชั่วโมง"
* **ดูบริบทก่อนตอบกลับ** — "สรุปการสนทนานี้ และบอกว่าพนักงานคนล่าสุดสัญญาอะไรไว้"
* **การรายงาน** — "ทีมซัพพอร์ตปิดทิกเก็ตไปกี่รายการในสัปดาห์ที่แล้ว และมีการแปลงเป็นลูกค้ากี่รายการ"
* **ค้นหาข้อมูลแบบหลายรายการ** — "ค้นหาข้อมูลติดต่อทั้งหมดที่กล่าวถึงการคืนเงินในเดือนนี้ และแสดงหมายเลขโทรศัพท์ทั้งหมด"
* **ทำความสะอาดข้อมูล** — "ตั้งค่าฟิลด์ Customer Tier เป็น Gold สำหรับข้อมูลติดต่อ 12 รายนี้"
* **ร่างข้อความ** — "ร่างข้อความตอบกลับลูกค้ารายนี้ แล้วบันทึกไว้เป็นโน้ตภายในเพื่อให้ตรวจทานได้"

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

ต้องใช้:

* **Node.js 20 ขึ้นไป** บนเครื่อง ตรวจสอบด้วย `node --version`
* **API key ของ Zaapi** — ทำตาม [คำแนะนำเหล่านี้](/th/developers/authentication.md#step-1-create-an-api-key) เพื่อสร้างค่าใหม่
* **ผู้ช่วยที่รองรับ MCP** — Claude Desktop, Claude Code, Cursor หรือเครื่องมืออื่นที่รองรับ MCP

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

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

```json
{
  "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

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

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

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

```bash
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`:

```json
{
  "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 และอื่น ๆ หากทำงานได้ แสดงว่าคีย์และการเชื่อมต่อถูกต้อง