TemplateFox
oficialGenera documentos PDF con TemplateFox
¿Qué puedes hacer con TemplateFox MCP?
- Generar PDF a partir de plantillas — Pide a tu asistente que cree un PDF a partir de una plantilla con datos dinámicos, como una factura o un certificado.
- Poner en cola trabajos de PDF asíncronos — Solicita la generación en segundo plano para trabajos grandes o por lotes, con una devolución de llamada opcional mediante webhook cuando finalice.
- Inspeccionar plantillas y campos — Consulta las plantillas disponibles y los campos que requiere una plantilla específica antes de generar el PDF.
- Seguir trabajos de PDF — Comprueba el estado de un trabajo asíncrono o consulta los trabajos de PDF recientes y sus estados.
- Consultar créditos y transacciones — Pregunta por los créditos restantes, la información de la cuenta o el historial de transacciones de créditos.
Documentación
MCP (Model Context Protocol) es un estándar abierto que permite a los asistentes de IA descubrir y usar herramientas externas. El servidor MCP de TemplateFox proporciona a tu asistente de IA 8 herramientas para generar PDF, gestionar plantillas y consultar créditos, todo mediante lenguaje natural.
Requisitos previos
- Node.js 18+ instalado en tu equipo (para
npx) - Una clave de API de TemplateFox: obtén una en tu Dashboard (empieza por
sk_)
Instalación
Claude Desktop
Añádelo a la configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS, %APPDATA%\Claude\claude_desktop_config.json en Windows):
{
"mcpServers": {
"templatefox": {
"command": "npx",
"args": ["-y", "@templatefox/mcp-server"],
"env": {
"TEMPLATEFOX_API_KEY": "sk_your_api_key_here"
}
}
}
}
Reinicia Claude Desktop después de guardar el archivo.
Claude Code
claude mcp add templatefox -- npx -y @templatefox/mcp-server
A continuación, configura la variable de entorno TEMPLATEFOX_API_KEY en tu shell:
export TEMPLATEFOX_API_KEY="sk_your_api_key_here"
Cursor / Windsurf
Usa el mismo comando npx en la configuración del servidor MCP:
npx -y @templatefox/mcp-server
Configura TEMPLATEFOX_API_KEY en las variables de entorno.
Instalación global (alternativa)
npm install -g @templatefox/mcp-server
A continuación, usa templatefox-mcp-server como comando en lugar de npx.
Verificar la configuración
Después de la instalación, pregúntale a tu asistente de IA:
“Enumera mis plantillas de TemplateFox”
Si el servidor MCP está configurado correctamente, el asistente llamará a list_templates y devolverá la lista de tus plantillas. Si aparece un error, consulta la sección Solución de problemas a continuación.
Configuración
| Variable de entorno | Obligatoria | Descripción |
|---|---|---|
TEMPLATEFOX_API_KEY | Sí | Tu clave de API (empieza por sk_). Obtén una en tu Dashboard |
TEMPLATEFOX_BASE_URL | No | Anula la URL base de la API (valor predeterminado: https://api.templatefox.com) |
Herramientas disponibles
El servidor MCP expone 8 herramientas que tu asistente de IA puede usar:
generate_pdf
Genera un PDF a partir de una plantilla con datos dinámicos. Cuesta 1 crédito por PDF.
Qué puedes pedir:
“Genera una factura para John Doe, total de $250, usando mi plantilla Invoice”
“Crea un certificado de finalización para Jane Smith, curso: Advanced React”
generate_pdf_async
Encola la generación asíncrona de PDF con una devolución de llamada de webhook opcional. Es útil para trabajos grandes o por lotes. Cuesta 1 crédito por PDF.
Qué puedes pedir:
“Genera 10 certificados en segundo plano y avísame cuando termines”
list_templates
Descubre todas las plantillas PDF disponibles en tu cuenta.
Qué puedes pedir:
“¿Qué plantillas tengo?”
“Muéstrame todas mis plantillas PDF”
get_template_fields
Obtiene los campos y las variables de una plantilla específica. Es útil para saber qué datos espera una plantilla antes de generar el documento.
Qué puedes pedir:
“¿Qué campos necesita mi plantilla Invoice?”
get_pdf_job_status
Consulta el estado de un trabajo de generación asíncrona de PDF.
Qué puedes pedir:
“¿Ya terminó mi trabajo de PDF?”
list_pdf_jobs
Enumera todos los trabajos de generación asíncrona de PDF y sus estados.
Qué puedes pedir:
“Muéstrame mis trabajos de PDF recientes”
get_account_info
Consulta los créditos restantes y la información de la cuenta.
Qué puedes pedir:
“¿Cuántos créditos me quedan?”
list_transactions
Consulta el historial de transacciones de créditos.
Qué puedes pedir:
“Muéstrame el uso de mis créditos este mes”
Casos de uso
Generar un solo documento
Pídele a tu asistente de IA que genere un PDF con datos específicos. El asistente descubre la plantilla, comprueba los campos obligatorios y genera el PDF en un solo flujo:
“Genera un albarán para el pedido #1234, cliente John Doe, 3x Widget Blue y 1x Gadget Pro”
Explorar plantillas antes de generar
Primero pregunta por tus plantillas y luego genera el documento cuando sepas cuáles están disponibles:
“Enumera mis plantillas y luego muéstrame los campos de la plantilla Receipt”
Consultar el estado de la cuenta
Supervisa tu uso sin salir de tu asistente de IA:
“¿Cuántos créditos me quedan? Muéstrame mis transacciones recientes”
Servidor remoto (próximamente)
Pronto estará disponible un endpoint MCP HTTP alojado en https://api.templatefox.com/mcp. Esto te permitirá conectarte sin instalar nada localmente: solo tendrás que indicar la URL a tu cliente MCP.
Solución de problemas
«No se encuentra el servidor MCP» o errores de conexión
- Asegúrate de que Node.js 18+ esté instalado: ejecuta
node --version - Comprueba que el comando
npxfuncione: ejecutanpx -y @templatefox/mcp-server --help - Reinicia tu asistente de IA después de actualizar la configuración
«Clave de API no válida» o errores de autenticación
- Verifica que tu clave de API empiece por
sk_y que no haya caducado - Comprueba la clave en tu Dashboard
- Asegúrate de que
TEMPLATEFOX_API_KEYesté configurada en el entorno correcto (no solo en tu shell, sino también en la configuración del servidor MCP)
Las herramientas no aparecen
- Algunos clientes almacenan en caché las listas de herramientas MCP: reinicia el cliente
- Comprueba si otros servidores MCP funcionan para descartar un problema del cliente
Próximos pasos
- Empieza en 5 minutos — Crea tu primera plantilla
- Vinculación de datos — Aprende a pasar datos dinámicos
- Referencia de la API — Documentación completa de los endpoints