TemplateFox

oficial

Gere documentos PDF com TemplateFox

O que você pode fazer com TemplateFox MCP?

  • Gerar PDFs a partir de modelos — Peça ao seu assistente para criar um PDF a partir de um modelo com dados dinâmicos, como uma fatura ou um certificado.
  • Enfileirar tarefas assíncronas de PDF — Solicite a geração em segundo plano para tarefas grandes ou em lote, com a opção de receber um callback de webhook quando forem concluídas.
  • Inspecionar modelos e campos — Liste os modelos disponíveis e consulte os campos esperados por um modelo específico antes de gerar.
  • Acompanhar tarefas de PDF — Verifique o status de uma tarefa assíncrona ou liste as tarefas de PDF recentes e seus status.
  • Consultar créditos e transações — Pergunte sobre os créditos restantes, as informações da conta ou o histórico de transações de créditos.

Documentação

MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA descubram e usem ferramentas externas. O servidor MCP do TemplateFox oferece ao seu assistente de IA 8 ferramentas para gerar PDFs, gerenciar modelos e consultar créditos — tudo em linguagem natural.

Pré-requisitos

  1. Node.js 18+ instalado na sua máquina (para npx)
  2. Uma chave de API do TemplateFox — obtenha uma no seu Dashboard (começa com sk_)

Instalação

Claude Desktop

Adicione ao arquivo de configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS, %APPDATA%\Claude\claude_desktop_config.json no Windows):

{
  "mcpServers": {
    "templatefox": {
      "command": "npx",
      "args": ["-y", "@templatefox/mcp-server"],
      "env": {
        "TEMPLATEFOX_API_KEY": "sk_your_api_key_here"
      }
    }
  }
}

Reinicie o Claude Desktop depois de salvar o arquivo.

Claude Code

claude mcp add templatefox -- npx -y @templatefox/mcp-server

Em seguida, defina a variável de ambiente TEMPLATEFOX_API_KEY no seu shell:

export TEMPLATEFOX_API_KEY="sk_your_api_key_here"

Cursor / Windsurf

Use o mesmo comando npx na configuração do servidor MCP:

npx -y @templatefox/mcp-server

Defina TEMPLATEFOX_API_KEY nas variáveis de ambiente.

Instalação global (alternativa)

npm install -g @templatefox/mcp-server

Em seguida, use templatefox-mcp-server como comando em vez de npx.

Verificar a configuração

Após a instalação, pergunte ao seu assistente de IA:

“Liste meus modelos do TemplateFox”

Se o servidor MCP estiver configurado corretamente, o assistente chamará list_templates e retornará sua lista de modelos. Se aparecer um erro, consulte a seção Solução de problemas abaixo.

Configuração

Variável de ambienteObrigatóriaDescrição
TEMPLATEFOX_API_KEYSimSua chave de API (começa com sk_). Obtenha uma no seu Dashboard
TEMPLATEFOX_BASE_URLNãoSubstitui a URL base da API (padrão: https://api.templatefox.com)

Ferramentas disponíveis

O servidor MCP disponibiliza 8 ferramentas que seu assistente de IA pode chamar:

generate_pdf

Gera um PDF a partir de um modelo com dados dinâmicos. Custa 1 crédito por PDF.

O que você pode pedir:

“Gere uma fatura para John Doe, total de $250, usando meu modelo Invoice”

“Crie um certificado de conclusão para Jane Smith, curso: Advanced React”

generate_pdf_async

Enfileira a geração assíncrona de PDFs com um callback de webhook opcional. Útil para tarefas grandes ou em lote. Custa 1 crédito por PDF.

O que você pode pedir:

“Gere 10 certificados em segundo plano e me avise quando terminar”

list_templates

Descobre todos os modelos de PDF disponíveis na sua conta.

O que você pode pedir:

“Quais modelos eu tenho?”

“Mostre todos os meus modelos de PDF”

get_template_fields

Obtém os campos e as variáveis de um modelo específico. Útil para entender quais dados um modelo espera antes de gerar o documento.

O que você pode pedir:

“Quais campos meu modelo Invoice precisa?”

get_pdf_job_status

Verifica o status de uma tarefa assíncrona de geração de PDF.

O que você pode pedir:

“Minha tarefa de PDF já terminou?”

list_pdf_jobs

Lista todas as tarefas assíncronas de geração de PDF e seus status.

O que você pode pedir:

“Mostre minhas tarefas de PDF recentes”

get_account_info

Consulta os créditos restantes e as informações da conta.

O que você pode pedir:

“Quantos créditos ainda tenho?”

list_transactions

Exibe o histórico de transações de créditos.

O que você pode pedir:

“Mostre meu uso de créditos neste mês”

Casos de uso

Gerar um único documento

Peça ao seu assistente de IA para gerar um PDF com dados específicos. O assistente encontra o modelo, verifica os campos obrigatórios e gera o PDF em um único fluxo:

“Gere uma guia de remessa para o pedido #1234, cliente John Doe, 3x Widget Blue e 1x Gadget Pro”

Explorar modelos antes de gerar

Pergunte primeiro sobre seus modelos e, depois de saber quais estão disponíveis, gere o documento:

“Liste meus modelos e depois mostre os campos do modelo Receipt”

Consultar o status da conta

Acompanhe seu uso sem sair do assistente de IA:

“Quantos créditos ainda tenho? Mostre minhas transações recentes”

Servidor remoto (em breve)

Um endpoint MCP HTTP hospedado em https://api.templatefox.com/mcp estará disponível em breve. Ele permitirá que você se conecte sem instalar nada localmente — basta apontar seu cliente MCP para a URL.

Solução de problemas

“Servidor MCP não encontrado” ou erros de conexão

  • Verifique se o Node.js 18+ está instalado: execute node --version
  • Confira se o comando npx funciona: execute npx -y @templatefox/mcp-server --help
  • Reinicie seu assistente de IA depois de atualizar a configuração

“Chave de API inválida” ou erros de autenticação

  • Verifique se sua chave de API começa com sk_ e não expirou
  • Confira a chave no seu Dashboard
  • Certifique-se de que TEMPLATEFOX_API_KEY está definido no ambiente correto (não apenas no seu shell, mas também na configuração do servidor MCP)

As ferramentas não aparecem

  • Alguns clientes armazenam em cache as listas de ferramentas MCP — reinicie o cliente
  • Verifique se outros servidores MCP estão funcionando para descartar um problema no cliente

Próximas etapas