TemplateFox

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

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

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

การติดตั้ง

Claude Desktop

เพิ่มลงในไฟล์ config ของ 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 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 1 ไฟล์

สิ่งที่คุณสามารถถามได้:

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

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

generate_pdf_async

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

สิ่งที่คุณสามารถถามได้:

"สร้างใบรับรอง 10 ใบในเบื้องหลังและแจ้งให้ฉันทราบเมื่อเสร็จสิ้น"

list_templates

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

สิ่งที่คุณสามารถถามได้:

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

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

get_template_fields

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

สิ่งที่คุณสามารถถามได้:

"เทมเพลตใบแจ้งหนี้ของฉันต้องใช้ฟิลด์อะไรบ้าง?"

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 ชิ้น"

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

ถามเกี่ยวกับเทมเพลตของคุณก่อน จากนั้นจึงสร้างเมื่อคุณรู้ว่ามีอะไรบ้าง:

"แสดงรายการเทมเพลตของฉัน จากนั้นแสดงฟิลด์สำหรับเทมเพลตใบเสร็จ"

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

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

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

เซิร์ฟเวอร์ระยะไกล (เร็วๆ นี้)

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_ และยังไม่หมดอายุ
• ตรวจสอบคีย์ใน Dashboard ของคุณ
• ตรวจสอบว่าได้ตั้งค่า TEMPLATEFOX_API_KEY ในสภาพแวดล้อมที่ถูกต้อง (ไม่ใช่แค่ในเชลล์ของคุณ แต่ต้องอยู่ในการกำหนดค่า MCP server)

เครื่องมือไม่แสดงขึ้นมา

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

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

• เริ่มต้นใช้งานใน 5 นาที — สร้างเทมเพลตแรกของคุณ
• การผูกข้อมูล — เรียนรู้วิธีส่งข้อมูลแบบไดนามิก
• เอกสารอ้างอิง API — เอกสารประกอบ endpoint ทั้งหมด