TemplateFox

oficial

Gere documentos PDF com TemplateFox

Ver em templatefox.comExperimente este MCPPatrocinado

O que você pode fazer com TemplateFox MCP?

  • Gerar um PDF a partir de um modelo — Peça ao seu assistente para chamar generate_pdf com dados dinâmicos, como detalhes de fatura ou nomes de certificados.
  • Enfileirar geração assíncrona de PDF — Use generate_pdf_async para trabalhos em lote ou em segundo plano com um callback opcional de webhook.
  • Listar seus modelos disponíveis — Descubra todos os modelos na sua conta com list_templates.
  • Inspecionar campos do modelo — Verifique quais dados um modelo espera antes de gerar, usando get_template_fields.
  • Verificar status do trabalho assíncrono — Acompanhe o progresso de um trabalho de PDF enfileirado com get_pdf_job_status.
  • Visualizar créditos e transações da conta — Monitore os créditos restantes com get_account_info e revise o histórico de uso com list_transactions.

Documentação

Servidor MCP

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

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

Pré-requisitos

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

Instalação

Claude Desktop

Adicione à 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 após 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 seu 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 o comando em vez de npx.

Verificar a configuração

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

“Listar meus modelos do TemplateFox”

Se o servidor MCP estiver configurado corretamente, o assistente chamará list_templates e retornará sua lista de modelos. Se você encontrar um erro, verifique a seção de 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 Painel
TEMPLATEFOX_BASE_URLNãoSubstitui a URL base da API (padrão: https://api.templatefox.com)

Ferramentas disponíveis

O servidor MCP expõe 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 perguntar:

“Gerar uma fatura para João Silva, total R$ 250, usando meu modelo de Fatura”

“Criar um certificado de conclusão para Maria Souza, curso: React Avançado”

generate_pdf_async

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

“Gerar 10 certificados em segundo plano e me notificar quando terminar”

list_templates

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

“Quais modelos eu tenho?”

“Mostrar todos os meus modelos de PDF”

get_template_fields

Obtém os campos e variáveis de um modelo específico. Útil para entender quais dados um modelo espera antes da geração.

“Quais campos meu modelo de Fatura precisa?”

get_pdf_job_status

Verifica o status de um trabalho de geração assíncrona de PDF.

“Meu trabalho de PDF já terminou?”

list_pdf_jobs

Lista todos os trabalhos de geração assíncrona de PDF e seus status.

“Mostrar meus trabalhos de PDF recentes”

get_account_info

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

“Quantos créditos eu ainda tenho?”

list_transactions

Visualiza o histórico de transações de crédito.

“Mostrar meu uso de créditos este 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 descobre o modelo, verifica os campos obrigatórios e gera o PDF em um único fluxo:

“Gerar um romaneio para o pedido #1234, cliente João Silva, 3x Widget Azul e 1x Gadget Pro”

Explorar modelos antes de gerar

Pergunte sobre seus modelos primeiro, depois gere quando souber o que está disponível:

“Listar meus modelos e depois mostrar os campos do modelo de Recibo”

Verificar status da conta

Monitore seu uso sem sair do seu assistente de IA:

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

Servidor remoto (em breve)

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

Solução de Problemas

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

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

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

  • Verifique se sua chave de API começa com sk_ e não está expirada
  • Verifique a chave no seu Painel
  • Certifique-se de que TEMPLATEFOX_API_KEY está definida no ambiente correto (não apenas no seu shell, mas na configuração do servidor MCP)

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 nível do cliente

Próximos passos

  • Comece em 5 Minutos — Crie seu primeiro modelo
  • Vinculação de Dados — Aprenda a passar dados dinâmicos
  • Referência da API — Documentação completa dos endpoints