TemplateFox

официальный

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

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

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

  • Генерация PDF-файлов из шаблонов — Запросите создание PDF-файла, например счёта или сертификата, с динамическими данными, стоимость — 1 кредит за документ.
  • Постановка фоновых PDF-задач в очередь — Запросите пакетную или крупномасштабную генерацию PDF-файлов в асинхронном режиме, опционально с webhook-обратным вызовом.
  • Обнаружение шаблонов и их полей — Используйте list_templates, чтобы увидеть доступные PDF-файлы и узнать, какие данные ожидает конкретный шаблон.
  • Отслеживание статуса PDF-задач — Проверяйте ход выполнения асинхронной генерации или просматривайте все недавние задачи.
  • Мониторинг кредитов аккаунта — Узнавайте о количестве оставшихся кредитов или просматривайте историю использования.

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

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

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

  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 с опциональным обратным вызовом вебхука. Полезно для больших или пакетных заданий. Стоимость — 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, клиент Джон Доу, 3x Widget Blue и 1x Gadget Pro»

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

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

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

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

Следите за использованием, не покидая вашего ИИ-ассистента:

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

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

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

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

«MCP-сервер не найден» или ошибки подключения

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

«Недействительный API-ключ» или ошибки аутентификации

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

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

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

Следующие шаги