TemplateFox

официальный

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

Смотреть на templatefox.comПопробовать этот MCPСпонсировано

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

  • Создать PDF из шаблона — Попросите ассистента вызвать generate_pdf с динамическими данными, такими как реквизиты счета или названия сертификатов.
  • Поставить в очередь асинхронную генерацию PDF — Используйте generate_pdf_async для пакетных или фоновых задач с опциональным вебхук-колбэком.
  • Просмотреть доступные шаблоны — Найдите все шаблоны в вашем аккаунте с помощью list_templates.
  • Проверить поля шаблона — Узнайте, какие данные ожидает шаблон перед генерацией, через get_template_fields.
  • Проверить статус асинхронной задачи — Отслеживайте прогресс поставленной в очередь PDF-задачи с помощью get_pdf_job_status.
  • Просмотреть кредиты и транзакции аккаунта — Следите за оставшимися кредитами через get_account_info и просматривайте историю использования с помощью list_transactions.

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

MCP-сервер

MCP (Model Context Protocol) — это открытый стандарт, позволяющий ИИ-ассистентам находить и использовать внешние инструменты. MCP-сервер TemplateFox предоставляет вашему ИИ-ассистенту 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.

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

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

«Покажи список моих шаблонов 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.

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

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

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

generate_pdf_async

Поставить асинхронную генерацию PDF в очередь с опциональным обратным вызовом webhook. Полезно для больших или пакетных заданий. Расходует 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

Посмотреть историю транзакций кредитов.

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

Варианты использования

Генерация одного документа

Попросите ИИ-ассистента сгенерировать один PDF с конкретными данными. Ассистент найдёт шаблон, проверит необходимые поля и сгенерирует PDF в одном потоке:

«Сгенерируй упаковочный лист для заказа №1234, клиент Иван Петров, 3 шт. Widget Blue и 1 шт. Gadget Pro»

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

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

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

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

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

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

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

Размещённая конечная точка 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
  • Перезапустите ИИ-ассистента после обновления конфигурации

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

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

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

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

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

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