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

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

  1. Node.js 18+ ติดตั้งบนเครื่องของคุณ (สำหรับ npx)
  2. คีย์ 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 — เอกสารประกอบปลายทางแบบเต็ม