TemplateFox
官方使用TemplateFox生成PDF文档
你可以用 TemplateFox MCP 做什么?
- 从模板生成 PDF — 让你的助手使用动态数据从模板创建 PDF,例如发票或证书。
- 将 PDF 任务加入异步队列 — 请求在后台生成大型或批量任务,并可选择在完成时通过 webhook 回调通知。
- 查看模板和字段 — 列出可用模板,并在生成前查询特定模板所需的字段。
- 跟踪 PDF 任务 — 查看异步任务的状态,或列出最近的 PDF 任务及其状态。
- 查看额度和交易记录 — 查询剩余额度、账户信息或额度交易历史。
文档
MCP(Model Context Protocol) 是一项开放标准,可让 AI 助手发现并使用外部工具。TemplateFox MCP 服务器为你的 AI 助手提供 8 种工具,可通过自然语言生成 PDF、管理模板和查看额度。
前置条件
- 在你的计算机上安装 Node.js 18+(用于
npx) - 一个 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 服务器是否正常工作,以排除客户端级问题