BulkRender-MCP

bulkrender-mcp

Servidor MCP BulkRender. Gere documentos DOCX e PDF a partir de Claude, Cursor, Windsurf, Cline e qualquer outro assistente de IA compatível com MCP.

Início rápido

1. Cadastre-se em bulkrender.com
2. Vá em Configurações, Integrações, Assistentes de IA (MCP)
3. Clique em Gerar URL MCP — copie imediatamente, ele é exibido apenas uma vez
4. Cole no seu assistente de IA (veja abaixo)

---

Conecte seu assistente de IA

Claude.ai

Configurações, Integrações, Adicionar integração personalizada, cole sua URL MCP.

Claude Desktop / Cursor / Windsurf / Cline

Adicione ao seu arquivo de configuração MCP:

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

Claude Code (CLI)

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

Verifique:

claude mcp list
# bulkrender   ✓ Connected

---

Ferramentas

Ferramentas autenticadas (exigem URL MCP)

Ferramenta	Descrição	Créditos
list_templates	Listar todos os templates	0
get_template	Obter detalhes do template e esquema de variáveis	0
search_templates	Pesquisar templates por nome ou tag	0
generate_document	Gerar um único documento (DOCX ou PDF)	1–2
generate_batch	Gerar documentos para múltiplos registros (até 500)	1–2 cada
get_batch_status	Consultar status de jobs em lote e obter URLs de download	0
check_credits	Verificar créditos restantes	0
refresh_document_url	Obter uma URL assinada recente para um documento existente	0
estimate_cost	Estimar o custo em créditos antes de gerar	0
create_template_from_docx	Criar um template reutilizável a partir de uma URL DOCX	0
submit_feedback	Enviar feedback ou relatar um bug	0

Custos de crédito: DOCX = 1 crédito, PDF = 2 créditos.

Ferramentas de acesso aberto (sem conta necessária)

Para agentes que atuam em nome de usuários finais que não possuem conta BulkRender. Pagamento por sessão via Stripe.

Ferramenta	Descrição	Custo
acp_list_public_templates	Listar templates integrados (fatura, orçamento, contrato, relatório, proposta)	Grátis
acp_create_session	Criar uma sessão de checkout e obter uma URL de pagamento Stripe	—
acp_pay_session	Cobrar um método de pagamento Stripe diretamente (caminho do desenvolvedor)	Mín. $1.00
acp_get_session	Consultar status da sessão, obter URLs de download quando concluída	Grátis

Cobrança mínima para acesso aberto: $1,00 (cobre até 10 DOCX ou 5 PDF).

URL MCP pública (sem conta, apenas ferramentas de acesso aberto): https://mcp.bulkrender.com/mcp/acp

---

Exemplos de uso

Listar templates:

"Liste meus templates BulkRender"

Gerar um documento:

"Gere uma fatura usando o Template de Fatura para Acme Corp, fatura #1234, datada de 2025-01-15, valor $5.000"

Geração em lote:

"Gere faturas para estes 3 clientes: Acme Corp ($5.000), Beta Inc ($3.200), Gamma LLC ($7.800)"

---

Solução de problemas

Problema	Solução
Servidor não conecta	Gere sua URL MCP novamente em Configurações, Integrações
Template not found	Use list_templates para obter o UUID correto
Tempo limite em lote grande	Lotes com mais de 10 registros processam de forma assíncrona — consulte get_batch_status
429 Too Many Requests	Limite de taxa atingido — tente novamente após uma pequena pausa

---

Limites de taxa

Endpoint	Limite
Geração de documentos	30 solicitações / minuto por organização
Leitura de templates, créditos	30 solicitações / minuto por organização

generate_batch conta como uma solicitação, independentemente do número de registros.

---

Links

• BulkRender
• Documentação da API
• GitHub

---

Migração do pacote npm

O pacote npm autônomo (npx bulkrender-mcp com BULKRENDER_API_KEY) não é mais suportado. Use a URL MCP hospedada — sem instalação, sem variáveis de ambiente, basta colar a URL do seu painel.

Se você tem a configuração antiga:

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

Substitua por:

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

Obtenha sua URL MCP em Configurações, Integrações, Assistentes de IA (MCP) no seu painel BulkRender.