TemplateFox
ทางการสร้างเอกสาร PDF ด้วย TemplateFox
คุณทำอะไรได้บ้างด้วย TemplateFox MCP?
- สร้าง PDF จากเทมเพลต — ให้ผู้ช่วยของคุณเรียกใช้
generate_pdfพร้อมข้อมูลแบบไดนามิก เช่น รายละเอียดใบแจ้งหนี้หรือชื่อใบรับรอง - จัดคิวการสร้าง PDF แบบอะซิงโครนัส — ใช้
generate_pdf_asyncสำหรับงานแบบแบตช์หรืองานพื้นหลัง พร้อมตัวเลือกการแจ้งกลับผ่านเว็บฮุค - แสดงรายการเทมเพลตที่มีอยู่ — ค้นหาเทมเพลตทั้งหมดในบัญชีของคุณด้วย
list_templates - ตรวจสอบฟิลด์ของเทมเพลต — ตรวจสอบข้อมูลที่เทมเพลตคาดหวังก่อนสร้างด้วย
get_template_fields - ตรวจสอบสถานะงานแบบอะซิงโครนัส — ติดตามความคืบหน้าของงาน PDF ที่อยู่ในคิวโดยใช้
get_pdf_job_status - ดูเครดิตและธุรกรรมของบัญชี — ตรวจสอบเครดิตคงเหลือด้วย
get_account_infoและทบทวนประวัติการใช้งานด้วยlist_transactions
เอกสาร
MCP Server
MCP (Model Context Protocol) เป็นมาตรฐานเปิดที่ช่วยให้ผู้ช่วย AI ค้นพบและใช้เครื่องมือภายนอกได้ เซิร์ฟเวอร์ MCP ของ TemplateFox มอบเครื่องมือ 8 อย่างให้ผู้ช่วย AI ของคุณสำหรับสร้าง PDF, จัดการเทมเพลต และตรวจสอบเครดิต — ทั้งหมดนี้ด้วยภาษาธรรมชาติ
- npm:
@templatefox/mcp-server - GitHub: TemplateFoxPDF/mcp-server
ข้อกำหนดเบื้องต้น
- Node.js 18+ ติดตั้งบนเครื่องของคุณ (สำหรับ
npx) - คีย์ API ของ TemplateFox — รับได้จาก 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 ในเชลล์ของคุณ:
export TEMPLATEFOX_API_KEY="sk_your_api_key_here"
Cursor / Windsurf
ใช้คำสั่ง npx เดียวกันในการกำหนดค่าเซิร์ฟเวอร์ MCP ของคุณ:
npx -y @templatefox/mcp-server
ตั้งค่า TEMPLATEFOX_API_KEY ในตัวแปรสภาพแวดล้อม
การติดตั้งแบบ Global (ทางเลือก)
npm install -g @templatefox/mcp-server
จากนั้นใช้ templatefox-mcp-server เป็นคำสั่งแทน npx
ตรวจสอบการตั้งค่า
หลังการติดตั้ง ให้ถามผู้ช่วย AI ของคุณว่า:
“แสดงรายการเทมเพลต TemplateFox ของฉัน”
หากกำหนดค่าเซิร์ฟเวอร์ MCP ถูกต้อง ผู้ช่วยจะเรียก list_templates และส่งคืนรายการเทมเพลตของคุณ หากพบข้อผิดพลาด ให้ตรวจสอบส่วนการแก้ไขปัญหาด้านล่าง
การกำหนดค่า
| ตัวแปรสภาพแวดล้อม | จำเป็น | คำอธิบาย |
|---|---|---|
| TEMPLATEFOX_API_KEY | ใช่ | คีย์ API ของคุณ (ขึ้นต้นด้วย sk_) รับได้จาก Dashboard ของคุณ |
| TEMPLATEFOX_BASE_URL | ไม่ใช่ | แทนที่ URL ฐานของ API (ค่าเริ่มต้น: https://api.templatefox.com) |
เครื่องมือที่พร้อมใช้งาน
เซิร์ฟเวอร์ MCP มีเครื่องมือ 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, 3x Widget Blue และ 1x Gadget Pro”
สำรวจเทมเพลตก่อนสร้าง
ถามเกี่ยวกับเทมเพลตของคุณก่อน จากนั้นจึงสร้างเมื่อคุณรู้ว่ามีอะไรพร้อมใช้งาน:
“แสดงรายการเทมเพลตของฉัน แล้วแสดงฟิลด์สำหรับเทมเพลต Receipt”
ตรวจสอบสถานะบัญชี
ติดตามการใช้งานของคุณโดยไม่ต้องออกจากผู้ช่วย AI:
“ฉันเหลือเครดิตเท่าไหร่? แสดงธุรกรรมล่าสุดของฉัน”
เซิร์ฟเวอร์ระยะไกล (เร็วๆ นี้)
ปลายทาง HTTP MCP แบบโฮสต์ที่ https://api.templatefox.com/mcp กำลังจะมาเร็วๆ นี้ ซึ่งจะช่วยให้คุณเชื่อมต่อได้โดยไม่ต้องติดตั้งอะไรในเครื่อง — เพียงชี้ไคลเอนต์ MCP ของคุณไปที่ URL
การแก้ไขปัญหา
ข้อผิดพลาด “ไม่พบเซิร์ฟเวอร์ MCP” หรือการเชื่อมต่อ
- ตรวจสอบว่าติดตั้ง Node.js 18+ แล้ว: รัน
node --version - ตรวจสอบว่าคำสั่ง
npxทำงานได้: รันnpx -y @templatefox/mcp-server --help - รีสตาร์ทผู้ช่วย AI ของคุณหลังจากอัปเดตการกำหนดค่า
ข้อผิดพลาด “คีย์ API ไม่ถูกต้อง” หรือการรับรองความถูกต้อง
- ตรวจสอบว่าคีย์ API ของคุณขึ้นต้นด้วย
sk_และยังไม่หมดอายุ - ตรวจสอบคีย์ใน Dashboard ของคุณ
- ตรวจสอบว่า
TEMPLATEFOX_API_KEYถูกตั้งค่าในสภาพแวดล้อมที่ถูกต้อง (ไม่ใช่แค่ในเชลล์ของคุณ แต่ในการกำหนดค่าเซิร์ฟเวอร์ MCP)
เครื่องมือไม่ปรากฏ
- ไคลเอนต์บางตัวแคชรายการเครื่องมือ MCP — รีสตาร์ทไคลเอนต์
- ตรวจสอบว่าเซิร์ฟเวอร์ MCP อื่นทำงานได้หรือไม่เพื่อตัดปัญหาที่ระดับไคลเอนต์
ขั้นตอนถัดไป
- เริ่มต้นใน 5 นาที — สร้างเทมเพลตแรกของคุณ
- การผูกข้อมูล — เรียนรู้วิธีส่งข้อมูลแบบไดนามิก
- เอกสารอ้างอิง API — เอกสารประกอบปลายทางแบบเต็ม