TemplateFox MCP Server

Servidor MCP (Model Context Protocol) para la API de generación de PDF de TemplateFox. Genera PDFs a partir de plantillas directamente a través de asistentes de IA como Claude, Cursor y Windsurf.

Instalación

Claude Desktop

Añade a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "templatefox": {
      "command": "npx",
      "args": ["-y", "@templatefox/mcp-server"],
      "env": {
        "TEMPLATEFOX_API_KEY": "sk_your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add templatefox -- npx -y @templatefox/mcp-server

Luego establece la variable de entorno TEMPLATEFOX_API_KEY en tu shell.

Cursor / Windsurf

Usa el mismo comando npx -y @templatefox/mcp-server en tu configuración del servidor MCP, con TEMPLATEFOX_API_KEY en el entorno.

Instalación global (alternativa)

npm install -g @templatefox/mcp-server

Luego usa templatefox-mcp-server como comando en lugar de npx.

Related MCP server: @docujson/mcp

Configuración

Herramientas disponibles

Servidor remoto (HTTP)

El servidor MCP también admite transporte HTTP a través de Streamable HTTP, adecuado para despliegues remotos y en la nube.

Conectar mediante URL

https://mcp-server-599407781746.us-central1.run.app/mcp

Los clientes MCP deben pasar la clave de API a través del encabezado HTTP:

Authorization: Bearer sk_your_api_key_here

o:

x-api-key: sk_your_api_key_here

Autohospedaje

Ejecuta el servidor en modo HTTP configurando la variable de entorno PORT:

PORT=8080 TEMPLATEFOX_API_KEY=sk_your_key node dist/index.js

O con Docker:

docker build -t templatefox-mcp .
docker run -p 8080:8080 templatefox-mcp

El endpoint MCP está disponible en http://localhost:8080/mcp y una verificación de salud en http://localhost:8080/health.

Ejemplo de uso

Una vez configurado, puedes pedirle a tu asistente de IA:

"Lista mis plantillas de PDF y genera una factura usando la Plantilla de Factura con el nombre del cliente 'John Doe' y el importe 150.00"

El asistente hará lo siguiente:

1. Llamará a list_templates para encontrar las plantillas disponibles

2. Llamará a get_template_fields para descubrir los campos requeridos

3. Llamará a generate_pdf con el ID de la plantilla y los datos

4. Devolverá la URL de descarga del PDF

Enlaces

• Documentación de TemplateFox

• Referencia de la API

• Obtener clave de API

• GitHub

Licencia

MIT