TemplateFox

Servidor MCP

MCP (Protocolo de Contexto de Modelo) es un estándar abierto que permite a los asistentes de IA descubrir y usar herramientas externas. El servidor MCP TemplateFox proporciona a tu asistente de IA 8 herramientas para generar PDFs, gestionar plantillas y consultar créditos — todo desde lenguaje natural.

• npm: @templatefox/mcp-server
• GitHub: TemplateFoxPDF/mcp-server

Requisitos previos

1. Node.js 18+ instalado en tu máquina (para npx)
2. Una clave API de TemplateFox — consíguela desde tu Panel de control (empieza 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 la configuración de tu 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, pregunta 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 de Solución de problemas más abajo.

Configuración

Variable de entorno	Requerido	Descripción
TEMPLATEFOX_API_KEY	Sí	Tu clave API (empieza con sk_). Consíguela desde tu Panel de control
TEMPLATEFOX_BASE_URL	No	Sobrescribe 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 invocar:

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 Juan Pérez, total $250, usando mi plantilla de Factura”

“Crea un certificado de finalización para María García, curso: React Avanzado”

generate_pdf_async

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

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

list_templates

Descubre todas las plantillas PDF disponibles en tu cuenta.

“¿Qué plantillas tengo?”

“Muéstrame todas mis plantillas PDF”

get_template_fields

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

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

get_pdf_job_status

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

“¿Ha terminado ya mi trabajo de PDF?”

list_pdf_jobs

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

“Muéstrame mis trabajos de PDF recientes”

get_account_info

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

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

list_transactions

Ve el historial de transacciones de créditos.

“Muéstrame mi uso de créditos este mes”

Casos de uso

Generar un solo documento

Pide a tu asistente de IA que genere un PDF con datos específicos. El asistente descubre la plantilla, comprueba los campos requeridos y genera el PDF en un solo flujo:

“Genera un albarán para el pedido #1234, cliente Juan Pérez, 3x Widget Azul y 1x Gadget Pro”

Explorar plantillas antes de generar

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

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

Comprobar el estado de la cuenta

Monitoriza 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 HTTP MCP alojado en https://api.templatefox.com/mcp. Esto te permitirá conectarte sin instalar nada localmente — solo apunta tu cliente MCP a la URL.

Solución de problemas

Errores de ”Servidor MCP no encontrado” o de conexión

• Asegúrate de que Node.js 18+ esté instalado: ejecuta node --version
• Comprueba que el comando npx funciona: ejecuta npx -y @templatefox/mcp-server --help
• Reinicia tu asistente de IA después de actualizar la configuración

Errores de ”Clave API inválida” o de autenticación

• Verifica que tu clave API empieza con sk_ y no ha caducado
• Comprueba la clave en tu Panel de control
• Asegúrate de que TEMPLATEFOX_API_KEY está establecida 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
• Comprueba si otros servidores MCP funcionan para descartar un problema a nivel de cliente

Próximos pasos

• Primeros pasos 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