TemplateFox

官方

使用TemplateFox生成PDF文档

访问 templatefox.com试用此 MCP赞助

你可以用 TemplateFox MCP 做什么？

  • 从模板生成 PDF — 请求创建如发票或证书等包含动态数据的 PDF，每份文档消耗 1 个积分。
  • 排队后台 PDF 任务 — 异步请求批量或大型 PDF 生成，可选配 webhook 回调。
  • 发现模板及其字段 — 使用 list_templates 查看可用的 PDF，并了解特定模板所需的数据。
  • 跟踪 PDF 任务状态 — 检查异步生成进度，或查看所有最近的任务。
  • 监控账户积分 — 查询剩余积分，或查看使用历史。

文档

MCP（模型上下文协议） 是一个开放标准，让 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 积分。

您可以这样提问：

“使用我的发票模板，为 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 客户端指向该 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 服务器是否正常工作，以排除客户端层面的问题

后续步骤