Como atualizar a documentação com o Claude Code após cada lançamento

O código é enviado na terça-feira. O changelog é escrito na sexta-feira, se alguém se lembrar, e o artigo de ajuda da tela alterada permanece incorreto por um mês. Você pode atualizar a documentação com o Claude Code: ele já está no repositório, então ele sabe o que foi enviado.

Este guia conecta o Claude Code a um site de documentação Clevera através do servidor MCP do Clevera. Após cada lançamento, o Claude Code lê o log do git, redige a entrada do changelog, encontra os artigos de ajuda que o lançamento afetou e propõe as edições. Uma pessoa revisa e publica. Nada chega aos leitores por conta própria.

O que você precisa primeiro#

Um site de documentação Clevera. Sites de documentação são a central de ajuda hospedada do Clevera, com um changelog e feed RSS integrados. Todo plano inclui um.

Pro ou superior. Agentes de IA e API estão disponíveis no plano Pro ou superior. O Pro custa US$ 86,80 por mês faturado anualmente (US$ 124 mensal) para 2 criadores, com 4.000 créditos compartilhados por mês. As chamadas de API em si não custam créditos. Veja os preços.

Claude Code no repositório de onde você faz o lançamento. Ele precisa executar git log, e gh se você quiser que ele leia títulos de pull requests.

Passo 1: Crie um token de Escritor (Writer)#

1. No Clevera, abra o menu do espaço de trabalho e escolha Agentes de IA e API, depois Tokens e Novo token. 2. Dê um nome ("Docs writer (Claude Code)") e escolha a predefinição Escritor (Writer): "Agentes redigem; uma pessoa revisa e publica." Ele possui 4 permissões: ler conteúdo, escrever rascunhos de artigos, escrever rascunhos de changelog e fazer upload de imagens. 3. Em Limites, escolha o site de documentação em Sites de documentação e uma data de expiração. Tokens sempre expiram, após 7 dias, 30 dias, 90 dias ou 1 ano. 4. Em Revisão, clique em Criar token e copie-o. O Clevera mostra isso apenas uma vez. Coloque-o em uma variável de ambiente chamada CLEVERA_TOKEN, nunca no repositório.

Por que Escritor e não Publicador? Um token de Escritor não pode alterar o que os leitores veem. Ele não pode publicar e não pode editar um artigo que já está no ar. Esse segundo limite molda todo o fluxo de trabalho, por isso é abordado no passo 3.

Passo 2: Conecte o Claude Code#

Execute isto no seu terminal:

claude mcp add --transport http clevera https://app.clevera.ai/mcp --header "Authorization: Bearer $CLEVERA_TOKEN"

Isso adiciona o servidor para você, no projeto atual. Se toda a equipe precisar dele, adicione-o ao .mcp.json na raiz do repositório. O Claude Code expande ${VAR} nesse arquivo, para que o token em si permaneça fora do git:

{ "mcpServers": { "clevera": { "type": "http", "url": "https://app.clevera.ai/mcp", "headers": { "Authorization": "Bearer ${CLEVERA_TOKEN}" } } } }

Cada colega de equipe então define CLEVERA_TOKEN para seu próprio token. O Claude Code pergunta antes de usar um servidor de projeto pela primeira vez. Digite /mcp ou execute claude mcp list para verificar se está conectado. Os detalhes estão na documentação MCP do Claude Code, e o passo a passo completo do token está em nosso guia sobre como fazer um vídeo com o Claude via MCP.

Passo 3: Peça a documentação do lançamento#

Marque o lançamento e, em seguida, dê ao Claude Code um prompt. Aqui está um exemplo que você pode adaptar:

> "Marcamos a v2.4. Leia os commits e títulos de PR desde a v2.3. Em nosso site de documentação Clevera, verifique o changelog para não repetir uma entrada, depois redija uma entrada para a v2.4 com Novo, Melhorado e Corrigido. Em seguida, pesquise no site por artigos sobre qualquer coisa que tenha mudado. Atualize os rascunhos diretamente. Para artigos ativos, envie cada um para revisão com as alterações exatas. Não publique nada."

Aqui está o que ele faz com as ferramentas do Clevera:

1. Lê o que foi enviado. git log v2.3..v2.4 e, com gh, os pull requests mesclados. Esta parte é o Claude Code puro. 2. Encontra o site. list_sites retorna o ID do site e se a publicação automática está ativada. 3. Verifica o changelog. list_changelog mostra entradas recentes, para não anunciar a mesma alteração duas vezes. 4. Redige a entrada. create_changelog_entry salva como um rascunho com título, categoria e corpo em Markdown que vincula aos artigos. 5. Encontra os artigos afetados. search_content e get_site_tree encontram páginas que mencionam o recurso alterado. get_page lê cada uma. 6. Escreve as edições. Para um artigo que ainda não está no ar, update_article escreve o novo texto. Ele precisa do ID de revisão que leu, para não sobrescrever a edição de um colega feita nesse meio tempo. Para um novo recurso sem artigo, create_article cria um rascunho na seção correta. 7. Pede revisão. Para um artigo ativo, a edição é recusada sem direitos de publicação. Então, o agente chama submit_for_review com uma nota dizendo o que deve mudar e por quê. Os gerentes do site recebem um aviso na caixa de entrada com um link.

