TemplateFox

官方

使用 TemplateFox 生成 PDF 文件

造訪 templatefox.com試用此 MCP贊助

你可以用 TemplateFox MCP 做什麼？

  • 從範本產生 PDF — 請您的助手使用動態資料（如發票詳細資訊或憑證名稱）呼叫 generate_pdf。
  • 佇列非同步 PDF 產生 — 使用 generate_pdf_async 進行批次或背景作業，並可選擇加入 webhook 回呼。
  • 列出可用的範本 — 使用 list_templates 探索您帳戶中的所有範本。
  • 檢查範本欄位 — 在產生前透過 get_template_fields 檢查範本預期的資料。
  • 檢查非同步作業狀態 — 使用 get_pdf_job_status 追蹤已佇列的 PDF 作業進度。
  • 檢視帳戶額度與交易 — 使用 get_account_info 監控剩餘額度，並透過 list_transactions 檢視使用記錄。

文件

MCP 伺服器

MCP（模型上下文協定）是一項開放標準，讓 AI 助理能夠發現並使用外部工具。TemplateFox MCP 伺服器為您的 AI 助理提供 8 個工具，用於生成 PDF、管理範本及查詢點數——一切皆可透過自然語言完成。

  • npm： @templatefox/mcp-server
  • GitHub： TemplateFoxPDF/mcp-server

先決條件

  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 基礎網址（預設：https://api.templatefox.com）

可用工具

MCP 伺服器公開 8 個可供 AI 助理呼叫的工具：

generate_pdf

使用動態資料從範本生成 PDF。每份 PDF 消耗 1 點。

您可以這樣詢問：

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

「為 Jane Smith 建立結業證書，課程：進階 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 個藍色小工具和 1 個專業版小工具」

生成前先探索範本

先生成前先詢問您的範本，了解可用項目後再進行生成：

「列出我的範本，然後顯示收據範本的欄位」

查詢帳戶狀態

無需離開 AI 助理即可監控用量：

「我還剩多少點數？顯示我最近的交易記錄」

遠端伺服器（即將推出）

位於 https://api.templatefox.com/mcp 的託管式 HTTP MCP 端點即將推出。這將讓您無需在本機安裝任何東西即可連線——只需將您的 MCP 客戶端指向該網址即可。

疑難排解

「找不到 MCP 伺服器」或連線錯誤

  • 確認已安裝 Node.js 18+：執行 node --version
  • 檢查 npx 指令是否可正常運作：執行 npx -y @templatefox/mcp-server --help
  • 更新設定後重新啟動您的 AI 助理

「無效的 API 金鑰」或驗證錯誤

  • 確認您的 API 金鑰開頭為 sk_ 且未過期
  • 在您的儀表板中檢查金鑰
  • 確保 TEMPLATEFOX_API_KEY 設定在正確的環境中（不僅是您的 shell，還有 MCP 伺服器設定）

工具未顯示

  • 部分客戶端會快取 MCP 工具清單——請重新啟動客戶端
  • 檢查其他 MCP 伺服器是否正常運作，以排除客戶端層級的問題

下一步

  • 5 分鐘快速入門——建立您的第一個範本
  • 資料繫結——了解如何傳遞動態資料
  • API 參考——完整的端點文件