TemplateFox

oficial

Genera 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

  1. Node.js 18+ instalado en tu equipo (para npx)
  2. 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 entornoObligatoriaDescripción
TEMPLATEFOX_API_KEYSíTu clave de API (empieza por sk_). Obtén una en tu Dashboard
TEMPLATEFOX_BASE_URLNoAnula 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 npx funcione: ejecuta npx -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_KEY esté 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