TemplateFox

Servidor MCP

Copiar página

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 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_sua_chave_api_aqui" } } } }

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:

“Liste 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 Ambiente	Obrigatória	Descrição
TEMPLATEFOX_API_KEY	Sim	Sua chave de API (começa com sk_). Obtenha uma no seu Painel
TEMPLATEFOX_BASE_URL	Não	Substitui 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:

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

“Crie 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 webhook opcional. Útil para trabalhos grandes ou em lote. Custa 1 crédito por PDF.

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

list_templates

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

“Quais modelos eu tenho?”

“Mostre-me 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 de gerar.

“Quais campos meu modelo de Fatura precisa?”

get_pdf_job_status

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

“Meu trabalho de PDF já terminou?”

list_pdf_jobs

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

“Mostre-me meus trabalhos de PDF recentes”

get_account_info

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

“Quantos créditos eu ainda tenho?”

list_transactions

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

“Mostre-me 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:

“Gere um romaneio de remessa 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 e depois gere quando souber o que está disponível:

“Liste meus modelos e depois mostre 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? Mostre-me minhas transações recentes”

Servidor remoto (em breve)

Um endpoint MCP HTTP 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+ esteja 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 esteja definida 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

• 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

Última atualização em 12 de julho de 2026

Padrões de PDFUpload para S3