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

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

REST API สำหรับงานอัตโนมัติ MCP server สำหรับผู้ช่วย AI ทุกค่าย ทั้ง Claude, Codex, Gemini, Cursor, VS Code และ Windsurf คลังความรู้เดียวกัน สิทธิ์การเข้าถึงเดียวกัน

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

MCP Server

เชื่อมผู้ช่วย AI ที่รองรับ MCP ไม่ว่าจะเป็น Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI หรือ Gemini CLI เข้ากับคลังความรู้ของคุณโดยตรง ค้นหา ตอบคำถาม และตรวจเอกสารได้ในตัว ภายใต้สิทธิ์ระดับเอกสารเดียวกับทีมของคุณ

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

REST API

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

ค้นหา, ตอบ, แชท (สตรีม SSE)
เอกสาร บทสนทนา และตั๋วงาน
เนื้อหาศูนย์ช่วยเหลือเป็น JSON (GET /api/content)
กำหนดขอบเขต key รายendpoint, IP allowlist และจำกัดอัตรา

ตั้งค่า MCP

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

สร้าง API key

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

เชื่อมต่อเครื่องมือ 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 และเอกสารจะปรากฏในรายการเครื่องมือ

เริ่มใช้งาน

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

puccha_search

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

puccha_answer

ข้อมูลอ้างอิงพร้อมที่มา ให้ผู้ช่วยของคุณใช้ตอบ

puccha_list_docs

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

puccha_get_doc

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

puccha_persona_* · puccha_publish

เมื่อ key มีสิทธิ์ด้านบุคลิก: สร้างบุคลิกและขั้นตอนงาน นำเข้า Skill เพิ่มความรู้ ประเมิน และเผยแพร่ (บันทึกเป็นฉบับร่างก่อน และใช้เกณฑ์การเผยแพร่ขององค์กร)

Agent Skill

หากใช้ Agent Skills (Claude, ChatGPT/Codex, Cursor, Gemini CLI) ให้เพิ่ม Skill ของ Puccha Skill นี้กำหนดให้ผู้ช่วยตอบจาก Puccha พร้อมอ้างอิง ทำตามขั้นตอนงานขององค์กร และแจ้งตรงๆ เมื่อ Puccha ไม่มีคำตอบ โดยตัว Skill ไม่บรรจุความรู้ใดๆ

ดาวน์โหลด SKILL.md

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"}'

ทดลองเรียกแต่ละ endpoint กับคลังความรู้ของคุณได้ที่ Playground ในแดชบอร์ด app.puccha.ai →

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

แพ็ก	คำขอ API + MCP ที่รวมในแพ็กเกจ / เดือน	คำขอต่อ key / ชั่วโมง	เทิร์นแชต / วัน (เพดานป้องกันการใช้ผิด)
Free	นับรวมในเพดาน 100 การตอบสำเร็จ	60	30
Team	5,000	60	500
Business	25,000	60	5,000
Enterprise	125,000+	60	50,000