TemplateFox
oficialGere 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
- Node.js 18+ instalado na sua máquina (para
npx) - 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 ambiente | Obrigatória | Descrição |
|---|---|---|
TEMPLATEFOX_API_KEY | Sim | Sua chave de API (começa com sk_). Obtenha uma no seu Dashboard |
TEMPLATEFOX_BASE_URL | Não | Substitui 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
npxfunciona: executenpx -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_KEYestá 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
- 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