DocuQueue

Criar documento a partir de modelo

Documentação

DocuQueue — Servidor MCP de Geração de Documentos

npm version License: MIT Glama

Gere PDFs, recibos, faturas e gerencie documentos a partir do chat de IA. Funciona com Claude, ChatGPT, Cursor e qualquer cliente compatível com MCP. Servidor MCP para recibos de e-commerce, faturas, contratos e geração de documentos.

Geração de documentos via MCP permite que assistentes de IA como Claude, ChatGPT e Cursor criem PDFs, contratos e faturas diretamente do chat. O Model Context Protocol (MCP) conecta seu agente de IA a uma API de geração de documentos — sem necessidade de código de integração personalizado. DocuQueue é um servidor MCP que expõe ferramentas como generate_document, fill_template e batch_generate para qualquer cliente compatível com MCP.

Resumo

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

Recursos

  • Gerenciamento de Modelos: Navegue, crie e visualize modelos de documentos
  • Geração de PDF: Preencha modelos com dados e gere PDFs instantaneamente
  • Preenchimento de Formulários: Detecte e preencha automaticamente campos de formulários PDF (W-9, W-4, contratos)
  • Processamento em Lote: Gere múltiplos documentos a partir de dados CSV/Excel
  • Extração de Marca: Extraia cores, fontes e logotipos de qualquer site
  • Suporte a DOCX: Envie e use documentos do Word como modelos
  • Anotações de Ferramentas: Operações somente leitura e destrutivas claramente marcadas

Formulários Comuns

Preencha e gere estes formulários populares diretamente do chat de IA:

FormulárioDescriçãoLink
W-9Solicitação de Número de Identificação do ContribuintePreencher Online
W-4Certificado de Retenção do EmpregadoPreencher Online
I-9Verificação de Elegibilidade de EmpregoPreencher Online
1040Declaração de Imposto de Renda Individual dos EUAPreencher Online

Início Rápido

Opção 1: Hospedado (Recomendado)

Nenhuma instalação necessária. Adicione esta URL ao seu cliente de IA:

https://docuqueue.com/mcp/sse

Opção 2: Instalação 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

Integração com Clientes

Claude.ai (Hospedado)

  1. Vá para Configurações → Conectores → Adicionar conector personalizado
  2. Cole: https://docuqueue.com/mcp/sse
  3. Clique em Autorizar na janela do navegador
  4. Comece a gerar documentos

Claude Desktop

Adicione em ~/.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

Adicione em ~/.codex/config.toml:

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

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

OpenCode

Adicione em ~/.config/opencode/opencode.jsonc:

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

Cursor / Windsurf

Adicione em ~/.cursor/mcp.json ou ~/.codeium/windsurf/mcp_config.json:

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

ChatGPT

  1. Vá para Configurações → Conectores → Adicionar conector personalizado
  2. Insira a URL: https://docuqueue.com/mcp/sse
  3. Adicione o cabeçalho: Authorization: Bearer YOUR_API_KEY

Ferramentas Disponíveis

Modelos

FerramentaDescriçãoAnotações
list_templatesNavegue pelos designs de documentos disponíveisSomente leitura
create_templateCrie um novo layout de documentoGravação
preview_templateVeja como seu documento ficaráSomente leitura
upload_docx_templateUse seu próprio documento do Word como designGravação

Geração de Documentos

FerramentaDescriçãoAnotações
fill_templateCrie um documento com seus dadosGravação
get_statusVerifique se seu documento está prontoSomente leitura
download_pdfObtenha seu documento finalizadoSomente leitura

Marca

FerramentaDescriçãoAnotações
extract_brandingCombine o estilo visual da sua empresa a partir do site delaSomente leitura (externo)
get_brandingVeja suas configurações de estilo salvasSomente leitura

Comparação com Outros Servidores MCP de Documentos

RecursoDocuQueueDocsAutomatorCarbonePDF Generator API
Geração de PDF
Modelos DOCX
Preenchimento de formulários PDF
Processamento em lote
Nível gratuito25 créditosLimitadoSandbox
Servidor MCP
Editor visual de modelos

Anotações de Ferramentas

As ferramentas MCP do DocuQueue incluem Anotações de Ferramentas MCP para que os clientes possam:

  • Distinguir ferramentas somente leitura de ferramentas com capacidade de gravação
  • Entender quais operações são destrutivas
  • Identificar ferramentas que acessam recursos externos
FerramentareadOnlyHintdestructiveHintidempotentHintopenWorldHint
list_templatestruefalsetruefalse
create_templatefalsefalsefalsefalse
preview_templatetruefalsetruefalse
fill_templatefalsefalsefalsefalse
get_statustruefalsetruefalse
download_pdftruefalsetruefalse
extract_brandingtruefalsetruetrue
get_brandingtruefalsetruefalse
upload_docx_templatefalsefalsefalsefalse

Exemplos de Uso

Cada exemplo é um prompt que você pode colar diretamente no seu chat de IA:

Gerar uma fatura

Crie uma fatura para Acme Corp, 3 widgets a $50 cada, imposto de 10%

A IA listará os modelos, visualizará a fatura, gerará o PDF e retornará um link de download.

Gerar um certificado

Crie um certificado para John Doe, concluiu o bootcamp de Python em 12 de agosto de 2026

Gerar um contrato

Crie um NDA entre Acme Corp e Globex Corp, com vigência a partir de 1º de janeiro de 2026

Preencher um formulário

Preencha este formulário W-9: nome "Acme Corp", EIN "12-3456789", endereço "123 Main St"

Extrair marca de um site

Extraia as cores e fontes da marca de https://stripe.com

Gerar um recibo

Crie um recibo para o cliente John Smith, pedido #ORD-2024-0892, 3x Widget Pro a $24,99 cada, subtotal $74,97, imposto $5,62, total $80,59, pago com Visa terminando em 4242

Enviar um modelo personalizado

Envie este documento do Word como modelo: /path/to/contract.docx

Configuração

Variável de AmbienteObrigatóriaDescrição
DOCUQUEUE_API_KEYSim*Sua chave de API do DocuQueue

*Não é obrigatória ao usar o modo OAuth hospedado.

Obtenha sua chave de API em docuqueue.com/dashboard.

Como Funciona

  1. Conecte — Adicione o servidor MCP ao seu cliente com sua chave de API
  2. Navegue — Use list_templates para encontrar um modelo
  3. Visualize — Use preview_template para ver como fica com seus dados
  4. Gere — Use fill_template para criar o PDF
  5. Baixe — Use download_pdf para obter o documento finalizado

Solução de Problemas

SintomaCorreção
Erro de autenticaçãoPeça à IA: "reautenticar com DocuQueue"
Conexão recusadaVerifique se a URL do servidor é https://docuqueue.com/mcp/sse
Limite de taxa excedidoAguarde 1 minuto e tente novamente
Modelo não encontradoPeça à IA para listar os modelos primeiro
Ferramenta não aparecendoReinicie seu cliente MCP após adicionar o servidor

Privacidade

O MCP do DocuQueue é um servidor remoto — suas solicitações vão para os servidores do DocuQueue e retornam PDFs gerados. Os tokens de autenticação são enviados apenas aos serviços do DocuQueue durante o login OAuth e chamadas de API. Os documentos são gerados dinamicamente e não são armazenados indefinidamente.

Desenvolvimento

Pré-requisitos

  • Node.js 18+
  • npm ou yarn

Configuração

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

Executar Localmente

# Development mode with hot reload
npm run dev

# Or build and run
npm run build
npm start

Testar

npm test

Estrutura do Projeto

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

Licença

MIT

Links