DocuQueue
Criar documento a partir de modelo
Documentação
DocuQueue — Servidor MCP de Geração de Documentos
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ário | Descrição | Link |
|---|---|---|
| W-9 | Solicitação de Número de Identificação do Contribuinte | Preencher Online |
| W-4 | Certificado de Retenção do Empregado | Preencher Online |
| I-9 | Verificação de Elegibilidade de Emprego | Preencher Online |
| 1040 | Declaração de Imposto de Renda Individual dos EUA | Preencher 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)
- Vá para Configurações → Conectores → Adicionar conector personalizado
- Cole:
https://docuqueue.com/mcp/sse - Clique em Autorizar na janela do navegador
- 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
- Vá para Configurações → Conectores → Adicionar conector personalizado
- Insira a URL:
https://docuqueue.com/mcp/sse - Adicione o cabeçalho:
Authorization: Bearer YOUR_API_KEY
Ferramentas Disponíveis
Modelos
| Ferramenta | Descrição | Anotações |
|---|---|---|
list_templates | Navegue pelos designs de documentos disponíveis | Somente leitura |
create_template | Crie um novo layout de documento | Gravação |
preview_template | Veja como seu documento ficará | Somente leitura |
upload_docx_template | Use seu próprio documento do Word como design | Gravação |
Geração de Documentos
| Ferramenta | Descrição | Anotações |
|---|---|---|
fill_template | Crie um documento com seus dados | Gravação |
get_status | Verifique se seu documento está pronto | Somente leitura |
download_pdf | Obtenha seu documento finalizado | Somente leitura |
Marca
| Ferramenta | Descrição | Anotações |
|---|---|---|
extract_branding | Combine o estilo visual da sua empresa a partir do site dela | Somente leitura (externo) |
get_branding | Veja suas configurações de estilo salvas | Somente leitura |
Comparação com Outros Servidores MCP de Documentos
| Recurso | DocuQueue | DocsAutomator | Carbone | PDF Generator API |
|---|---|---|---|---|
| Geração de PDF | ✓ | ✓ | ✓ | ✓ |
| Modelos DOCX | ✓ | ✗ | ✗ | ✗ |
| Preenchimento de formulários PDF | ✓ | ✗ | ✗ | ✗ |
| Processamento em lote | ✓ | ✓ | ✗ | ✓ |
| Nível gratuito | 25 créditos | Limitado | ✓ | 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
| Ferramenta | 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 |
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 Ambiente | Obrigatória | Descrição |
|---|---|---|
DOCUQUEUE_API_KEY | Sim* | 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
- Conecte — Adicione o servidor MCP ao seu cliente com sua chave de API
- Navegue — Use
list_templatespara encontrar um modelo - Visualize — Use
preview_templatepara ver como fica com seus dados - Gere — Use
fill_templatepara criar o PDF - Baixe — Use
download_pdfpara obter o documento finalizado
Solução de Problemas
| Sintoma | Correção |
|---|---|
| Erro de autenticação | Peça à IA: "reautenticar com DocuQueue" |
| Conexão recusada | Verifique se a URL do servidor é https://docuqueue.com/mcp/sse |
| Limite de taxa excedido | Aguarde 1 minuto e tente novamente |
| Modelo não encontrado | Peça à IA para listar os modelos primeiro |
| Ferramenta não aparecendo | Reinicie 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
- Site: docuqueue.com
- Página MCP: docuqueue.com/mcp
- Documentação da API: docuqueue.com/redoc
- GitHub: github.com/docuqueue/docuqueue-mcp
- Problemas: github.com/docuqueue/docuqueue-mcp/issues