TemplateFox

官方

使用 TemplateFox 生成 PDF 文件

造訪 templatefox.com試用此 MCP贊助

你可以用 TemplateFox MCP 做什麼？

  • 從範本產生 PDF — 要求建立如發票或證書等含動態資料的 PDF，每份文件花費 1 點額度。
  • 排入背景 PDF 工作 — 非同步請求批次或大量 PDF 產生，可選擇搭配 webhook 回呼。
  • 探索範本及其欄位 — 使用 list_templates 查看可用的 PDF，並了解特定範本預期的資料。
  • 追蹤 PDF 工作狀態 — 檢查非同步產生的進度，或檢視所有近期工作。
  • 監控帳戶額度 — 查詢剩餘額度，或檢視使用歷史記錄。

文件

MCP (Model Context Protocol) 是一個開放標準，讓 AI 助手能夠探索並使用外部工具。TemplateFox MCP 伺服器為您的 AI 助手提供 8 個工具，可用於生成 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 點額度。

您可以這樣詢問：

「為 John Doe 生成一份發票，總額 $250，使用我的發票模板」

「為 Jane Smith 建立一份完成證書，課程：Advanced React」

generate_pdf_async

排入非同步 PDF 生成佇列，可選用 webhook 回呼。適用於大型或批次作業。每份 PDF 消耗 1 點額度。

您可以這樣詢問：

「在背景生成 10 份證書，完成時通知我」

list_templates

探索您帳戶中所有可用的 PDF 模板。

您可以這樣詢問：

「我有哪些模板？」

「顯示我所有的 PDF 模板」

get_template_fields

取得特定模板的欄位與變數。有助於在生成前了解模板預期的資料。

您可以這樣詢問：

「我的發票模板需要哪些欄位？」

get_pdf_job_status

檢查非同步 PDF 生成作業的狀態。

您可以這樣詢問：

「我的 PDF 作業完成了嗎？」

list_pdf_jobs

列出所有非同步 PDF 生成作業及其狀態。

您可以這樣詢問：

「顯示我最近的 PDF 作業」

get_account_info

檢查剩餘額度與帳戶資訊。

您可以這樣詢問：

「我還剩多少額度？」

list_transactions

檢視額度交易紀錄。

您可以這樣詢問：

「顯示我這個月的額度使用情況」

使用情境

生成單一文件

請您的 AI 助手使用特定資料生成一份 PDF。助手會探索模板、檢查必要欄位，並在一次流程中生成 PDF：

「為訂單 #1234 生成一份裝箱單，客戶 John Doe，3 個 Widget Blue 和 1 個 Gadget Pro」

生成前先探索模板

先詢問您的模板，待了解可用項目後再進行生成：

「列出我的模板，然後顯示 Receipt 模板的欄位」

檢查帳戶狀態

無需離開您的 AI 助手即可監控使用情況：

「我還剩多少額度？顯示我最近的交易紀錄」

遠端伺服器（即將推出）

位於 https://api.templatefox.com/mcp 的託管 HTTP 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 伺服器是否正常運作，以排除用戶端層級的問題

後續步驟