TemplateFox

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.

Đ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. Một khóa API TemplateFox — lấy 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 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 (phương án 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 cài đặt

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ườ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 từ Dashboard của bạn
TEMPLATEFOX_BASE_URL	Không	Ghi đè URL gốc 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ẫu với dữ liệu động. Tốn 1 tín dụng cho mỗi PDF.

Bạn có thể yêu cầu:

"Tạo hóa đơn cho John Doe, tổng $250, sử dụng mẫu Invoice 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 đợi tạo PDF không đồng bộ với callback webhook tùy chọn. Hữu ích cho các tác vụ lớn hoặc hàng loạt. Tốn 1 tín dụng cho mỗi PDF.

Bạn có thể yêu cầu:

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

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.

Bạn có thể yêu cầu:

"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.

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 không đồng bộ.

Bạn có thể yêu cầu:

"Tác vụ PDF của tôi đã hoàn thành chưa?"

list_pdf_jobs

Liệt kê tất cả các tác vụ tạo PDF không đồ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 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"

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ý sẽ khám phá 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

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 Receipt"

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 endpoint HTTP MCP được lưu trữ tại https://api.templatefox.com/mcp sẽ sớm ra mắt. Điều này cho phép bạn kết nối mà không cần cài đặt bất cứ thứ 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ố

"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 lệnh npx hoạt độ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

"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 Dashboard của bạn
• Đảm bảo TEMPLATEFOX_API_KEY được đặt trong môi trường chính xác (không chỉ trong shell của bạn, mà còn trong 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 bộ nhớ đệm danh sách công cụ MCP — hãy 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
• Tài liệu tham khảo API — Tài liệu endpoint đầy đủ