TemplateFox

官方

使用TemplateFox生成PDF文档

你可以用 TemplateFox MCP 做什么?

  • 从模板生成 PDF — 让你的助手使用动态数据从模板创建 PDF,例如发票或证书。
  • 将 PDF 任务加入异步队列 — 请求在后台生成大型或批量任务,并可选择在完成时通过 webhook 回调通知。
  • 查看模板和字段 — 列出可用模板,并在生成前查询特定模板所需的字段。
  • 跟踪 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 个额度。

你可以这样提问:

“使用我的 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 助手即可监控使用情况:

“我还剩多少额度?显示我最近的交易记录”

远程服务器(即将推出)

托管的 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 服务器是否正常工作,以排除客户端级问题

后续步骤