TemplateFox

chính thức

Tạo tài liệu PDF với TemplateFox

Xem trên templatefox.comDùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với TemplateFox MCP?

  • Tạo PDF từ mẫu — Yêu cầu trợ lý của bạn gọi generate_pdf với dữ liệu động như chi tiết hóa đơn hoặc tên chứng chỉ.
  • Xếp hàng đợi tạo PDF bất đồng bộ — Sử dụng generate_pdf_async cho các tác vụ hàng loạt hoặc nền với tùy chọn callback webhook.
  • Liệt kê các mẫu có sẵn — Khám phá tất cả các mẫu trong tài khoản của bạn với list_templates.
  • Kiểm tra các trường của mẫu — Kiểm tra dữ liệu mà một mẫu yêu cầu trước khi tạo thông qua get_template_fields.
  • Kiểm tra trạng thái tác vụ bất đồng bộ — Theo dõi tiến trình của một tác vụ PDF đã xếp hàng đợi bằng get_pdf_job_status.
  • Xem tín dụng và giao dịch tài khoản — Theo dõi tín dụng còn lại với get_account_info và xem lại lịch sử sử dụng với list_transactions.

Tài liệu

MCP Server

MCP (Model Context Protocol) là một tiêu chuẩn mở cho phép trợ lý AI khám phá và sử dụng các công cụ bên ngoài. Máy chủ MCP TemplateFox cung cấp cho trợ lý AI của bạn 8 công cụ để tạo PDF, quản lý mẫu và kiểm tra tín dụng — tất cả từ ngôn ngữ tự nhiên.

  • npm: @templatefox/mcp-server
  • GitHub: TemplateFoxPDF/mcp-server

Điều kiện tiên quyết

  1. Node.js 18+ được cài đặt trên máy của bạn (cho npx)
  2. Khóa API TemplateFox — lấy một khóa từ Bảng điều khiển của bạn (bắt đầu bằng sk_)

Cài đặt

Claude Desktop

Thêm vào cấu hình Claude Desktop của bạn (~/Library/Application Support/Claude/claude_desktop_config.json trên macOS, %APPDATA%\Claude\claude_desktop_config.json trên Windows):


{

  "mcpServers": {

    "templatefox": {

      "command": "npx",

      "args": ["-y", "@templatefox/mcp-server"],

      "env": {

        "TEMPLATEFOX_API_KEY": "sk_your_api_key_here"

      }

    }

  }

}

Khởi động lại Claude Desktop sau khi lưu tệp.

Claude Code


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

Sau đó đặt biến môi trường TEMPLATEFOX_API_KEY trong shell của bạn:


export TEMPLATEFOX_API_KEY="sk_your_api_key_here"

Cursor / Windsurf

Sử dụng cùng lệnh npx trong cấu hình máy chủ MCP của bạn:


npx -y @templatefox/mcp-server

Đặt TEMPLATEFOX_API_KEY trong các biến môi trường.

Cài đặt toàn cục (thay thế)


npm install -g @templatefox/mcp-server

Sau đó sử dụng templatefox-mcp-server làm lệnh thay vì npx.

Xác minh thiết lập

Sau khi cài đặt, hãy hỏi trợ lý AI của bạn:

“Liệt kê các mẫu TemplateFox của tôi”

Nếu máy chủ MCP được cấu hình đúng, trợ lý sẽ gọi list_templates và trả về danh sách mẫu của bạn. Nếu bạn thấy lỗi, hãy kiểm tra phần Khắc phục sự cố bên dưới.

Cấu hình

