O MCP Server permite que assistentes externos de IA 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 movimentam entre múltiplos artigos, versões e categorias para reunir 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 a 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
- Refinar ou reescrever o conteúdo diretamente dentro do sistema de documentação
- Atualize artigos sem copiar manualmente o conteúdo entre ferramentas
- 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
Em vez de redigir isoladamente e colar conteúdo depois, os escritores 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. Quaisquer revisões ou estados de revisão bifurcados 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 programação assistidos por IA, como Cursor ou outras ferramentas habilitadas por IA. Ao consultar documentação, eles precisam de informações precisas e conscientes de versões, 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
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 várias 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 múltiplas versões e idiomas. Em alguns casos, a documentação pode nem 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:
- 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
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.
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
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.
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
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 utilizada (como assistentes baseados em IDE ou clientes experimentais). Algumas ferramentas podem ter suporte limitado ou em evolução para capacidades MCP.
- Se uma conta de equipe possui diferentes funções de portal e de conteúdo entre categorias e artigos, o MCP aplica a função de menor prioridade em todas as categorias e artigos. Por exemplo, se você tem acesso ao Editor em uma categoria e ao Revisor em outra, o MCP trata ambos como Revisor.
- Se um usuário receber dois papé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 tem prioridade. Se você deseja que o usuário atualize os artigos via MCP, por favor, certifique-se de que apenas a função com permissões de atualização seja atribuída ao usuário.
- Para usar ferramentas de workflow via MCP, os papéis personalizados do portal devem ter explicitamente ativadas as permissões Visualizar atribuições de workflow e Atualizar atribuições de workflow . Sem esses, mudanças de status do fluxo de trabalho 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 uma função personalizada tiver permissões de Visualizar e Atualizar para categorias, publicar categorias de Página via MCP é permitido automaticamente, consistente com o comportamento do portal.
- Publicar e despublicar via MCP não é suportado para guias passo a passo.
Solução de problemas
Se você encontrar problemas ao usar MCP:
- Confirme que o MCP está ativado no Document360
- Verifique se a URL do servidor MCP está correta
- Garantir que a autenticação OAuth seja concluída com sucesso
- Verifique se seu assistente de IA suporta conectores MCP ou personalizados
Se o problema persistir, consulte a documentação do assistente de IA ou entre em contato com o suporte.