Integração
Conecte seu agente de IA ao DocuGen via MCP
A documentação envelhece no primeiro dia de código, porque o que o desenvolvedor aprende implementando nunca volta para a spec. O servidor MCP do DocuGen fecha esse ciclo dentro do editor: o agente lê o briefing antes de escrever código e registra o que divergiu quando termina.
Como conecto meu agente de código ao DocuGen?
O DocuGen tem um servidor MCP hospedado em https://docugen.dev/api/mcp. Para conectar um agente de código, crie uma chave de API na página Developer do DocuGen usando o preset AI Agent e registre essa URL no seu cliente MCP, com a chave num header X-API-Key. No Claude Code é um comando só: claude mcp add --transport http docugen https://docugen.dev/api/mcp --header "X-API-Key: SUA_CHAVE". Não há nada para instalar nem processo local para rodar. Registrado o servidor, o agente lista projetos, lê documentos de requisitos e especificações técnicas, edita uma seção, comenta e envia o documento para revisão humana. Toda edição de agente salva a versão anterior antes e manda o documento para revisão, então nenhuma mudança é silenciosa. O servidor MCP exige plano Pro ou Enterprise.
claude mcp add --transport http docugen https://docugen.dev/api/mcp --header "X-API-Key: SUA_CHAVE"Endpoint: https://docugen.dev/api/mcp
O ciclo que ele fecha
- 1O agente puxa o briefing do projeto: contexto de negócio, requisitos de produto, plano de execução e especificações técnicas.
- 2Ele implementa contra esse briefing em vez de adivinhar, porque a especificação é a fonte da verdade na conversa.
- 3Quando a implementação diverge, o agente edita a seção afetada e envia o documento para revisão, com um resumo do que mudou.
- 4Você revisa a mudança no DocuGen, com a versão anterior salva e a diferença visível.
Configuração, passo a passo
- 1Crie uma chave de APINa página Developer, crie uma chave com o preset AI Agent. Ele concede leitura, edição, revisão e comentários, e nada além disso.
- 2Registre o servidorRode o comando claude mcp add com a sua chave. No Cursor e em outros clientes, adicione a mesma URL e o mesmo header nas configurações de MCP.
- 3Peça o briefingPeça ao agente para ler o projeto do DocuGen antes de implementar. Ele busca o briefing e segue por ele.
- 4Devolva a mudançaQuando a implementação divergir, peça ao agente para atualizar a especificação. A mudança chega como uma versão nova aguardando sua revisão.
O que o agente consegue fazer
| Tool | O que faz |
|---|---|
| docugen_list_projects | Lista os projetos que a chave alcança. |
| docugen_get_project | Detalhes do projeto e o índice dos documentos. |
| docugen_list_documents | Documentos de um projeto, filtrados por tipo ou status. |
| docugen_get_document | Lê um documento ou uma seção específica. |
| docugen_get_agent_pack | O projeto inteiro como um briefing AGENTS.md. |
| docugen_update_document | Edita o documento, preservando a versão anterior. |
| docugen_submit_for_review | Fecha a edição e envia para revisão humana. |
| docugen_discard_changes | Desfaz a sessão de edição aberta. |
| docugen_archive_document | Arquiva um documento que não vale mais. |
| docugen_restore_document | Traz de volta um documento arquivado. |
| docugen_add_comment | Relata uma divergência sem reescrever o documento. |
| docugen_generate_document | Gera um documento novo com IA. |
| docugen_get_job | Acompanha o progresso de uma geração. |
A outra ponta do ciclo: as reuniões
Requisito quase nunca nasce num documento, nasce numa call. O DocuGen conecta com Microsoft Teams, Google Meet e Notion para importar transcrições de reunião e transformá-las em requisitos estruturados, então a especificação que o seu agente lê começa onde a decisão foi tomada de verdade.
Veja a seção de transcrição de reunião no Guia do Usuário
Perguntas
- Quais ferramentas de código com IA funcionam com isso?
- Qualquer cliente que fale MCP sobre HTTP, incluindo Claude Code, Cursor, Codex e VS Code. Não há nada para instalar: o servidor roda no DocuGen e você registra uma URL.
- O agente pode sobrescrever minha documentação?
- Nenhuma edição é silenciosa. A primeira alteração de um agente salva a versão anterior, o documento vai para revisão e o dono é notificado. Você aprova ou reverte.
- E se eu editar o mesmo documento enquanto o agente trabalha?
- Sua edição prevalece e o rascunho do agente nunca é descartado. O DocuGen salva o trabalho do agente como uma versão, encerra a sessão de edição e aplica a sua alteração por cima. O agente é avisado de que a sessão acabou e precisa reler o documento antes de escrever.
- Preciso de um plano pago?
- Sim. O servidor MCP usa a API de desenvolvedor, disponível nos planos Pro e Enterprise.
- O DocuGen também lê transcrição de reunião?
- Sim. Conecte Microsoft Teams, Google Meet ou Notion, importe a transcrição, e o DocuGen transforma a conversa em requisitos estruturados a partir dos quais você gera documentos.