TemplateFox

官方

使用 TemplateFox 生成 PDF 文件

造訪 templatefox.com

你可以用 Template Fox MCP 做什麼？

  • 從範本產生 PDF — 要求您的助理使用動態資料呼叫 generate_pdf，例如：「使用我的發票範本，為 John Doe 產生一張總額 $250 的發票。」
  • 佇列非同步 PDF 產生 — 使用 generate_pdf_async 處理大型或批次 PDF 工作，並可選擇加入 webhook 回呼。
  • 列出您的範本 — 透過 list_templates 擷取您帳戶中所有可用的 PDF 範本。
  • 檢查範本欄位 — 在產生前使用 get_template_fields 檢查特定範本預期的資料欄位。
  • 檢查帳戶點數 — 呼叫 get_account_info 查看您剩餘的點數餘額。
  • 檢視點數交易 — 使用 list_transactions 查看您的點數使用記錄。

文件

MCP Server

複製頁面

MCP Server

MCP (Model Context Protocol) 是一項開放標準，讓 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 基礎 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

取得特定範本的欄位與變數。適合在生成前了解範本需要哪些資料。

“我的 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 助理即可監控用量：

“我還有多少點數？顯示我最近的交易記錄”

遠端伺服器（即將推出）

位於 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 伺服器是否正常運作，以排除客戶端層級的問題

下一步

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

最後更新於 2026 年 7 月 12 日

PDF 標準上傳至 S3