Re:port Flow MCP

Nombre oficial para mostrar: Re:port Flow MCP. Identificador de paquete e implementación: reportflow-mcp. Alias de búsqueda heredados: ReportFlow MCP Server y ReportFlow.

Visión general

Un servidor MCP (Model Context Protocol) que convierte tus plantillas de Re:port Flow en informes PDF (facturas, contratos, extractos, lo que hayas diseñado) directamente desde Claude o cualquier otro agente de IA compatible con MCP.

Related MCP server: PDF Tools AI MCP

Características

• Genera PDFs a partir de solicitudes en lenguaje natural como "crea una factura para Acme Corp por un total de 300 $"

• Expone tus diseños de Re:port Flow y sus esquemas de parámetros directamente a la IA como Resources de MCP.

• Genera muchos PDFs por lotes y descárgalos como un único ZIP.

• Guarda los resultados en la carpeta del espacio de trabajo en la que se encuentre el usuario (compatible con Claude Desktop / Claude Code / Cursor / VS Code).

Configuración

Re:port Flow MCP funciona de dos maneras: elige la que se adapte a tu cliente.

Servidor remoto (claude.ai / clientes web) — Streamable HTTP

Añade Re:port Flow como conector personalizado que apunte al endpoint alojado:

https://mcp.re-port-flow.com/mcp

En Claude (claude.ai) ve a Configuración → Conectores → Añadir conector personalizado y pega la URL anterior. La autenticación se gestiona en la aplicación mediante OAuth (consulta Autenticación): no hay que instalar nada localmente.

Servidor local (Claude Desktop / Claude Code / Cursor) — stdio mediante npx

Añade lo siguiente a tu archivo de configuración (.mcp.json, claude_desktop_config.json, ~/.cursor/mcp.json, etc.):

{
  "mcpServers": {
    "reportflow": {
      "command": "npx",
      "args": ["-y", "reportflow-mcp"]
    }
  }
}

Eso es todo el proceso. No hay variables de entorno, claves de API ni secretos que gestionar.

VS Code (versiones con MCP habilitado)

El mismo JSON en .vscode/mcp.json.

Requisitos

• Remoto: un cliente MCP que admita conectores HTTP personalizados (p. ej., claude.ai). Sin instalación local.

• Local (stdio): Node.js 22+ (descargado automáticamente por npx) y un navegador disponible durante el primer inicio de sesión.

• Una cuenta de Re:port Flow (en cualquiera de los dos casos).

Revisiones de protocolo compatibles

Ambos transportes (stdio / Streamable HTTP) sirven dos generaciones del protocolo MCP desde un único endpoint:

• 2026-07-28 (actual): protocolo sin estado por solicitud. Los clientes modernos lo descubren mediante server/discover; no hay cabecera de sesión, las solicitudes llevan su versión de protocolo en _meta.

• Revisiones de la era 2025 (2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07): handshake clásico initialize, conservado por compatibilidad con clientes existentes (Claude Desktop, conectores personalizados de claude.ai, Cursor, ChatGPT, n8n, …).

La selección de versión es automática en ambos transportes: los clientes modernos sondean con server/discover, los clientes heredados siguen enviando initialize; no se requiere configuración en ninguno de los dos lados, y las conexiones existentes siguen funcionando sin cambios.

Autenticación

Remoto (claude.ai)

Cuando añades el conector, Claude ejecuta el flujo OAuth por ti: Iniciar sesión → elegir un espacio de trabajo → consentir. Los tokens los conserva el cliente: no hay que gestionar ningún llavero local ni paso de navegador.

Local (stdio)

Después de recargar el cliente MCP, pídele a la IA:

Autentícate con Re:port Flow

Se abre una ventana del navegador. Inicia sesión → elige un espacio de trabajo → acepta, y listo. Los tokens se almacenan en el llavero del sistema operativo (Llavero de macOS / Administrador de credenciales de Windows / libsecret de Linux), con un respaldo de archivo con chmod-0600, y se renuevan automáticamente.

Ejemplos de uso

Cada ejemplo siguiente es un prompt que puedes pegar tal cual; la IA elige las herramientas adecuadas.

1. Generar un único PDF (lista → esquema → generar)

Usando la plantilla de factura, crea un PDF para Acme Corp por un total de $330.

