Isenção de responsabilidade: Este artigo foi gerado usando tradução automática.

Casos de uso do MCP no Document360

Prev Next

O Servidor MCP permite que assistentes de IA externos interajam com sua base de conhecimento do Document360 de forma estruturada. Essas interações não contornam seu modelo de governança – elas operam dentro da sua versão existente, linguagem e configuração de visibilidade. Abaixo estão cenários práticos que mostram como diferentes papéis podem usar o MCP em seus fluxos de trabalho diários de documentação.


Redatores técnicos

Problema: Pesquisar, elaborar e refinar documentação exige troca de contexto e esforço manual

Redatores técnicos frequentemente se movem entre múltiplos artigos, versões e categorias para coletar contexto antes de escrever ou atualizar o conteúdo. Eles também precisam garantir consistência no tom, terminologia e estrutura, especialmente quando um Guia de Estilo está configurado. Alternar entre editor, busca, versões anteriores e artigos de referência retarda a elaboração e revisão.

Como o MCP ajuda

Com um assistente de IA conectado ao Document360 via MCP, os escritores podem:

  • Peça ao assistente para buscar artigos relevantes antes de redigir novo conteúdo
  • Brainstorming de ideias baseadas em documentação existente
  • Construa uma lista de revisão de tudo em uma categoria atualizada desde uma data específica, para planejar uma auditoria ou divulgação
  • Refinar ou reescrever o conteúdo diretamente dentro do sistema de documentação
  • Atualize artigos sem copiar manualmente o conteúdo entre ferramentas
  • Verifique se um termo produto já está no glossário, adicione-o se estiver faltando e use o termo do glossário nos artigos para manter a terminologia consistente
  • Mova os artigos atualizados para o status apropriado do fluxo de trabalho e designe revisores sem mudar para o portal
  • Publique o conteúdo aprovado diretamente do assistente de IA assim que a revisão estiver concluída
  • Agende um lembrete de revisão em um artigo após atualizá-lo, para que ele seja revisado novamente antes que fique desatualizado
  • Receba feedback próximo do leitor após corrigir o artigo, adicione uma nota sobre o que mudou e informe o leitor

Em vez de redigir isoladamente e colar o conteúdo depois, os redatores podem trabalhar com contexto extraído de sua própria base de conhecimento. Quando as atualizações são feitas, o fluxo de trabalho existente e o comportamento de versionamento permanecem inalterados. Novos rascunhos, histórico de revisões e estados de revisão continuam seguindo os processos normais de documentação.

Desfecho

Redatores técnicos reduzem pesquisas repetitivas, mantêm melhor consistência entre os artigos e redigem e publicam conteúdo mais rapidamente, mantendo-se dentro do mesmo modelo de governança documental.


Desenvolvedores

Problema: Desenvolvedores precisam de documentação específica para a versão ao construir recursos

Desenvolvedores frequentemente alternam entre IDEs e ambientes de codificação assistidos por IA, como Cursor ou outras ferramentas habilitadas por IA. Ao consultar documentação, eles precisam de informações precisas e conscientes da versão sem precisar navegar manualmente pela base de conhecimento.

Como o MCP ajuda

Ao conectar o Document360 via MCP ao assistente de IA dentro do IDE:

  • Desenvolvedores podem recuperar o conteúdo completo do artigo em vez de trechos parciais
  • Pesquise em todas as versões do projeto por padrão, ou especifique uma versão
  • Acesse a documentação em um idioma selecionado
  • Gerar documentação preliminar para novos endpoints ou integrações
  • Envie feedback para a equipe de documentação quando um artigo estiver desconhecido, desatualizado ou faltando informações, sem sair do IDE

Isso permite que a busca documental e a criação de conteúdo ocorram diretamente dentro do fluxo de trabalho de desenvolvimento.

Desfecho

Os desenvolvedores gastam menos tempo trocando de contexto e mais tempo construindo com documentação que reflita a versão e estrutura corretas.


