TemplateFox
ทางการสร้างเอกสาร PDF ด้วย TemplateFox
คุณทำอะไรได้บ้างด้วย TemplateFox MCP?
- สร้าง PDF จากเทมเพลต — ขอให้ผู้ช่วยสร้าง PDF จากเทมเพลตโดยใช้ข้อมูลแบบไดนามิก เช่น ใบแจ้งหนี้หรือใบรับรอง
- จัดคิวงาน PDF แบบอะซิงโครนัส — ขอให้สร้างไฟล์ในเบื้องหลังสำหรับงานขนาดใหญ่หรืองานแบบชุด พร้อมตัวเลือกให้เรียกใช้ webhook เมื่อเสร็จสิ้น
- ตรวจสอบเทมเพลตและฟิลด์ — แสดงรายการเทมเพลตที่มี และตรวจสอบฟิลด์ที่เทมเพลตที่ระบุต้องใช้ก่อนสร้างไฟล์
- ติดตามงาน PDF — ตรวจสอบสถานะของงานแบบอะซิงโครนัส หรือแสดงรายการงาน PDF ล่าสุดพร้อมสถานะ
- ตรวจสอบเครดิตและธุรกรรม — สอบถามเกี่ยวกับเครดิตคงเหลือ ข้อมูลบัญชี หรือประวัติธุรกรรมเครดิต
เอกสาร
MCP (Model Context Protocol) เป็นมาตรฐานเปิดที่ช่วยให้ผู้ช่วย AI ค้นหาและใช้เครื่องมือภายนอกได้ MCP server ของ TemplateFox มอบเครื่องมือ 8 รายการให้ผู้ช่วย AI ของคุณใช้สร้าง PDF จัดการเทมเพลต และตรวจสอบเครดิตได้ด้วยภาษาธรรมชาติ
ข้อกำหนดเบื้องต้น
- ติดตั้ง Node.js 18+ บนเครื่องของคุณ (สำหรับ
npx) - 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 อื่นทำงานได้หรือไม่ เพื่อแยกปัญหาที่เกิดจากตัวไคลเอนต์
ขั้นตอนถัดไป
- เริ่มต้นใช้งานใน 5 นาที — สร้างเทมเพลตแรกของคุณ
- การผูกข้อมูล — เรียนรู้วิธีส่งข้อมูลแบบไดนามิก
- เอกสารอ้างอิง API — เอกสาร endpoint ฉบับเต็ม