Um exemplo de como a entrada de rascunho pode parecer (ilustrativo, não uma execução real):

> Pesquisa de fatura mais rápida e um novo aplicativo Slack · Melhorado, Novo > A pesquisa agora encontra faturas por cliente, valor ou número conforme você digita. Conecte o novo aplicativo Slack para postar faturas pagas em um canal. Corrigido: Exportações em PDF mantêm seu logotipo em todas as páginas. Links para os dois artigos atualizados seguem abaixo.

Cada alteração aparece no histórico da página com o nome do agente e o token que ele usou.

Passo 4: Revise e publique#

Abra o site de documentação no Clevera. A entrada do changelog fica em Rascunhos. Corrija o texto, defina a Versão e clique em Publicar entrada. Abra os artigos a partir dos avisos de revisão, aplique ou ajuste as alterações e publique o site. A entrada entra no ar com essa publicação.

Duas configurações importam aqui:

• Publicação automática. Com ela ativada, uma alteração em uma página ativa é publicada alguns minutos após a edição parar. Desative-a se quiser uma publicação deliberada por lançamento.
• Idiomas. Em um site com mais de um idioma, publicar uma entrada traduz a mesma para cada idioma. Isso consome créditos.

Se você confia no agente com edições ao vivo, um token de Publicador (Publisher) pode editar artigos ativos e publicar. Apenas proprietários, administradores e editores podem conceder permissão de publicação. As ferramentas ainda dizem aos agentes para publicar apenas quando você solicitar explicitamente. A maioria das equipes deve começar com Escritor e decidir após alguns lançamentos.

Opcional: um novo vídeo de instruções para o fluxo alterado#

Uma tela alterada geralmente significa que um vídeo antigo também está incorreto, e há uma rotina completa para atualizar vídeos de tutorial após uma alteração na interface. O Claude Code pode criar o novo vídeo de instruções a partir de uma gravação que já está na sua biblioteca Clevera. Ele não pode gravar sua tela, então grave o novo fluxo primeiro.

Isso requer um token que pode gastar créditos, como a predefinição Produtor (Producer), que também inclui tudo o que o Escritor possui. Peça um orçamento primeiro. Um vídeo de instruções a partir de uma gravação de até 5 minutos geralmente custa de 5 a 25 créditos. Deixe Aprovar automaticamente abaixo em 0, o padrão, e um proprietário ou administrador aprova cada início pago em Solicitações de agente. O vídeo pode então ser inserido no artigo como um bloco de vídeo.

Quando você não precisa disso#

Se sua documentação vive como Markdown no mesmo repositório que seu código, o Claude Code pode editar esses arquivos diretamente e você revisa o pull request como qualquer outra alteração. Você não precisa de um servidor MCP para isso. Este fluxo de trabalho é para equipes cujo centro de ajuda e changelog vivem em uma ferramenta hospedada que pessoas de suporte e produto também editam. Comparando opções hospedadas? Veja nosso resumo de servidores MCP para documentação e os melhores geradores de changelog por IA.

Perguntas frequentes#

O Claude Code pode publicar meu changelog sem mim? Não com um token de Escritor. Ele só pode redigir. Um token de Publicador pode publicar, e as ferramentas do Clevera dizem ao agente para publicar apenas quando você solicitar.

O que acontece se um colega de equipe editar o artigo ao mesmo tempo? A atualização do agente falha com um conflito de revisão, e a ferramenta diz para ele reler o artigo e aplicar sua alteração à nova versão. A edição do seu colega não é sobrescrita.

Isso consome créditos? Ler, redigir, atualizar e solicitar revisões não consomem créditos. Traduzir entradas ou artigos e criar vídeos, sim.

Qual plano preciso para atualizar a documentação com o Claude Code? Pro ou superior para agentes de IA e API. O site de documentação e seu changelog estão disponíveis em todos os planos.

Funciona com outros agentes? Sim. Codex, Cursor e scripts conectam-se com o mesmo tipo de token, e Claude e ChatGPT conectam-se via login. Veja todas as integrações da Clevera.

Torne isso parte do lançamento#

Salve seu prompt no repositório, ao lado do script de lançamento, e execute-o sempre que criar uma tag. A primeira execução leva alguns minutos de configuração. Depois disso, o rascunho do changelog e a lista de artigos obsoletos estarão prontos antes mesmo que alguém precise pedir. Veja o que mais os agentes podem fazer com o servidor MCP da Clevera →