TemplateFox

Servidor MCP

Copiar página

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 de 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 por 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_tu_clave_api_aqui" } } } }

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 de 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 por 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 un callback webhook opcional. Útil para trabajos grandes o por lotes. Cuesta 1 crédito por PDF.

“Genera 10 certificados en segundo plano y avísame 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

Muestra el historial de transacciones de créditos.

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

Casos de uso

Generar un único 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 y 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)

Próximamente 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

”Servidor MCP no encontrado” o errores 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

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

• Verifica que tu clave API empiece por sk_ y no haya caducado
• Comprueba la clave en tu Panel de control
• Asegúrate de que TEMPLATEFOX_API_KEY esté configurada 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

• Comienza 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

Última actualización el 12 de julio de 2026

Estándares PDFSubir a S3