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 基础 URL（默认：https://api.templatefox.com）

可用工具

MCP 服务器公开了 8 个工具，您的 AI 助手可以调用：

generate_pdf

使用动态数据从模板生成 PDF。每个 PDF 消耗 1 个积分。

您可以这样问：

“使用我的发票模板为 John Doe 生成一张总额为 $250 的发票”

“为 Jane Smith 创建一张结业证书，课程：高级 React”

generate_pdf_async

通过可选的 webhook 回调排队异步 PDF 生成。适用于大型或批量任务。每个 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 客户端指向该 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 参考——完整的端点文档