DocuQueue

DocuQueue — Servidor MCP de Generación de Documentos

Genera PDFs, recibos, facturas y gestiona documentos desde el chat de IA. Funciona con Claude, ChatGPT, Cursor y cualquier cliente compatible con MCP. Servidor MCP para recibos de comercio electrónico, facturas, contratos y generación de documentos.

La generación de documentos MCP permite que asistentes de IA como Claude, ChatGPT y Cursor creen PDFs, contratos y facturas directamente desde el chat. El Protocolo de Contexto de Modelo (MCP) conecta tu agente de IA a una API de generación de documentos — sin necesidad de código de integración personalizado. DocuQueue es un servidor MCP que expone herramientas como generate_document, fill_template y batch_generate para cualquier cliente compatible con MCP.

Resumen

claude mcp add docuqueue -e DOCUQUEUE_API_KEY=your_api_key -- npx docuqueue-mcp

Características

• Gestión de Plantillas: Explora, crea y previsualiza plantillas de documentos
• Generación de PDF: Completa plantillas con datos y genera PDFs al instante
• Relleno de Formularios: Detecta y rellena automáticamente campos de formularios PDF (W-9, W-4, contratos)
• Procesamiento por Lotes: Genera múltiples documentos desde datos CSV/Excel
• Extracción de Marca: Extrae colores, fuentes y logotipos de cualquier sitio web
• Soporte DOCX: Sube y usa documentos de Word como plantillas
• Anotaciones de Herramientas: Operaciones de solo lectura y destructivas claramente marcadas

Formularios Comunes

Rellena y genera estos formularios populares directamente desde el chat de IA:

Formulario	Descripción	Enlace
W-9	Solicitud de Número de Identificación del Contribuyente	Rellenar en línea
W-4	Certificado de Retención del Empleado	Rellenar en línea
I-9	Verificación de Elegibilidad de Empleo	Rellenar en línea
1040	Declaración de Impuestos sobre la Renta Individual de EE. UU.	Rellenar en línea

Inicio Rápido

Opción 1: Alojado (Recomendado)

No se requiere instalación. Añade esta URL a tu cliente de IA:

https://docuqueue.com/mcp/sse

Opción 2: Instalación Local

# Claude Code
claude mcp add docuqueue -e DOCUQUEUE_API_KEY=your_api_key -- npx docuqueue-mcp

# Or install globally
npm install -g docuqueue-mcp

Integración con Clientes

Claude.ai (Alojado)

1. Ve a Configuración → Conectores → Añadir conector personalizado
2. Pega: https://docuqueue.com/mcp/sse
3. Haz clic en Autorizar en la ventana emergente del navegador
4. Comienza a generar documentos

Claude Desktop

Añade a ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "docuqueue": {
      "command": "npx",
      "args": ["docuqueue-mcp"],
      "env": {
        "DOCUQUEUE_API_KEY": "your_api_key"
      }
    }
  }
}

Claude Code

claude mcp add docuqueue -e DOCUQUEUE_API_KEY=your_api_key -- npx docuqueue-mcp

Codex

Añade a ~/.codex/config.toml:

[mcp_servers.docuqueue]
command = "npx"
args = ["docuqueue-mcp"]

[mcp_servers.docuqueue.env]
DOCUQUEUE_API_KEY = "your_api_key"

OpenCode

Añade a ~/.config/opencode/opencode.jsonc:

{
  "mcp": {
    "docuqueue": {
      "type": "local",
      "command": ["npx", "docuqueue-mcp"],
      "env": {
        "DOCUQUEUE_API_KEY": "your_api_key"
      }
    }
  }
}

Cursor / Windsurf

Añade a ~/.cursor/mcp.json o ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "docuqueue": {
      "command": "npx",
      "args": ["docuqueue-mcp"],
      "env": {
        "DOCUQUEUE_API_KEY": "your_api_key"
      }
    }
  }
}

ChatGPT

1. Ve a Configuración → Conectores → Añadir conector personalizado
2. Introduce la URL: https://docuqueue.com/mcp/sse
3. Añade el encabezado: Authorization: Bearer YOUR_API_KEY

Herramientas Disponibles

Plantillas

Herramienta	Descripción	Anotaciones
list_templates	Explora los diseños de documentos disponibles	Solo lectura
create_template	Diseña un nuevo diseño de documento	Escritura
preview_template	Ve cómo se verá tu documento	Solo lectura
upload_docx_template	Usa tu propio documento de Word como diseño	Escritura

Generación de Documentos

Herramienta	Descripción	Anotaciones
fill_template	Crea un documento con tus datos	Escritura
get_status	Comprueba si tu documento está listo	Solo lectura
download_pdf	Obtén tu documento terminado	Solo lectura

Marca

Herramienta	Descripción	Anotaciones
extract_branding	Coincide con el estilo visual de tu empresa desde su sitio web	Solo lectura (externo)
get_branding	Ve tus ajustes de estilo guardados	Solo lectura

Comparación con Otros Servidores de Documentos MCP

