TemplateFox
官方使用 TemplateFox 生成 PDF 文件
你可以用 TemplateFox MCP 做什麼?
- 從範本產生 PDF — 請助理使用動態資料從範本建立 PDF,例如發票或證書。
- 將非同步 PDF 工作加入佇列 — 為大型或批次工作要求在背景產生,並可選擇在完成時透過 webhook 回呼通知。
- 檢視範本與欄位 — 列出可用範本,並在產生前查詢特定範本所需的欄位。
- 追蹤 PDF 工作 — 查看非同步工作的狀態,或列出近期 PDF 工作及其狀態。
- 查看點數與交易紀錄 — 詢問剩餘點數、帳戶資訊或點數交易紀錄。
文件
MCP (Model Context Protocol) 是一項開放標準,可讓 AI 助理探索並使用外部工具。TemplateFox MCP 伺服器提供 8 種工具,讓您的 AI 助理透過自然語言產生 PDF、管理範本及查詢點數。
先決條件
- 在您的電腦上安裝 Node.js 18+(適用於
npx) - TemplateFox API 金鑰 — 請從您的控制面板取得(開頭為
sk_)
安裝
Claude Desktop
將以下內容新增至您的 Claude Desktop 設定檔(macOS 為 ~/Library/Application Support/Claude/claude_desktop_config.json,Windows 為 %APPDATA%\Claude\claude_desktop_config.json):
{
"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
接著在您的 shell 中設定 TEMPLATEFOX_API_KEY 環境變數:
export TEMPLATEFOX_API_KEY="sk_your_api_key_here"
Cursor / Windsurf
在您的 MCP 伺服器設定中使用相同的 npx 命令:
npx -y @templatefox/mcp-server
在環境變數中設定 TEMPLATEFOX_API_KEY。
全域安裝(替代方式)
npm install -g @templatefox/mcp-server
接著使用 templatefox-mcp-server 作為命令,而非 npx。
驗證設定
安裝完成後,詢問您的 AI 助理:
「列出我的 TemplateFox 範本」
如果 MCP 伺服器設定正確,助理會呼叫 list_templates 並傳回您的範本清單。如果出現錯誤,請查看下方的疑難排解章節。
設定
| 環境變數 | 必要 | 說明 |
|---|---|---|
TEMPLATEFOX_API_KEY | 是 | 您的 API 金鑰(開頭為 sk_)。請從您的控制面板取得 |
TEMPLATEFOX_BASE_URL | 否 | 覆寫 API 基底 URL(預設值:https://api.templatefox.com) |
可用工具
MCP 伺服器提供 8 種工具,供您的 AI 助理呼叫:
generate_pdf
使用動態資料從範本產生 PDF。每份 PDF 消耗 1 點。
您可以這樣詢問:
「使用我的 Invoice 範本,為 John Doe 產生一張總額為 $250 的發票」
「為 Jane Smith 產生一張結業證書,課程:Advanced React」
generate_pdf_async
將非同步 PDF 產生工作加入佇列,並可選擇設定 webhook 回呼。適用於大型或批次工作。每份 PDF 消耗 1 點。
您可以這樣詢問:
「在背景產生 10 張證書,完成後通知我」
list_templates
探索您帳戶中所有可用的 PDF 範本。
您可以這樣詢問:
「我有哪些範本?」
「顯示我所有的 PDF 範本」
get_template_fields
取得特定範本的欄位和變數。產生 PDF 前,可用來了解範本需要哪些資料。
您可以這樣詢問:
「我的 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_開頭,且尚未過期 - 在您的控制面板中檢查金鑰
- 確認已在正確的環境中設定
TEMPLATEFOX_API_KEY(不只是 shell,也要設定在 MCP 伺服器設定中)
工具未顯示
- 有些用戶端會快取 MCP 工具清單 — 請重新啟動用戶端
- 檢查其他 MCP 伺服器是否正常運作,以排除用戶端層級的問題