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.
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 a conexão simultânea de múltiplos servidores MCP, 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 os 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:
- O assistente de IA extrai dados estruturados da ferramenta externa usando o servidor MCP dessa ferramenta
- Ele recupera o artigo relevante do Document360 usando
document360-mcp-get-article - Ele redige ou atualiza o conteúdo do artigo com base no que foi retirado da fonte externa
- Ele atualiza o artigo no Document360 usando
document360-mcp-update-article - 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 funcionalidade e como configurar múltiplas conexões de servidor.
- 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
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 um usuário tem papéis diferentes em portais e conteúdos entre categorias e artigos, o MCP aplica o papel 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.
- 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.