TemplateFox

oficial

Gere documentos PDF com TemplateFox

Ver em templatefox.comExperimente este MCPPatrocinado

O que você pode fazer com TemplateFox MCP?

  • Gerar PDFs a partir de modelos — Peça para criar um PDF como fatura ou certificado com dados dinâmicos, custando 1 crédito por documento.
  • Enfileirar trabalhos de PDF em segundo plano — Solicite geração assíncrona de PDFs em lote ou em grande volume, opcionalmente com um callback via webhook.
  • Descobrir modelos e seus campos — Use list_templates para ver os PDFs disponíveis e saber quais dados um modelo específico espera.
  • Acompanhar o status dos trabalhos de PDF — Verifique o progresso da geração assíncrona com ou revise todos os trabalhos recentes.
  • Monitorar créditos da conta — Pergunte sobre créditos restantes com ou revise o histórico de uso.

Documentação

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

Pré-requisitos

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

Instalação

Claude Desktop

Adicione ao seu 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 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 sua configuração de 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.

Verifique a configuração

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

"Liste meus modelos TemplateFox"

Se o servidor MCP estiver configurado corretamente, o assistente chamará list_templates e retornará sua lista de modelos. Se você vir 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 expõe 8 ferramentas que seu assistente de IA pode chamar:

generate_pdf

Gere 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 $250, usando meu modelo de Fatura"

"Crie um certificado de conclusão para Jane Smith, curso: React Avançado"

generate_pdf_async

Enfileire a geração assíncrona de PDF com um callback webhook opcional. Útil para trabalhos 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

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

O que você pode pedir:

"Quais modelos eu tenho?"

"Mostre-me todos os meus modelos de PDF"

get_template_fields

Obtenha os campos e variáveis de um modelo específico. Útil para entender quais dados um modelo espera antes de gerar.

O que você pode pedir:

"Quais campos meu modelo de Fatura precisa?"

get_pdf_job_status

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

O que você pode pedir:

"Meu trabalho de PDF já terminou?"

list_pdf_jobs

Liste todos os trabalhos assíncronos de geração de PDF e seus status.

O que você pode pedir:

"Mostre-me meus trabalhos de PDF recentes"

get_account_info

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

O que você pode pedir:

"Quantos créditos ainda tenho?"

list_transactions

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

O que você pode pedir:

"Mostre-me 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 descobre o modelo, verifica os campos obrigatórios e gera o PDF em um único fluxo:

"Gere uma nota de remessa para o pedido #1234, cliente John Doe, 3x Widget Azul e 1x Gadget Pro"

Explorar modelos antes de gerar

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

"Liste meus modelos e depois mostre-me os campos do modelo de Recibo"

Verificar status da conta

Monitore seu uso sem sair do seu assistente de IA:

"Quantos créditos ainda tenho? Mostre-me 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

"Servidor MCP não encontrado" ou erros 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

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

  • Verifique se sua chave de API começa com sk_ e não está expirada
  • 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 na configuração do servidor MCP)

Ferramentas não aparecendo

  • 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