Biến môi trườngBắt buộcMô tả
TEMPLATEFOX_API_KEYCóKhóa API của bạn (bắt đầu bằng sk_). Lấy một khóa từ Bảng điều khiển
TEMPLATEFOX_BASE_URLKhôngGhi đè URL cơ sở API (mặc định: https://api.templatefox.com)

Các công cụ có sẵn

Máy chủ MCP cung cấp 8 công cụ mà trợ lý AI của bạn có thể gọi:

generate_pdf

Tạo PDF từ một mẫu với dữ liệu động. Tốn 1 tín dụng cho mỗi PDF.

Những gì bạn có thể hỏi:

“Tạo hóa đơn cho John Doe, tổng $250, sử dụng mẫu Hóa đơn của tôi”

“Tạo chứng chỉ hoàn thành cho Jane Smith, khóa học: Advanced React”

generate_pdf_async

Xếp hàng tạo PDF bất đồng bộ với callback webhook tùy chọn. Hữu ích cho các công việc lớn hoặc hàng loạt. Tốn 1 tín dụng cho mỗi PDF.

“Tạo 10 chứng chỉ trong nền và thông báo cho tôi khi hoàn tất”

list_templates

Khám phá tất cả các mẫu PDF có sẵn trong tài khoản của bạn.

“Tôi có những mẫu nào?”

“Hiển thị tất cả các mẫu PDF của tôi”

get_template_fields

Lấy các trường và biến cho một mẫu cụ thể. Hữu ích để hiểu dữ liệu mà mẫu mong đợi trước khi tạo.

“Mẫu Hóa đơn của tôi cần những trường nào?”

get_pdf_job_status

Kiểm tra trạng thái của một công việc tạo PDF bất đồng bộ.

“Công việc PDF của tôi đã hoàn tất chưa?”

list_pdf_jobs

Liệt kê tất cả các công việc tạo PDF bất đồng bộ và trạng thái của chúng.

“Hiển thị các công việc PDF gần đây của tôi”

get_account_info

Kiểm tra tín dụng còn lại và thông tin tài khoản.

“Tôi còn bao nhiêu tín dụng?”

list_transactions

Xem lịch sử giao dịch tín dụng.

“Hiển thị mức sử dụng tín dụng của tôi trong tháng này”

Các trường hợp sử dụng

Tạo một tài liệu đơn lẻ

Yêu cầu trợ lý AI của bạn tạo một PDF với dữ liệu cụ thể. Trợ lý khám phá mẫu, kiểm tra các trường bắt buộc và tạo PDF trong một luồng:

“Tạo phiếu đóng gói cho đơn hàng #1234, khách hàng John Doe, 3x Widget Blue và 1x Gadget Pro”

Khám phá mẫu trước khi tạo

Hỏi về các mẫu của bạn trước, sau đó tạo khi bạn biết những gì có sẵn:

“Liệt kê các mẫu của tôi, sau đó hiển thị các trường cho mẫu Biên nhận”

Kiểm tra trạng thái tài khoản

Theo dõi mức sử dụng của bạn mà không cần rời khỏi trợ lý AI:

“Tôi còn bao nhiêu tín dụng? Hiển thị các giao dịch gần đây của tôi”

Máy chủ từ xa (sắp ra mắt)

Một điểm cuối MCP HTTP được lưu trữ tại https://api.templatefox.com/mcp sắp ra mắt. Điều này sẽ cho phép bạn kết nối mà không cần cài đặt gì cục bộ — chỉ cần trỏ máy khách MCP của bạn đến URL.

Khắc phục sự cố

Lỗi ”Không tìm thấy máy chủ MCP” hoặc lỗi kết nối

  • Đảm bảo Node.js 18+ được cài đặt: chạy node --version
  • Kiểm tra xem lệnh npx có hoạt động không: chạy npx -y @templatefox/mcp-server --help
  • Khởi động lại trợ lý AI của bạn sau khi cập nhật cấu hình

Lỗi ”Khóa API không hợp lệ” hoặc lỗi xác thực

  • Xác minh khóa API của bạn bắt đầu bằng sk_ và chưa hết hạn
  • Kiểm tra khóa trong Bảng điều khiển của bạn
  • Đảm bảo TEMPLATEFOX_API_KEY được đặt trong môi trường chính xác (không chỉ shell của bạn, mà cả cấu hình máy chủ MCP)

Công cụ không hiển thị

  • Một số máy khách lưu trữ danh sách công cụ MCP — khởi động lại máy khách
  • Kiểm tra xem các máy chủ MCP khác có hoạt động không để loại trừ sự cố ở cấp máy khách

Các bước tiếp theo

  • Bắt đầu trong 5 phút — Tạo mẫu đầu tiên của bạn
  • Liên kết dữ liệu — Tìm hiểu cách truyền dữ liệu động
  • Tham khảo API — Tài liệu đầy đủ về điểm cuối