TemplateFox

oficial

Genera documentos PDF con TemplateFox

Ver en templatefox.comPrueba este MCPPatrocinado

¿Qué puedes hacer con TemplateFox MCP?

  • Generar PDFs a partir de plantillas — Solicita crear un PDF como una factura o certificado con datos dinámicos, con un costo de 1 crédito por documento.
  • Poner en cola trabajos de PDF en segundo plano — Solicita la generación de PDFs por lotes o grandes de forma asíncrona, opcionalmente con un callback de webhook.
  • Descubrir plantillas y sus campos — Usa list_templates para ver los PDFs disponibles y para conocer qué datos espera una plantilla específica.
  • Rastrear el estado de los trabajos de PDF — Verifica el progreso de la generación asíncrona con o revisa todos los trabajos recientes.
  • Monitorear los créditos de la cuenta — Pregunta sobre los créditos restantes con o revisa el historial de uso.

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 le da a tu asistente de IA 8 herramientas para generar PDFs, gestionar plantillas y verificar créditos, todo desde lenguaje natural.

Requisitos previos

  1. Node.js 18+ instalado en tu máquina (para npx)
  2. Una clave API de TemplateFox — obtén una desde tu Panel de control (comienza con sk_)

Instalación

Claude Desktop

Añade a tu 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

Luego establece 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 tu configuración del servidor MCP:

npx -y @templatefox/mcp-server

Establece TEMPLATEFOX_API_KEY en las variables de entorno.

Instalación global (alternativa)

npm install -g @templatefox/mcp-server

Luego 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:

“Lista mis plantillas de TemplateFox”

Si el servidor MCP está configurado correctamente, el asistente llamará a list_templates y devolverá tu lista de plantillas. Si ves un error, consulta la sección Solución de problemas a continuación.

Configuración

Variable de entornoRequeridaDescripción
TEMPLATEFOX_API_KEYSíTu clave API (comienza con sk_). Obtén una desde tu Panel de control
TEMPLATEFOX_BASE_URLNoSobrescribe la URL base de la API (por defecto: https://api.templatefox.com)

Herramientas disponibles

El servidor MCP expone 8 herramientas que tu asistente de IA puede llamar:

generate_pdf

Genera un PDF a partir de una plantilla con datos dinámicos. Cuesta 1 crédito por PDF.

Lo que puedes preguntar:

“Genera una factura para John Doe, total $250, usando mi plantilla de Factura”

“Crea un certificado de finalización para Jane Smith, curso: React Avanzado”

generate_pdf_async

Pon en cola la generación asíncrona de PDF con un callback webhook opcional. Útil para trabajos grandes o por lotes. Cuesta 1 crédito por PDF.

Lo que puedes preguntar:

“Genera 10 certificados en segundo plano y notifícame cuando termines”

list_templates

Descubre todas las plantillas de PDF disponibles en tu cuenta.

Lo que puedes preguntar:

“¿Qué plantillas tengo?”

“Muéstrame todas mis plantillas de PDF”

get_template_fields

Obtén los campos y variables de una plantilla específica. Útil para entender qué datos espera una plantilla antes de generar.

Lo que puedes preguntar:

“¿Qué campos necesita mi plantilla de Factura?”

get_pdf_job_status

Comprueba el estado de un trabajo de generación de PDF asíncrono.

Lo que puedes preguntar:

“¿Ya terminó mi trabajo de PDF?”

list_pdf_jobs

Lista todos los trabajos de generación de PDF asíncronos y sus estados.

Lo que puedes preguntar:

“Muéstrame mis trabajos de PDF recientes”

get_account_info

Comprueba los créditos restantes y la información de la cuenta.

Lo que puedes preguntar:

“¿Cuántos créditos me quedan?”

list_transactions

Ver el historial de transacciones de crédito.

Lo que puedes preguntar:

“Muéstrame mi uso de crédito 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, verifica los campos requeridos 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

Pregunta primero por tus plantillas y luego genera una vez que sepas qué hay disponible:

“Lista mis plantillas, luego muéstrame los campos de la plantilla de Recibo”

Verificar el estado de la cuenta

Monitorea tu uso sin salir de tu asistente de IA:

“¿Cuántos créditos me quedan? Muéstrame mis transacciones recientes”

Servidor remoto (próximamente)

Un endpoint HTTP MCP alojado en https://api.templatefox.com/mcp estará disponible próximamente. Esto te permitirá conectarte sin instalar nada localmente: solo apunta tu cliente MCP a la URL.

Solución de problemas

“Servidor MCP no encontrado” o errores de conexión

  • Asegúrate de que Node.js 18+ esté instalado: ejecuta node --version
  • Verifica 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 API inválida” o errores de autenticación

  • Verifica que tu clave API comience con sk_ y no esté vencida
  • Revisa la clave en tu Panel de control
  • Asegúrate de que TEMPLATEFOX_API_KEY esté configurado en el entorno correcto (no solo en tu shell, sino en la configuración del servidor MCP)

Las herramientas no aparecen

  • Algunos clientes almacenan en caché las listas de herramientas MCP: reinicia el cliente
  • Verifica si otros servidores MCP funcionan para descartar un problema a nivel de cliente

Próximos pasos