TemplateFox

MCP Server

Sao chép trang

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 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ườ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ừ Bảng điều khiển
TEMPLATEFOX_BASE_URL	Không	Ghi đè URL cơ sở API (mặc định: https://api.templatefox.com)

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 mỗi PDF.

Những gì bạn có thể yêu cầu:

“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 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 đã xong 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 tháng này”

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 HTTP MCP đượ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ố

”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

”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

Cập nhật lần cuối vào ngày 12 tháng 7 năm 2026

Tiêu chuẩn PDFTải lên S3