Gerentes de produto e consultores

Problema: Validar a documentação entre versões é manual e fragmentada

Gerentes de produto frequentemente precisam comparar descrições de recursos entre versões, preparar notas de lançamento ou validar que a documentação reflete as últimas mudanças do produto. Checar manualmente múltiplas versões e categorias pode ser lento e inconsistente.

Como o MCP ajuda

Por meio de assistentes de IA habilitados pelo MCP, as equipes de produto podem:

  • Recuperar a documentação por versão específica do projeto
  • Compare como os recursos são descritos entre os lançamentos
  • Identificar lacunas antes do lançamento
  • Gerar resumos estruturados para alinhamento interno ou integração

Como a interação é estruturada, o conteúdo é recuperado em contexto, e não como saída web desconectada.

Desfecho

A documentação se torna mais fácil de validar antes do lançamento, reduzindo o desalinhamento entre atualizações do produto e conhecimento publicado.


Engenheiros de suporte

Problema: Tickets de suporte expõem lacunas de conhecimento

Quando um chamado de suporte chega, os engenheiros precisam determinar rapidamente se a documentação relevante já existe. Buscar manualmente pode ser demorado, especialmente em várias versões e idiomas. Em alguns casos, a documentação pode simplesmente não existir.

Como o MCP ajuda

Com o MCP conectado a um assistente de IA:

  • Engenheiros de suporte podem colar o contexto do ticket e pedir ao assistente para buscar artigos relevantes
  • Recuperar conteúdo pelo nome do artigo ou ID
  • Busque entre versões e idiomas
  • Compartilhe URLs de artigos diretamente com os clientes

Se nenhum artigo relevante for encontrado, isso significa que existe uma lacuna de conhecimento na base de conhecimento. Os engenheiros podem, então, seguir:

  • Elabore um novo artigo com base no contexto do ticket
  • Atualize um artigo existente para melhorar a clareza
  • Empurrar as mudanças estruturadas de volta para o Document360
  • Mova o artigo para revisar e designe o membro da equipe apropriado antes de ser publicado
  • Publique o artigo diretamente assim que ele for revisado e aprovado

Se um artigo existente estiver desatualizado ou incompleto, mas o engenheiro não for a pessoa certa para corrigi-lo, ele pode enviar o feedback do artigo através do assistente de IA. O feedback aparece no gerenciador de feedback para a equipe de documentação ser capturado.

Todas as operações de escrita, fluxo de trabalho e publicação continuam respeitando as permissões e regras de governança existentes.

Desfecho

As equipes de suporte resolvem tickets mais rapidamente enquanto melhoram continuamente a qualidade da documentação — e agora podem levar o conteúdo do rascunho para o live sem sair do assistente de IA.


Revisores e especialistas no assunto

Problema: Acompanhar as avaliações e tarefas atribuídas leva tempo

Revisores e especialistas no assunto frequentemente recebem artigos para revisão e artigos que precisam de revisão periódica. Verificar regularmente a página de Tarefas , abrir cada artigo e atualizar seu status um a um interrompe seu trabalho principal.

Como o MCP ajuda

Com um assistente de IA conectado ao Document360 via MCP, os revisores podem:

  • Pergunte o que está atrasado ou vence esta semana em todo o fluxo de trabalho deles e revise tarefas de lembrete
  • Leia um artigo designado e marque a avaliação como concluída
  • Mova o artigo para o próximo status de fluxo de trabalho assim que a revisão estiver concluída
  • Soneca uma tarefa que eles ainda não podem realizar, para que ela volte em uma data marcada

As tarefas exibidas pelo MCP são as mesmas que as tarefas na página de Tarefas , então nada é acompanhado duas vezes.

Desfecho

Os revisores apagam o trabalho atribuído de uma única conversa, e o restante da equipe pode ver o progresso na página de Tarefas como de costume.


Gerentes de documentação e líderes de conteúdo

Problema: Coordenar revisão, aprovação e publicação em uma equipe grande consome muito tempo

