Fluxos com IA: usando o MCP Server na prática

Com o Sutram conectado a um assistente de IA (como o Claude) pelo MCP Server, você conversa com o conteúdo do projeto: encontrar, ler, comentar, corrigir e versionar documentos em linguagem natural, sem sair do chat. Este tutorial percorre um ciclo completo, ponta a ponta.

Pré-requisitos: o projeto precisa estar conectado ao assistente (veja Conectando o Sutram ao Claude), e o acesso MCP requer o plano Pro ou superior. Para a referência de cada ferramenta citada, veja o Guia do Sutram MCP Server.

O ciclo que você vai percorrer

Orientar-se  →  Encontrar  →  Ler e avaliar  →  Comentar  →  Corrigir e versionar  →  Fechar o loop

A ideia central: você descreve a intenção em português; o assistente escolhe e encadeia as ferramentas certas. Você não precisa saber os nomes das ferramentas — mas é útil entender o que acontece nos bastidores, e é isso que este guia mostra.

Passo 1: Oriente-se no projeto

Comece com uma visão geral:

"Me mostre um panorama do meu projeto Sutram e o que há nele."

Nos bastidores, o assistente consulta as informações do projeto e lista a raiz, devolvendo um resumo estruturado das pastas e itens. É o ponto de partida para saber onde as coisas estão.

Passo 2: Encontre o que precisa

Peça pela via que fizer sentido — por metadados ou por assunto:

"Encontre os documentos marcados com categoria = contrato e ano = 2026." "O que temos sobre política de reembolso? Busque na wiki e me diga as fontes."

O assistente faz a busca por tag ou a busca full-text na Wiki e traz os resultados com o caminho de cada item. (Veja Busca e descoberta de conteúdo.)

Passo 3: Leia e avalie

Aponte um documento para o assistente abrir e analisar:

"Abra o contrato ACME e resuma os pontos principais; aponte qualquer cláusula desatualizada."

O assistente baixa o conteúdo do arquivo, lê e responde — inclusive sinalizando problemas que você pediu para observar.

Passo 4: Deixe feedback com comentários

Registre observações no próprio documento, para a equipe ver:

"Comente neste arquivo: a seção 3 referencia uma norma revogada."

O assistente cria um comentário — no arquivo inteiro ou ancorado a um trecho de um documento markdown. O comentário aparece em tempo real na interface web, exatamente como se você tivesse escrito à mão. É assim que a IA participa da revisão junto com a equipe.

Passo 5: Corrija e versione

Aqui está o coração do fluxo. Peça a correção:

"Habilite o versionamento neste documento e corrija a referência da seção 3 para a norma vigente."

Nos bastidores, o assistente executa o ciclo de versionamento:

Habilita o versionamento (se o arquivo ainda for referência)
Faz checkout (trava para edição exclusiva)
Edita e envia a nova versão do arquivo
Faz checkin — o arquivo fica em rascunho

O rascunho não é publicado automaticamente: você revisa primeiro. Quando aprovar:

"Está ótimo, pode publicar."

...o assistente publica a versão, criando um snapshot permanente no histórico. Para documentos sob governança (Classes de Documentos), o caminho é criar uma nova revisão e movê-la pelo ciclo de vida com transições (veja Governança na prática: estados e transições).

Segurança: publicar e outras ações sensíveis pedem sua confirmação; ferramentas destrutivas (excluir) sempre confirmam antes de agir. O rascunho existe justamente para você revisar antes de tornar algo oficial.

Passo 6: Feche o loop de revisão

A colaboração vai nos dois sentidos. Quando você ou colegas comentam nos documentos, o assistente acompanha:

"Veja os comentários abertos neste doc e responda o que já foi resolvido."

Ele lista os comentários, responde às threads e marca como resolvido o que foi endereçado — mantendo a revisão organizada.

Boas práticas ao trabalhar com IA

Seja explícito — diga "no Sutram" quando o pedido puder ser confundido com um arquivo local; ou aplique o Preset do Assistente Sutram (veja Conectando o Sutram ao Claude) para o assistente já assumir esse contexto.
Revise antes de publicar — o ciclo rascunho → publicado existe para isso; deixe o assistente parar no rascunho e confira.
Confirme ações externas — publicar e postar no chat são visíveis à equipe; confirme antes.
Aproveite o lote — a IA brilha em tarefas repetitivas: criar dezenas de registros, aplicar tags em massa, reorganizar pastas.

Um exemplo ponta a ponta

Você:  Panorama do meu projeto Sutram.
IA:    [lista pastas e itens da raiz] Você tem Contratos, Laudos e Documentação.

Você:  Nos Contratos, ache os de 2026 e me diga se algum cita a norma X.
IA:    [busca por tag ano=2026] Encontrei 3; o "Contrato ACME" cita a norma X (revogada).

Você:  Comente isso no arquivo e corrija para a norma vigente.
IA:    [cria comentário] [habilita versionamento → checkout → edita → checkin]
       Comentário registrado e correção feita — está em rascunho para sua revisão.

Você:  Perfeito, publique.
IA:    [publica a versão] Publicado como nova versão. Loop fechado.

Perguntas Frequentes

P: Preciso saber os nomes das ferramentas do MCP?

R: Não. Você conversa em linguagem natural e o assistente escolhe as ferramentas. Saber o que elas fazem ajuda a pedir com precisão e a entender o que aconteceu — para isso existe o Guia do Sutram MCP Server.

P: A IA pode publicar ou excluir sem eu ver?

R: Ações sensíveis pedem confirmação, e as destrutivas sempre confirmam. O padrão é a IA parar no rascunho; publicar acontece quando você aprova.

P: Isso funciona em qualquer cliente?

R: Funciona em clientes compatíveis com MCP — via conector OAuth (claude.ai, Desktop) ou ponte por chave (Claude Code, Cursor). Veja Conectando o Sutram ao Claude.

Próximos Passos

Conectando o Sutram ao Claude — para deixar o assistente pronto
Guia do Sutram MCP Server — a referência de todas as ferramentas
Sistema de Versionamento de Arquivos — o que acontece no checkout/checkin/publicar

Versão do Documento: 1.0 Última Atualização: Julho de 2026 Autor: Equipe de Desenvolvimento Sutram