TemplateFox
официальныйСоздавайте PDF-документы с помощью TemplateFox
Что можно делать с TemplateFox MCP?
- Создание PDF из шаблонов — Попросите ассистента создать PDF из шаблона с динамическими данными, например счёт или сертификат.
- Постановка асинхронных задач на создание PDF в очередь — Запросите фоновое создание для крупных задач или пакетной обработки с возможностью настроить обратный вызов вебхука по завершении.
- Просмотр шаблонов и полей — Получите список доступных шаблонов и узнайте, какие поля нужны конкретному шаблону, прежде чем создавать документ.
- Отслеживание задач на создание PDF — Проверьте статус асинхронной задачи или просмотрите список недавних задач на создание PDF и их статусы.
- Проверка кредитов и транзакций — Узнайте об оставшихся кредитах, информации об аккаунте или истории транзакций с кредитами.
Документация
MCP (Model Context Protocol) — это открытый стандарт, который позволяет ИИ-ассистентам находить внешние инструменты и использовать их. MCP-сервер TemplateFox предоставляет вашему ИИ-ассистенту 8 инструментов для создания PDF-файлов, управления шаблонами и проверки баланса кредитов — всё на естественном языке.
Предварительные требования
- Node.js 18+, установленный на вашем компьютере (для
npx) - Ключ API TemplateFox — получите его в панели управления (начинается с
sk_)
Установка
Claude Desktop
Добавьте конфигурацию в файл настроек Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json в macOS, %APPDATA%\Claude\claude_desktop_config.json в Windows):
{
"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
Затем задайте переменную окружения TEMPLATEFOX_API_KEY в командной оболочке:
export TEMPLATEFOX_API_KEY="sk_your_api_key_here"
Cursor / Windsurf
Используйте ту же команду npx в конфигурации MCP-сервера:
npx -y @templatefox/mcp-server
Задайте TEMPLATEFOX_API_KEY в переменных окружения.
Глобальная установка (альтернативный вариант)
npm install -g @templatefox/mcp-server
Затем используйте templatefox-mcp-server в качестве команды вместо npx.
Проверка настройки
После установки попросите ИИ-ассистента:
«Покажи мои шаблоны TemplateFox»
Если MCP-сервер настроен правильно, ассистент вызовет list_templates и вернёт список ваших шаблонов. Если появится ошибка, см. раздел Устранение неполадок ниже.
Конфигурация
| Переменная окружения | Обязательная | Описание |
|---|---|---|
TEMPLATEFOX_API_KEY | Да | Ваш ключ API (начинается с sk_). Получите его в панели управления |
TEMPLATEFOX_BASE_URL | Нет | Переопределение базового URL API (по умолчанию: https://api.templatefox.com) |
Доступные инструменты
MCP-сервер предоставляет 8 инструментов, которые может вызывать ваш ИИ-ассистент:
generate_pdf
Создание PDF-файла на основе шаблона и динамических данных. Стоимость — 1 кредит за PDF-файл.
Что можно попросить:
«Создай счёт для John Doe на общую сумму $250, используя мой шаблон Invoice»
«Создай сертификат об окончании курса для Jane Smith, курс: Advanced React»
generate_pdf_async
Добавление задачи на асинхронное создание PDF-файла с необязательным обратным вызовом вебхука. Подходит для больших задач и пакетной обработки. Стоимость — 1 кредит за PDF-файл.
Что можно попросить:
«Создай 10 сертификатов в фоновом режиме и сообщи мне, когда закончишь»
list_templates
Просмотр всех доступных PDF-шаблонов в вашем аккаунте.
Что можно попросить:
«Какие у меня есть шаблоны?»
«Покажи все мои PDF-шаблоны»
get_template_fields
Получение полей и переменных для конкретного шаблона. Помогает понять, какие данные нужны шаблону перед созданием PDF-файла.
Что можно попросить:
«Какие поля нужны моему шаблону Invoice?»
get_pdf_job_status
Проверка статуса задачи асинхронного создания PDF-файла.
Что можно попросить:
«Моя задача по созданию PDF уже завершена?»
list_pdf_jobs
Просмотр всех задач асинхронного создания PDF-файлов и их статусов.
Что можно попросить:
«Покажи мои недавние задачи по созданию PDF»
get_account_info
Проверка остатка кредитов и информации об аккаунте.
Что можно попросить:
«Сколько кредитов у меня осталось?»
list_transactions
Просмотр истории транзакций с кредитами.
Что можно попросить:
«Покажи, сколько кредитов я использовал в этом месяце»
Примеры использования
Создание одного документа
Попросите ИИ-ассистента создать PDF-файл с указанными данными. Ассистент найдёт шаблон, проверит обязательные поля и создаст PDF-файл за один проход:
«Создай упаковочный лист для заказа #1234: клиент John Doe, 3x Widget Blue и 1x Gadget Pro»
Просмотр шаблонов перед созданием документа
Сначала спросите о шаблонах, а затем создайте документ, когда узнаете, какие варианты доступны:
«Покажи мои шаблоны, а затем перечисли поля шаблона Receipt»
Проверка состояния аккаунта
Следите за использованием, не переключаясь из ИИ-ассистента:
«Сколько кредитов у меня осталось? Покажи последние транзакции»
Удалённый сервер (скоро)
Скоро появится размещённая HTTP-точка MCP по адресу https://api.templatefox.com/mcp. Она позволит подключаться без локальной установки — достаточно указать URL в настройках MCP-клиента.
Устранение неполадок
«MCP-сервер не найден» или ошибки подключения
- Убедитесь, что установлен Node.js 18+: выполните
node --version - Проверьте, что команда
npxработает: выполнитеnpx -y @templatefox/mcp-server --help - После обновления конфигурации перезапустите ИИ-ассистента
«Недействительный ключ API» или ошибки аутентификации
- Убедитесь, что ключ API начинается с
sk_и срок его действия не истёк - Проверьте ключ в панели управления
- Убедитесь, что
TEMPLATEFOX_API_KEYзадана в правильном окружении (не только в командной оболочке, но и в конфигурации MCP-сервера)
Инструменты не отображаются
- Некоторые клиенты кэшируют списки инструментов MCP — перезапустите клиент
- Проверьте, работают ли другие MCP-серверы, чтобы исключить проблему на стороне клиента
Дальнейшие шаги
- Начало работы за 5 минут — создайте свой первый шаблон
- Привязка данных — узнайте, как передавать динамические данные
- Справочник API — полная документация по конечным точкам