La IA lista los diseños con list_templates, obtiene el esquema de parámetros con get_design_parameters, rellena los valores y llama a generate_pdf_sync.

• Remoto: devuelve una URL de descarga (fileUrl).

• Local: además guarda el archivo y devuelve su ruta absoluta.

2. Generar muchos PDFs por lotes

A partir de la plantilla de extracto, genera un PDF por cliente (Acme $100, Globex $250, Initech $80) y entrégamelos juntos.

• Local (stdio): generate_pdfs_sync escribe un único ZIP en tu espacio de trabajo.

• Remoto: generate_pdfs_async ejecuta el lote y devuelve un id de solicitud más una URL de descarga.

3. Generación asíncrona y descarga posterior (local)

Pon en marcha el PDF del contrato en segundo plano y descárgalo cuando esté listo.

La IA llama a generate_pdf_async (devuelve un requestId inmediatamente) y después a download_file para guardar el PDF terminado. El equivalente por lotes es generate_pdfs_async → download_zip. Estas herramientas de descarga son solo para stdio; en el servidor remoto, las herramientas síncronas/asíncronas ya devuelven un fileUrl.

Consejo — parámetros en lenguaje natural: en un cliente compatible con Sampling puedes pedir "redacta los parámetros para una factura de $1,000 a A社" y la IA llamará a suggest_params para convertir el resumen en un objeto params válido antes de generar.

4. Empezar sin plantillas (galería → copiar → generar)

Aún no tengo ninguna plantilla: crea un PDF de factura para Acme Corp.

Cuando list_templates está vacía, la IA busca en la galería pública de plantillas con search_gallery_templates, te muestra los candidatos, copia tu elección en tu espacio de trabajo con copy_gallery_template y luego continúa con el flujo normal (get_design_parameters → generate_pdf_sync). La copia siempre va al espacio de trabajo que seleccionaste en la pantalla de consentimiento de OAuth: la IA no puede apuntar a ningún otro espacio de trabajo.

Comandos de barra

Dónde se guardan los archivos (modo local)

La ubicación de salida se resuelve en este orden:

1. Instrucción explícita del usuario (p. ej., "guárdalo en mi escritorio")

2. La raíz del espacio de trabajo actualmente abierto (Claude Code / Cursor / VS Code)

3. El directorio temporal del sistema operativo como respaldo

Referencia

Herramientas (llamadas por la IA)

Recursos (adjuntables como contexto de IA)

Prompts (tarjetas de recetas de comandos slash)

/generate_pdf, /generate_pdfs, /reportflow_help — pasa los argumentos y la IA sigue el flujo de trabajo preparado.

Solución de problemas

Privacidad

Re:port Flow MCP es un cliente ligero: reenvía tus solicitudes a tu propia cuenta de Re:port Flow y devuelve los PDF generados. No vende ni comparte tus datos con terceros. Los tokens de autenticación se almacenan localmente (llavero del sistema operativo, o un archivo de respaldo chmod-0600) y se envían solo a los servicios propios de Re:port Flow — durante el inicio de sesión OAuth y como credencial Bearer en cada llamada API autenticada (listado de plantillas, generación o descarga de PDFs). Nunca se comparten con terceros.

Para conocer la política de privacidad completa — qué se recopila, durante cuánto tiempo se conserva y cómo se gestiona — consulta: lp.re-port-flow.com

Seguridad

El endpoint alojado valida la cabecera Host (protección contra el rebinding de DNS) y rechaza las cabeceras Origin estructuralmente inválidas con 403 Forbidden, según los requisitos de seguridad de la especificación MCP Streamable HTTP. La autenticación es solo mediante token Bearer — sin cookies, y CORS nunca permite credenciales. La política completa y su modelo de amenazas están documentados en docs/security.md (japonés).

Soporte

¿Necesitas ayuda, has encontrado un error o tienes alguna pregunta sobre la revisión de directorios?

• Re:port Flow (privacidad y soporte): https://lp.re-port-flow.com

• GitHub Issues: https://github.com/re-port-flow/reportflow-mcp/issues

Licencia

MIT — consulta LICENSE.

Enlaces

• Re:port Flow: https://re-port-flow.com

• Privacidad y soporte: https://lp.re-port-flow.com

• npm: https://www.npmjs.com/package/reportflow-mcp

• Issues: https://github.com/re-port-flow/reportflow-mcp/issues