TemplateFox
chính thứcTạo tài liệu PDF với TemplateFox
Bạn có thể làm gì với TemplateFox MCP?
- Tạo PDF từ mẫu — Yêu cầu trợ lý tạo PDF từ mẫu với dữ liệu động, chẳng hạn như hóa đơn hoặc chứng chỉ.
- Xếp hàng các tác vụ PDF bất đồng bộ — Yêu cầu tạo PDF trong nền cho các tác vụ lớn hoặc theo lô, kèm tùy chọn gọi lại webhook khi hoàn tất.
- Kiểm tra mẫu và trường dữ liệu — Liệt kê các mẫu hiện có và tra cứu những trường dữ liệu mà một mẫu cụ thể yêu cầu trước khi tạo PDF.
- Theo dõi tác vụ PDF — Kiểm tra trạng thái của một tác vụ bất đồng bộ hoặc liệt kê các tác vụ PDF gần đây cùng trạng thái của chúng.
- Kiểm tra tín dụng và giao dịch — Hỏi về số tín dụng còn lại, thông tin tài khoản hoặc lịch sử giao dịch tín dụng.
Tài liệu
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 của 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 số dư tín dụng — tất cả bằng ngôn ngữ tự nhiên.
Điều kiện tiên quyết
- Đã cài đặt Node.js 18+ trên máy của bạn (dành cho
npx) - Khóa API TemplateFox — lấy khóa từ Dashboard 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 (~/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:
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 (phương án thay thế)
npm install -g @templatefox/mcp-server
Sau đó dùng templatefox-mcp-server làm lệnh thay cho npx.
Xác minh thiết lập
Sau khi cài đặt, hãy yêu cầu 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 chính xác, trợ lý sẽ gọi list_templates và trả về danh sách mẫu của bạn. Nếu thấy lỗi, hãy xem phần Khắc phục sự cố bên dưới.
Cấu hình
| Biến môi trường | Bắt buộc | Mô tả |
|---|---|---|
TEMPLATEFOX_API_KEY | Có | Khóa API của bạn (bắt đầu bằng sk_). Lấy khóa từ Dashboard |
TEMPLATEFOX_BASE_URL | Không | Ghi đè URL cơ sở API (mặc định: https://api.templatefox.com) |
Các công cụ hiện có
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. Mỗi PDF tốn 1 tín dụng.
Bạn có thể yêu cầu:
“Tạo hóa đơn cho John Doe, tổng cộng $250, bằng mẫu Invoice của tôi”
“Tạo chứng chỉ hoàn thành khóa học 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 tùy chọn gọi lại webhook. Hữu ích cho các tác vụ lớn hoặc theo lô. Mỗi PDF tốn 1 tín dụng.
Bạn có thể yêu cầu:
“Tạo 10 chứng chỉ ở chế độ nền và báo cho tôi khi hoàn tất”
list_templates
Tìm tất cả mẫu PDF hiện có trong tài khoản của bạn.
Bạn có thể yêu cầu:
“Tôi có những mẫu nào?”
“Hiển thị tất cả mẫu PDF của tôi”
get_template_fields
Lấy các trường và biến của một mẫu cụ thể. Hữu ích để biết mẫu cần những dữ liệu nào trước khi tạo.
Bạn có thể yêu cầu:
“Mẫu Invoice 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 tác vụ tạo PDF bất đồng bộ.
Bạn có thể yêu cầu:
“Tác vụ PDF của tôi đã hoàn tất chưa?”
list_pdf_jobs
Liệt kê tất cả tác vụ tạo PDF bất đồng bộ và trạng thái của chúng.
Bạn có thể yêu cầu:
“Hiển thị các tác vụ PDF gần đây của tôi”
get_account_info
Kiểm tra số tín dụng còn lại và thông tin tài khoản.
Bạn có thể yêu cầu:
“Tôi còn bao nhiêu tín dụng?”
list_transactions
Xem lịch sử giao dịch tín dụng.
Bạn có thể yêu cầu:
“Hiển thị mức sử dụng tín dụng của tôi trong tháng này”
Trường hợp sử dụng
Tạo một tài liệu
Yêu cầu trợ lý AI tạo một PDF với dữ liệu cụ thể. Trợ lý sẽ tìm mẫu, kiểm tra các trường bắt buộc và tạo PDF trong một quy trình:
“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
Trước tiên, hãy hỏi về các mẫu của bạn, sau đó tạo tài liệu khi đã biết những mẫu nào hiện có:
“Liệt kê các mẫu của tôi, sau đó hiển thị các trường của mẫu Receipt”
Kiểm tra trạng thái tài khoản
Theo dõi mức sử dụng 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)
Điểm cuối MCP HTTP được lưu trữ tại https://api.templatefox.com/mcp sẽ sớm ra mắt. Tính năng này cho phép bạn kết nối mà không cần cài đặt gì trên máy — chỉ cần trỏ ứng dụng MCP của bạn đến URL.
Khắc phục sự cố
“Không tìm thấy máy chủ MCP” hoặc lỗi kết nối
- Đảm bảo đã cài đặt Node.js 18+: chạy
node --version - Kiểm tra lệnh
npxhoạt động: chạynpx -y @templatefox/mcp-server --help - Khởi động lại trợ lý AI sau khi cập nhật cấu hình
“Khóa API không hợp lệ” hoặc lỗi xác thực
- Xác minh khóa API bắt đầu bằng
sk_và chưa hết hạn - Kiểm tra khóa trong Dashboard của bạn
- Đảm bảo
TEMPLATEFOX_API_KEYđược đặt trong đúng môi trường (không chỉ trong shell mà còn trong cấu hình máy chủ MCP)
Không thấy công cụ
- Một số ứng dụng lưu bộ nhớ đệm danh sách công cụ MCP — hãy khởi động lại ứng dụng
- 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 ứng dụng
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
- Tài liệu tham khảo API — Tài liệu đầy đủ về các điểm cuối