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 服务器

复制页面

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 个积分。

你可以这样问：

“使用我的 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