DocuQueue

Criar documento a partir de modelo

Documentação

DocuQueue — Servidor MCP de Geração de Documentos

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 list_templates, fill_template e download_pdf para qualquer cliente compatível com MCP.

Resumo

claude mcp add docuqueue -e DOCUQUEUE_API_KEY=your_api_key -- npx -y github:docuqueue/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/v1

Opção 2: Instalação Local

# Claude Code
claude mcp add docuqueue -e DOCUQUEUE_API_KEY=your_api_key -- npx -y github:docuqueue/docuqueue-mcp

# Or install globally
npm install -g github:docuqueue/docuqueue-mcp

Integração com Clientes

Claude.ai (Hospedado)

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

Claude Desktop

Adicione ao ~/.config/Claude/claude_desktop_config.json:

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

Claude Code

claude mcp add docuqueue -e DOCUQUEUE_API_KEY=your_api_key -- npx -y github:docuqueue/docuqueue-mcp

Codex

Adicione ao ~/.codex/config.toml:

[mcp_servers.docuqueue]
command = "npx"
args = ["-y", "github:docuqueue/docuqueue-mcp"]

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

OpenCode

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

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

Cursor / Windsurf

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

{
  "mcpServers": {
    "docuqueue": {
      "command": "npx",
      "args": ["-y", "github:docuqueue/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/v1
  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éditosLimitado✓Sandbox
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 a Acme Corp, 3 widgets a $50 cada, 10% de imposto

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 a Acme Corp e a 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 final 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 é necessá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: "reautentique com o DocuQueue"
Conexão recusadaVerifique se a URL do servidor é https://docuqueue.com/mcp/v1
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 DocuQueue MCP é 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