TemplateFox

ทางการ

สร้างเอกสาร PDF ด้วย TemplateFox

คุณทำอะไรได้บ้างด้วย TemplateFox MCP?

  • สร้าง PDF จากเทมเพลต — ขอให้ผู้ช่วยสร้าง PDF จากเทมเพลตโดยใช้ข้อมูลแบบไดนามิก เช่น ใบแจ้งหนี้หรือใบรับรอง
  • จัดคิวงาน PDF แบบอะซิงโครนัส — ขอให้สร้างไฟล์ในเบื้องหลังสำหรับงานขนาดใหญ่หรืองานแบบชุด พร้อมตัวเลือกให้เรียกใช้ webhook เมื่อเสร็จสิ้น
  • ตรวจสอบเทมเพลตและฟิลด์ — แสดงรายการเทมเพลตที่มี และตรวจสอบฟิลด์ที่เทมเพลตที่ระบุต้องใช้ก่อนสร้างไฟล์
  • ติดตามงาน PDF — ตรวจสอบสถานะของงานแบบอะซิงโครนัส หรือแสดงรายการงาน PDF ล่าสุดพร้อมสถานะ
  • ตรวจสอบเครดิตและธุรกรรม — สอบถามเกี่ยวกับเครดิตคงเหลือ ข้อมูลบัญชี หรือประวัติธุรกรรมเครดิต

เอกสาร

MCP (Model Context Protocol) เป็นมาตรฐานเปิดที่ช่วยให้ผู้ช่วย AI ค้นหาและใช้เครื่องมือภายนอกได้ MCP server ของ TemplateFox มอบเครื่องมือ 8 รายการให้ผู้ช่วย AI ของคุณใช้สร้าง PDF จัดการเทมเพลต และตรวจสอบเครดิตได้ด้วยภาษาธรรมชาติ

ข้อกำหนดเบื้องต้น

  1. ติดตั้ง Node.js 18+ บนเครื่องของคุณ (สำหรับ npx)
  2. TemplateFox API key — รับได้จาก Dashboard (ขึ้นต้นด้วย sk_)

การติดตั้ง

Claude Desktop

เพิ่มรายการต่อไปนี้ในไฟล์กำหนดค่า Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json บน macOS, %APPDATA%\Claude\claude_desktop_config.json บน Windows):

{
  "mcpServers": {
    "templatefox": {
      "command": "npx",
      "args": ["-y", "@templatefox/mcp-server"],
      "env": {
        "TEMPLATEFOX_API_KEY": "sk_your_api_key_here"
      }
    }
  }
}

บันทึกไฟล์แล้วรีสตาร์ต Claude Desktop

Claude Code

claude mcp add templatefox -- npx -y @templatefox/mcp-server

จากนั้นตั้งค่าตัวแปรสภาพแวดล้อม TEMPLATEFOX_API_KEY ใน shell ของคุณ:

export TEMPLATEFOX_API_KEY="sk_your_api_key_here"

Cursor / Windsurf

ใช้คำสั่ง npx เดียวกันในการกำหนดค่า MCP server:

npx -y @templatefox/mcp-server

ตั้งค่า TEMPLATEFOX_API_KEY ในตัวแปรสภาพแวดล้อม

ติดตั้งแบบ Global (ทางเลือก)

npm install -g @templatefox/mcp-server

จากนั้นใช้ templatefox-mcp-server เป็นคำสั่งแทน npx

ตรวจสอบการตั้งค่า

หลังติดตั้งแล้ว ให้ถามผู้ช่วย AI ของคุณว่า:

“แสดงเทมเพลต TemplateFox ของฉัน”

หากกำหนดค่า MCP server ถูกต้อง ผู้ช่วยจะเรียกใช้ list_templates และแสดงรายการเทมเพลตของคุณ หากพบข้อผิดพลาด ให้ดูหัวข้อ การแก้ไขปัญหา ด้านล่าง

การกำหนดค่า

