BulkRender-MCP

bulkrender-mcp

Servidor MCP de BulkRender. Genera documentos DOCX y PDF desde Claude, Cursor, Windsurf, Cline y cualquier otro asistente de IA compatible con MCP.

Inicio rápido

1. Regístrate en bulkrender.com
2. Ve a Configuración, Integraciones, Asistentes de IA (MCP)
3. Haz clic en Generar URL MCP — cópiala inmediatamente, se muestra una sola vez
4. Pégala en tu asistente de IA (ver más abajo)

---

Conecta tu asistente de IA

Claude.ai

Configuración, Integraciones, Añadir integración personalizada, pega tu URL MCP.

Claude Desktop / Cursor / Windsurf / Cline

Añade a tu archivo de configuración MCP:

{
  "mcpServers": {
    "bulkrender": {
      "url": "YOUR_MCP_URL"
    }
  }
}

Claude Code (CLI)

claude mcp add bulkrender --scope user -- npx mcp-remote YOUR_MCP_URL

Verifica:

claude mcp list
# bulkrender   ✓ Connected

---

Herramientas

Herramientas autenticadas (requieren URL MCP)

Herramienta	Descripción	Créditos
list_templates	Listar todas las plantillas	0
get_template	Obtener detalles de plantilla y esquema de variables	0
search_templates	Buscar plantillas por nombre o etiqueta	0
generate_document	Generar un documento individual (DOCX o PDF)	1–2
generate_batch	Generar documentos para múltiples registros (hasta 500)	1–2 cada uno
get_batch_status	Consultar estado de trabajos por lotes y obtener URLs de descarga	0
check_credits	Verificar créditos restantes	0
refresh_document_url	Obtener una URL firmada nueva para un documento existente	0
estimate_cost	Estimar el costo en créditos antes de generar	0
create_template_from_docx	Crear una plantilla reutilizable desde una URL DOCX	0
submit_feedback	Enviar comentarios o reportar un error	0

Costos en créditos: DOCX = 1 crédito, PDF = 2 créditos.

Herramientas de acceso directo (sin necesidad de cuenta)

Para agentes que actúan en nombre de usuarios finales que no tienen cuenta en BulkRender. Pago por sesión vía Stripe.

Herramienta	Descripción	Costo
acp_list_public_templates	Listar plantillas integradas (factura, cotización, contrato, informe, propuesta)	Gratis
acp_create_session	Crear una sesión de pago y obtener una URL de pago de Stripe	—
acp_pay_session	Cobrar un método de pago de Stripe directamente (vía para desarrolladores)	Mínimo $1.00
acp_get_session	Consultar estado de la sesión, obtener URLs de descarga al completarse	Gratis

Cargo mínimo de acceso directo: $1.00 (cubre hasta 10 documentos DOCX o 5 documentos PDF).

URL MCP pública (sin cuenta, solo herramientas de acceso directo): https://mcp.bulkrender.com/mcp/acp

---

Ejemplos de uso

Listar plantillas:

"Lista mis plantillas de BulkRender"

Generar un documento:

"Genera una factura usando la Plantilla de Factura para Acme Corp, factura #1234, con fecha 2025-01-15, por $5,000"

Generación por lotes:

"Genera facturas para estos 3 clientes: Acme Corp ($5,000), Beta Inc ($3,200), Gamma LLC ($7,800)"

---

Solución de problemas

Problema	Solución
El servidor no se conecta	Regenera tu URL MCP desde Configuración, Integraciones
Template not found	Usa list_templates para obtener el UUID correcto
Tiempo de espera agotado en lotes grandes	Los lotes de más de 10 registros se procesan de forma asíncrona — consulta get_batch_status
429 Too Many Requests	Límite de velocidad alcanzado — reintenta después de una pausa breve

---

Límites de velocidad

Endpoint	Límite
Generación de documentos	30 solicitudes / minuto por organización
Lectura de plantillas, créditos	30 solicitudes / minuto por organización

generate_batch cuenta como una solicitud independientemente del número de registros.

---

Enlaces

• BulkRender
• Documentación de la API
• GitHub

---

Migración desde el paquete npm

El paquete npm independiente (npx bulkrender-mcp con BULKRENDER_API_KEY) ya no es compatible. Usa la URL MCP alojada en su lugar — sin instalación, sin variables de entorno, solo pega la URL desde tu panel de control.

Si tienes la configuración anterior:

{
  "mcpServers": {
    "bulkrender": {
      "command": "npx",
      "args": ["-y", "bulkrender-mcp"],
      "env": { "BULKRENDER_API_KEY": "br_live_..." }
    }
  }
}

Reemplázala con:

{
  "mcpServers": {
    "bulkrender": {
      "url": "YOUR_MCP_URL"
    }
  }
}

Obtén tu URL MCP desde Configuración, Integraciones, Asistentes de IA (MCP) en tu panel de control de BulkRender.