Característica	DocuQueue	DocsAutomator	Carbone	PDF Generator API
Generación de PDF	✓	✓	✓	✓
Plantillas DOCX	✓	✗	✗	✗
Relleno de formularios PDF	✓	✗	✗	✗
Procesamiento por lotes	✓	✓	✗	✓
Nivel gratuito	25 créditos	Limitado	✓	Sandbox
Servidor MCP	✓	✓	✓	✓
Editor visual de plantillas	✓	✗	✗	✓

Anotaciones de Herramientas

Las herramientas MCP de DocuQueue incluyen Anotaciones de Herramientas MCP para que los clientes puedan:

• Distinguir herramientas de solo lectura de las que permiten escritura
• Comprender qué operaciones son destructivas
• Identificar herramientas que acceden a recursos externos

Herramienta	readOnlyHint	destructiveHint	idempotentHint	openWorldHint
list_templates	true	false	true	false
create_template	false	false	false	false
preview_template	true	false	true	false
fill_template	false	false	false	false
get_status	true	false	true	false
download_pdf	true	false	true	false
extract_branding	true	false	true	true
get_branding	true	false	true	false
upload_docx_template	false	false	false	false

Ejemplos de Uso

Cada ejemplo es un prompt que puedes pegar directamente en tu chat de IA:

Generar una factura

Crea una factura para Acme Corp, 3 widgets a $50 cada uno, 10% de impuestos

La IA listará las plantillas, previsualizará la factura, generará el PDF y devolverá un enlace de descarga.

Generar un certificado

Crea un certificado para John Doe, completó el bootcamp de Python el 12 de agosto de 2026

Generar un contrato

Crea un NDA entre Acme Corp y Globex Corp, efectivo desde el 1 de enero de 2026

Rellenar un formulario

Rellena este formulario W-9: nombre "Acme Corp", EIN "12-3456789", dirección "123 Main St"

Extraer marca de un sitio web

Extrae los colores y fuentes de marca de https://stripe.com

Generar un recibo

Crea un recibo para el cliente John Smith, pedido #ORD-2024-0892, 3x Widget Pro a $24.99 cada uno, subtotal $74.97, impuestos $5.62, total $80.59, pagado con Visa terminada en 4242

Subir una plantilla personalizada

Sube este documento de Word como plantilla: /path/to/contract.docx

Configuración

Variable de Entorno	Requerida	Descripción
DOCUQUEUE_API_KEY	Sí*	Tu clave de API de DocuQueue

*No requerida cuando se usa el modo OAuth alojado.

Obtén tu clave de API en docuqueue.com/dashboard.

Cómo Funciona

1. Conecta — Añade el servidor MCP a tu cliente con tu clave de API
2. Explora — Usa list_templates para encontrar una plantilla
3. Previsualiza — Usa preview_template para ver cómo se ve con tus datos
4. Genera — Usa fill_template para crear el PDF
5. Descarga — Usa download_pdf para obtener el documento terminado

Solución de Problemas

Síntoma	Solución
Error de autenticación	Pide a la IA: "re-autenticar con DocuQueue"
Conexión rechazada	Comprueba que la URL del servidor sea https://docuqueue.com/mcp/sse
Límite de velocidad alcanzado	Espera 1 minuto y vuelve a intentarlo
Plantilla no encontrada	Pide a la IA que liste las plantillas primero
Herramienta no aparece	Reinicia tu cliente MCP después de añadir el servidor

Privacidad

DocuQueue MCP es un servidor remoto — tus solicitudes van a los servidores de DocuQueue y devuelven PDFs generados. Los tokens de autenticación se envían solo a los servicios de DocuQueue durante el inicio de sesión OAuth y las llamadas a la API. Los documentos se generan sobre la marcha y no se almacenan indefinidamente.

Desarrollo

Requisitos Previos

• Node.js 18+
• npm o yarn

Configuración

git clone https://github.com/docuqueue/docuqueue-mcp.git
cd docuqueue-mcp
npm install

Ejecutar Localmente

# Development mode with hot reload
npm run dev

# Or build and run
npm run build
npm start

Pruebas

npm test

Estructura del Proyecto

src/
├── index.ts          # Local MCP server (stdio)
├── remote.ts         # Remote MCP server (SSE/HTTP)
├── config.ts         # Configuration management
├── tools/            # Tool implementations
│   ├── listTemplates.ts
│   ├── createTemplate.ts
│   ├── fillTemplate.ts
│   ├── previewTemplate.ts
│   ├── getStatus.ts
│   ├── downloadPdf.ts
│   ├── uploadDocxTemplate.ts
│   └── uploadPdf.ts
├── branding/         # Brand extraction
├── api/              # API client
├── errors/           # Error handling
└── types/            # TypeScript types

Licencia

MIT

Enlaces

• Sitio web: docuqueue.com
• Página MCP: docuqueue.com/mcp
• Documentación de API: docuqueue.com/redoc
• GitHub: github.com/docuqueue/docuqueue-mcp
• Problemas: github.com/docuqueue/docuqueue-mcp/issues