เอกสารนักพัฒนา

เชื่อม AI ของคุณเข้ากับคลังความรู้

REST API สำหรับงานอัตโนมัติ MCP server สำหรับผู้ช่วย AI คลังความรู้เดียวกัน ความปลอดภัยเดียวกัน

คู่มือตั้งค่า MCP อ้างอิง REST API

MCP Server

เชื่อม Claude Code, Claude Desktop, VS Code หรือ Cursor เข้ากับคลังความรู้ของคุณโดยตรง ผู้ช่วย AI ค้นหา สอบถาม และตรวจเอกสารได้ในตัว

  • 4 เครื่องมือ: ค้นหา, ตอบ, รายการเอกสาร, ดึงเอกสาร
  • 2 พรอมต์: ตรวจการกำกับดูแล, ตรวจเอกสาร
  • การยืนยันตัวตน + ขีดจำกัดเดียวกับ REST API

REST API

สร้างการเชื่อมต่อของคุณเอง ทำงานอัตโนมัติ หรือฝังการค้นหาความรู้ในแอปของคุณ JSON เข้า JSON ออก

  • ค้นหา, ตอบ, แชท (สตรีม SSE)
  • จัดการเอกสาร CRUD + อัปโหลดไฟล์
  • กำหนดขอบเขต API key + จำกัดอัตรา

ตั้งค่า MCP

เชื่อมผู้ช่วย AI ของคุณใน 3 ขั้นตอน

1

สร้าง API key

ไปที่ Settings → API Keys ในแดชบอร์ด Puccha ของคุณ สร้าง key ที่มีขอบเขต mcp.

2

เชื่อมต่อเครื่องมือ AI ของคุณ

เลือกเครื่องมือของคุณ แล้วแทนที่ puccha_live_YOUR_KEY ด้วย key จากขั้นตอนที่ 1 — ในแดชบอร์ดจะแสดงโค้ดชุดเดียวกันพร้อมใส่ key ให้ทันทีที่สร้าง key

Claude Code

รันคำสั่งนี้ใน terminal 

claude mcp add --transport http puccha https://app.puccha.ai/api/mcp \
  --header "Authorization: Bearer puccha_live_YOUR_KEY"

เพิ่มลงใน .mcp.json — ทางเลือก 

{
  "mcpServers": {
    "puccha": {
      "type": "http",
      "url": "https://app.puccha.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer puccha_live_YOUR_KEY"
      }
    }
  }
}

เพิ่ม --scope user เพื่อให้ใช้ได้ทุกโปรเจกต์

รีสตาร์ท Claude Code แล้วเครื่องมือ puccha_search, puccha_answer และเอกสารจะปรากฏในรายการเครื่องมือ

Claude Desktop

เพิ่มลงใน claude_desktop_config.json 

{
  "mcpServers": {
    "puccha": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.puccha.ai/api/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer puccha_live_YOUR_KEY"
      }
    }
  }
}

ต้องมี Node.js (ใช้รัน mcp-remote) เปิดไฟล์จาก Settings → Developer → Edit Config

รีสตาร์ท Claude Desktop แล้วเครื่องมือ puccha_search, puccha_answer และเอกสารจะปรากฏในรายการเครื่องมือ

Cursor

เพิ่มลงใน .cursor/mcp.json 

{
  "mcpServers": {
    "puccha": {
      "url": "https://app.puccha.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer puccha_live_YOUR_KEY"
      }
    }
  }
}

นี่คือไฟล์ระดับโปรเจกต์ — ใช้ ~/.cursor/mcp.json เพื่อเปิดใช้ทุกที่

รีสตาร์ท Cursor แล้วเครื่องมือ puccha_search, puccha_answer และเอกสารจะปรากฏในรายการเครื่องมือ

VS Code

เพิ่มลงใน .vscode/mcp.json 

{
  "servers": {
    "puccha": {
      "type": "http",
      "url": "https://app.puccha.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer puccha_live_YOUR_KEY"
      }
    }
  }
}

