TemplateFox

官方

使用 TemplateFox 生成 PDF 文件

你可以用 TemplateFox MCP 做什麼?

  • 從範本產生 PDF — 請助理使用動態資料從範本建立 PDF,例如發票或證書。
  • 將非同步 PDF 工作加入佇列 — 為大型或批次工作要求在背景產生,並可選擇在完成時透過 webhook 回呼通知。
  • 檢視範本與欄位 — 列出可用範本,並在產生前查詢特定範本所需的欄位。
  • 追蹤 PDF 工作 — 查看非同步工作的狀態,或列出近期 PDF 工作及其狀態。
  • 查看點數與交易紀錄 — 詢問剩餘點數、帳戶資訊或點數交易紀錄。

文件

MCP (Model Context Protocol) 是一項開放標準,可讓 AI 助理探索並使用外部工具。TemplateFox MCP 伺服器提供 8 種工具,讓您的 AI 助理透過自然語言產生 PDF、管理範本及查詢點數。

先決條件

  1. 在您的電腦上安裝 Node.js 18+(適用於 npx)
  2. 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 伺服器是否正常運作,以排除用戶端層級的問題

後續步驟