Gerentes de documentação que supervisionam vários escritores precisam acompanhar quais artigos estão em rascunho, quais aguardam revisão e quais estão prontos para publicação. Coordenar isso entre uma equipe sem uma visão centralizada leva a atrasos, revisões perdidas e ritmos de publicação inconsistentes.

Como o MCP ajuda

Com um assistente de IA conectado ao Document360 via MCP, os gerentes de documentação podem:

  • Verifique quais status de fluxo de trabalho estão configurados e como o pipeline de revisão está estruturado
  • Mova vários artigos para a fase de revisão apropriada e designe os membros certos da equipe em uma única conversa
  • Defina prazos para tarefas de fluxo de trabalho para manter as revisões no cronograma
  • Publique conteúdo que tenha passado pela avaliação sem mudar para o portal
  • Despublicar rapidamente conteúdos desatualizados ou incorretos quando algo precisar ser removido do ar
  • Liste artigos que estão obsoletos ou para revisão em um espaço de trabalho, e sinalize os que precisam de revisão agora
  • Reatribuía o feedback dos leitores ao membro certo da equipe e acompanhasse até a conclusão

Como todas as operações de fluxo de trabalho e publicação seguem o mesmo modelo de permissões e governança do portal, os gestores mantêm controle total sobre quem pode fazer o quê.

Desfecho

Gerentes de documentação gastam menos tempo perseguindo status de revisão e publicando manualmente o conteúdo, e mais tempo garantindo a qualidade e consistência da documentação em toda a equipe.


Usando fontes de dados externas junto com o Document360 MCP

O servidor MCP do Document360 expõe sua base de conhecimento aos assistentes de IA — permitindo que eles busquem, recuperem e atualizem conteúdo no Document360. No entanto, seu assistente de IA não está limitado a um único servidor MCP. Muitas plataformas de IA suportam conectar múltiplos servidores MCP simultaneamente, o que significa que o Document360 MCP pode funcionar junto com outras ferramentas habilitadas para MCP na mesma conversa.

Um cenário comum: puxar conteúdo de uma ferramenta externa para o Document360

Sua equipe pode armazenar informações estruturadas em uma plataforma de terceiros — uma ferramenta de gerenciamento de projetos, um banco de dados, uma wiki ou um sistema de dados de clientes — e querer que essas informações informem ou preencham artigos no Document360. Se essa plataforma fornecer seu próprio servidor MCP, você pode conectar ambos os servidores ao seu assistente de IA ao mesmo tempo.

Com ambos conectados, um fluxo de trabalho típico é o seguinte:

  1. O assistente de IA extrai dados estruturados da ferramenta externa usando o servidor MCP dessa ferramenta
  2. Ele recupera o artigo relevante do Document360 usando document360-mcp-get-article
  3. Ele redige ou atualiza o conteúdo do artigo com base no que foi retirado da fonte externa
  4. Ele atualiza o artigo no Document360 usando document360-mcp-update-article
  5. Opcionalmente, ele transfere o artigo para revisar ou publicá-lo diretamente

Esse padrão é útil para manter a documentação sincronizada com dados que vivem fora do Document360 – por exemplo, gerando notas de lançamento a partir de um rastreador de projetos, preenchendo artigos de referência da API a partir de uma especificação interna ou criando artigos de onboarding a partir de um registro CRM.

O que você precisa

  • Seu assistente de IA deve suportar a conexão de múltiplos servidores MCP simultaneamente. Verifique a documentação do seu assistente de IA para confirmar essa capacidade e como configurar múltiplas conexões de servidores.
  • A plataforma externa deve fornecer seu próprio servidor MCP. Nem todas as ferramentas expõem um servidor MCP – verifique a documentação da plataforma ou os recursos para desenvolvedores.
  • Você precisa de credenciais de acesso apropriadas tanto para o servidor MCP da ferramenta externa quanto para o servidor MCP do Document360.

Desfecho