นี่คือไฟล์ระดับ workspace — สำหรับทุกโปรเจกต์ให้รัน "MCP: Open User Configuration" จาก Command Palette

รีสตาร์ท VS Code แล้วเครื่องมือ puccha_search, puccha_answer และเอกสารจะปรากฏในรายการเครื่องมือ

Windsurf

เพิ่มลงใน ~/.codeium/windsurf/mcp_config.json 

{
  "mcpServers": {
    "puccha": {
      "serverUrl": "https://app.puccha.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer puccha_live_YOUR_KEY"
      }
    }
  }
}

รีสตาร์ท Windsurf แล้วเครื่องมือ puccha_search, puccha_answer และเอกสารจะปรากฏในรายการเครื่องมือ

Codex CLI

เพิ่มลงใน ~/.codex/config.toml 

[mcp_servers.puccha]
url = "https://app.puccha.ai/api/mcp"
http_headers = { "Authorization" = "Bearer puccha_live_YOUR_KEY" }

รีสตาร์ท Codex CLI แล้วเครื่องมือ puccha_search, puccha_answer และเอกสารจะปรากฏในรายการเครื่องมือ

Gemini CLI

รันคำสั่งนี้ใน terminal 

gemini mcp add --transport http \
  --header "Authorization: Bearer puccha_live_YOUR_KEY" \
  puccha https://app.puccha.ai/api/mcp

เพิ่มลงใน ~/.gemini/settings.json — ทางเลือก 

{
  "mcpServers": {
    "puccha": {
      "httpUrl": "https://app.puccha.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer puccha_live_YOUR_KEY"
      }
    }
  }
}

รีสตาร์ท Gemini CLI แล้วเครื่องมือ puccha_search, puccha_answer และเอกสารจะปรากฏในรายการเครื่องมือ

3

เริ่มใช้งาน

ตอนนี้ผู้ช่วย AI ของคุณเข้าถึงเครื่องมือเหล่านี้ได้:

puccha_search

ค้นหาแบบไฮบริด — คืนชิ้นส่วนเอกสาร

puccha_answer

คำตอบ RAG พร้อมการอ้างอิง

puccha_list_docs

เรียกดูคลังความรู้

puccha_get_doc

อ่านเนื้อหาเอกสารเต็ม

REST API

ทุก endpoint ต้องใช้ API key ผ่าน Authorization: Bearer puccha_live_...

POST /api/search

ค้นหาแบบไฮบริด (ความหมาย + คำ) คืนชิ้นส่วนเอกสารที่จัดอันดับโดยไม่สร้างคำตอบด้วย LLM

curl -X POST https://app.puccha.ai/api/search \
  -H "Authorization: Bearer puccha_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "PDPA requirements", "topK": 5}'
POST /api/answer

คำตอบ RAG พร้อมการอ้างอิง ดึงเอกสารที่เกี่ยวข้องและสร้างคำตอบที่อ้างอิงจากคลังความรู้ของคุณ

curl -X POST https://app.puccha.ai/api/answer \
  -H "Authorization: Bearer puccha_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "วิธีขอความยินยอมตาม PDPA", "locale": "th"}'
POST /api/chat

แชทแบบสตรีมพร้อมบริบทหลายเทิร์น คืนสตรีม SSE พร้อมชิ้นข้อความและการอ้างอิง

curl -N -X POST https://app.puccha.ai/api/chat \
  -H "Authorization: Bearer puccha_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "What is PDPA?", "locale": "en"}'

อ้างอิง API ฉบับเต็มพร้อมสคีมาคำขอ/คำตอบกำลังจะมา

ระหว่างนี้ ลองใช้ API ผ่าน Playground ในแดชบอร์ดของคุณ

ขีดจำกัดอัตรา

แพ็ก คำขอ/วัน ต่อ key/ชั่วโมง เครื่องมือ MCP/ชั่วโมง
Free1006060
Team1,0006060
Business10,0006060
Enterpriseกำหนดเองกำหนดเองกำหนดเอง