ตัวแปรสภาพแวดล้อมจำเป็นคำอธิบาย
TEMPLATEFOX_API_KEYใช่API key ของคุณ (ขึ้นต้นด้วย sk_) รับได้จาก Dashboard
TEMPLATEFOX_BASE_URLไม่ใช้กำหนด URL ฐานของ API เอง (ค่าเริ่มต้น: https://api.templatefox.com)

เครื่องมือที่ใช้ได้

MCP server มีเครื่องมือ 8 รายการที่ผู้ช่วย AI ของคุณเรียกใช้ได้:

generate_pdf

สร้าง PDF จากเทมเพลตพร้อมข้อมูลแบบไดนามิก มีค่าใช้จ่าย 1 เครดิตต่อ PDF

ตัวอย่างคำขอ:

“สร้างใบแจ้งหนี้สำหรับ John Doe ยอดรวม $250 โดยใช้เทมเพลต Invoice ของฉัน”

“สร้างใบรับรองการสำเร็จหลักสูตรให้ Jane Smith หลักสูตร: Advanced React”

generate_pdf_async

ส่งงานสร้าง PDF แบบอะซิงโครนัสเข้าคิว พร้อมตัวเลือกให้เรียก webhook กลับ เหมาะสำหรับงานขนาดใหญ่หรืองานแบบกลุ่ม มีค่าใช้จ่าย 1 เครดิตต่อ PDF

ตัวอย่างคำขอ:

“สร้างใบรับรอง 10 ใบในเบื้องหลัง แล้วแจ้งฉันเมื่อเสร็จ”

list_templates

ค้นหาเทมเพลต PDF ทั้งหมดที่มีในบัญชีของคุณ

ตัวอย่างคำขอ:

“ฉันมีเทมเพลตอะไรบ้าง?”

“แสดงเทมเพลต PDF ทั้งหมดของฉัน”

get_template_fields

ดูฟิลด์และตัวแปรของเทมเพลตที่ระบุ มีประโยชน์สำหรับตรวจสอบว่าต้องใช้ข้อมูลอะไรบ้างก่อนสร้างเอกสาร

ตัวอย่างคำขอ:

“เทมเพลต Invoice ของฉันต้องใช้ฟิลด์อะไรบ้าง?”

get_pdf_job_status

ตรวจสอบสถานะของงานสร้าง PDF แบบอะซิงโครนัส

ตัวอย่างคำขอ:

“งาน PDF ของฉันเสร็จหรือยัง?”

list_pdf_jobs

แสดงรายการงานสร้าง PDF แบบอะซิงโครนัสทั้งหมดและสถานะของงาน

ตัวอย่างคำขอ:

“แสดงงาน PDF ล่าสุดของฉัน”

get_account_info

ตรวจสอบเครดิตคงเหลือและข้อมูลบัญชี

ตัวอย่างคำขอ:

“ฉันเหลือเครดิตอีกกี่เครดิต?”

list_transactions

ดูประวัติธุรกรรมเครดิต

ตัวอย่างคำขอ:

“แสดงการใช้เครดิตของฉันในเดือนนี้”

กรณีการใช้งาน

สร้างเอกสารหนึ่งฉบับ

ขอให้ผู้ช่วย AI สร้าง PDF หนึ่งฉบับโดยระบุข้อมูล ผู้ช่วยจะค้นหาเทมเพลต ตรวจสอบฟิลด์ที่จำเป็น และสร้าง PDF ให้ในขั้นตอนเดียว:

“สร้างใบจัดส่งสำหรับคำสั่งซื้อ #1234 ลูกค้า John Doe มี Widget Blue 3 ชิ้น และ Gadget Pro 1 ชิ้น”

สำรวจเทมเพลตก่อนสร้างเอกสาร

ถามเกี่ยวกับเทมเพลตของคุณก่อน แล้วค่อยสร้างเอกสารเมื่อทราบว่ามีเทมเพลตใดบ้าง:

“แสดงเทมเพลตของฉัน แล้วแสดงฟิลด์ของเทมเพลต Receipt”

ตรวจสอบสถานะบัญชี

ติดตามการใช้งานได้โดยไม่ต้องออกจากผู้ช่วย AI:

“ฉันเหลือเครดิตอีกกี่เครดิต? แสดงธุรกรรมล่าสุดของฉัน”

Remote server (เร็ว ๆ นี้)

HTTP MCP endpoint แบบโฮสต์ที่ https://api.templatefox.com/mcp จะพร้อมให้ใช้งานเร็ว ๆ นี้ ซึ่งจะช่วยให้คุณเชื่อมต่อได้โดยไม่ต้องติดตั้งอะไรในเครื่อง เพียงตั้งค่า MCP client ให้ชี้ไปที่ URL

การแก้ไขปัญหา

“ไม่พบ MCP server” หรือเกิดข้อผิดพลาดในการเชื่อมต่อ

  • ตรวจสอบว่าติดตั้ง Node.js 18+ แล้ว โดยเรียกใช้ node --version
  • ตรวจสอบว่าคำสั่ง npx ใช้งานได้ โดยเรียกใช้ npx -y @templatefox/mcp-server --help
  • รีสตาร์ตผู้ช่วย AI หลังอัปเดตการกำหนดค่า

“API key ไม่ถูกต้อง” หรือเกิดข้อผิดพลาดในการยืนยันตัวตน

  • ตรวจสอบว่า API key ขึ้นต้นด้วย sk_ และยังไม่หมดอายุ
  • ตรวจสอบ key ใน Dashboard
  • ตรวจสอบว่าตั้งค่า TEMPLATEFOX_API_KEY ในสภาพแวดล้อมที่ถูกต้อง (ไม่ใช่แค่ใน shell แต่ต้องอยู่ในการกำหนดค่า MCP server ด้วย)

ไม่พบเครื่องมือ

  • ไคลเอนต์บางตัวแคชรายการเครื่องมือ MCP ไว้ ให้รีสตาร์ตไคลเอนต์
  • ตรวจสอบว่า MCP server อื่นทำงานได้หรือไม่ เพื่อแยกปัญหาที่เกิดจากตัวไคลเอนต์

ขั้นตอนถัดไป