Equipes que trabalham em múltiplas plataformas podem usar seu assistente de IA como camada de coordenação — lendo de fontes externas e escrevendo conteúdo estruturado e revisado no Document360 — sem necessidade de copiar e colar manualmente entre ferramentas.


Melhores práticas

Siga estas melhores práticas ao usar MCP com assistentes de IA:

  • Use o MCP para recuperar documentação de fonte de verdade em vez de copiar manualmente o conteúdo
  • Verifique o conteúdo gerado por IA antes de movê-lo para revisá-lo ou publicá-lo no site da base de conhecimento
  • Especifique a versão do projeto ou linguagem quando precisar precisão
  • Use prompts claros e específicos ao solicitar conteúdo ou atualizações
  • Garanta que os papéis e permissões dos usuários estejam configurados corretamente, especialmente para operações de fluxo de trabalho e publicação
  • Ao criar termos de glossário, informe ao assistente de IA de onde deve vir a definição, como seus artigos da base de conhecimento. Caso contrário, ele pode usar informações gerais da web.
  • Após atualizar um artigo, agende sua próxima revisão para que o conteúdo não fique desatualizado despercebido

Limitações e considerações

  • Assistentes de IA só podem acessar o conteúdo permitido pela configuração do seu projeto
  • Conteúdo restrito ou não publicado permanece regido por regras de visibilidade
  • Saídas geradas por IA podem exigir validação antes do uso
  • O processo de configuração pode variar dependendo do assistente de IA
  • O suporte ao MCP pode variar dependendo do assistente de IA ou da ferramenta de desenvolvimento usada (como assistentes baseados em IDE ou clientes experimentais). Algumas ferramentas podem ter suporte limitado ou em evolução para capacidades de MCP.
  • Se um usuário tem diferentes funções de portal e de conteúdo entre categorias e artigos, o MCP aplica o papel de menor prioridade em todas as categorias e artigos. Por exemplo, se você tem acesso de Editor em uma categoria e acesso de Revisor em outra, o MCP trata ambos como Revisor.
  • Se um usuário receber dois papiéis personalizados, um com permissões de visualização para um conjunto de categorias e outro com permissões de atualização para um conjunto diferente de categorias, o papel com acesso à visualização terá precedência. Se você deseja que o usuário atualize artigos via MCP, por favor, certifique-se de que apenas o papel com permissões de atualização seja atribuído ao usuário.
  • Para usar ferramentas de workflow via MCP, os papéis personalizados do portal devem ter as permissões Visualizar as atribuições de workflow e Update workflow assignments explicitamente ativadas. Sem esses, mudanças de status do workflow não podem ser realizadas via MCP.
  • Para categorias de Página, não há permissão de Publicação independente nas configurações de função personalizadas. Se um papel personalizado tiver permissões de Visualizar e Atualizar para categorias, publicar categorias de Página via MCP é automaticamente permitido, consistente com o comportamento do portal.
  • Publicar e despublicar via MCP não é suportado para guias passo a passo.
  • Por favor, certifique-se de que a configuração de Acesso ao Conteúdo esteja configurada como 'Todos' para o usuário que tenta criar ou atualizar artigos via MCP. Se o Acesso ao Conteúdo do usuário estiver configurado como Nenhum, ele não poderá ler, criar ou atualizar artigos através da integração com o MCP.
  • Se um artigo for atualizado pelo MCP enquanto alguém o está editando no portal, o Document360 salva as alterações não salvas dessa pessoa como uma versão de Backup do Sistema , que pode ser restaurada a partir do histórico de revisões.
  • As ferramentas do Glossário funcionam apenas quando o recurso Glossário está incluído no plano do seu projeto, e atualizar o feedback dos leitores só funciona quando o gerenciador de Feedback está incluído no seu plano.
  • Termos do glossário não podem ser excluídos através do MCP, e a tradução do glossário não pode ser acionada a partir do MCP.
  • O feedback dos artigos só pode ser enviado para artigos publicados que tenham feedback ativado.