TemplateFox

официальный

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

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

  • Создание PDF из шаблонов — Попросите ассистента создать PDF из шаблона с динамическими данными, например счёт или сертификат.
  • Постановка асинхронных задач на создание PDF в очередь — Запросите фоновое создание для крупных задач или пакетной обработки с возможностью настроить обратный вызов вебхука по завершении.
  • Просмотр шаблонов и полей — Получите список доступных шаблонов и узнайте, какие поля нужны конкретному шаблону, прежде чем создавать документ.
  • Отслеживание задач на создание 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-файл.

Что можно попросить:

«Создай счёт для 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-серверы, чтобы исключить проблему на стороне клиента

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