TemplateFox

официальный

Создавайте PDF-документы с помощью TemplateFox

Смотреть на templatefox.com

Что можно делать с Template Fox MCP?

  • Создать PDF из шаблона — Попросите ассистента вызвать generate_pdf с динамическими данными, например: «Создайте счет для Джона Доу на сумму $250, используя мой шаблон Invoice».
  • Поставить в очередь асинхронную генерацию PDF — Используйте generate_pdf_async для обработки больших или пакетных задач PDF с опциональным обратным вызовом вебхука.
  • Список ваших шаблонов — Получите все доступные шаблоны PDF в вашей учетной записи через list_templates.
  • Проверить поля шаблона — Проверьте, какие поля данных ожидает конкретный шаблон перед генерацией с помощью get_template_fields.
  • Проверить кредиты аккаунта — Вызовите get_account_info, чтобы увидеть остаток кредитов.
  • Просмотреть транзакции кредитов — Используйте list_transactions для просмотра истории использования кредитов.

Документация

MCP Server

Скопировать страницу

MCP Server

MCP (Model Context Protocol) — это открытый стандарт, позволяющий AI-ассистентам находить и использовать внешние инструменты. MCP-сервер TemplateFox предоставляет вашему AI-ассистенту 8 инструментов для генерации PDF, управления шаблонами и проверки кредитов — и всё это на естественном языке.

  • npm: @templatefox/mcp-server
  • GitHub: TemplateFoxPDF/mcp-server

Предварительные требования

  1. Node.js 18+, установленная на вашем компьютере (для npx)
  2. 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.

Проверка настройки

После установки спросите вашего AI-ассистента:

«Покажи список моих шаблонов TemplateFox»

Если MCP-сервер настроен правильно, ассистент вызовет list_templates и вернёт список ваших шаблонов. Если появится ошибка, обратитесь к разделу «Устранение неполадок» ниже.

Конфигурация

Переменная окруженияОбязательноОписание
TEMPLATEFOX_API_KEYДаВаш API-ключ (начинается с sk_). Получите его в Панели управления
TEMPLATEFOX_BASE_URLНетПереопределение базового URL API (по умолчанию: https://api.templatefox.com)

Доступные инструменты

MCP-сервер предоставляет 8 инструментов, которые может вызывать ваш AI-ассистент:

generate_pdf

Генерация PDF из шаблона с динамическими данными. Расходует 1 кредит за PDF.

Примеры запросов:

«Создай счёт для Ивана Петрова на сумму 250 долларов, используя мой шаблон Invoice»

«Создай сертификат о прохождении для Анны Смирновой, курс: Advanced React»

generate_pdf_async

Постановка асинхронной генерации PDF в очередь с опциональным вебхуком обратного вызова. Полезно для больших или пакетных задач. Расходует 1 кредит за PDF.

«Сгенерируй 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, клиент Иван Петров, 3 шт. Widget Blue и 1 шт. Gadget Pro»

Изучение шаблонов перед генерацией

Сначала спросите о шаблонах, а затем генерируйте, когда будете знать, что доступно:

«Покажи список моих шаблонов, затем покажи поля для шаблона Receipt»

Проверка состояния аккаунта

Отслеживайте использование, не покидая AI-ассистента:

«Сколько у меня осталось кредитов? Покажи мои последние транзакции»

Удалённый сервер (скоро)

Размещённая HTTP-точка MCP по адресу https://api.templatefox.com/mcp появится в ближайшее время. Это позволит подключаться без локальной установки — просто укажите URL в вашем MCP-клиенте.

Устранение неполадок

Ошибки «MCP server not found» или ошибки подключения

  • Убедитесь, что установлена Node.js 18+: выполните node --version
  • Проверьте, работает ли команда npx: выполните npx -y @templatefox/mcp-server --help
  • Перезапустите AI-ассистента после обновления конфигурации

Ошибки «Invalid API key» или ошибки аутентификации

  • Убедитесь, что ваш API-ключ начинается с sk_ и не истёк
  • Проверьте ключ в Панели управления
  • Убедитесь, что TEMPLATEFOX_API_KEY задана в правильном окружении (не только в вашей оболочке, но и в конфигурации MCP-сервера)

Инструменты не отображаются

  • Некоторые клиенты кэшируют списки инструментов MCP — перезапустите клиент
  • Проверьте, работают ли другие MCP-серверы, чтобы исключить проблему на уровне клиента

Дальнейшие шаги

  • Начало работы за 5 минут — Создайте свой первый шаблон
  • Привязка данных — Узнайте, как передавать динамические данные
  • Справочник API — Полная документация по конечным точкам

Последнее обновление: 12 июля 2026 г.

Стандарты PDFЗагрузка в S3