Planos compatíveis com este recurso: Business Enterprise
O servidor Model Context Protocol (MCP) no Document360 expõe o conteúdo da sua base de conhecimento por meio de uma interface estruturada para interação com a documentação. Em vez de acessar a documentação como páginas web renderizadas, o MCP permite que assistentes de IA (ChatGPT, Claude) interajam diretamente com o conteúdo subjacente. Com o MCP habilitado, sua base de conhecimento fica acessível por meio de assistentes de IA definidos que realizam operações específicas como busca, recuperação, criação e atualização de conteúdo, tudo dentro das regras existentes do seu projeto.
O que é MCP?
O MCP é um padrão aberto que permite que assistentes de IA se conectem com segurança a sistemas externos e acessem dados estruturados. Em vez de construir integrações separadas para cada assistente de IA e cada plataforma, o MCP oferece uma interface comum que padroniza como os assistentes de IA se comunicam com plataformas externas.
Um servidor MCP atua como uma ponte entre um assistente de IA e seu sistema. Ele expõe capacidades específicas, como busca de conteúdo, recuperação de documentos ou realização de atualizações estruturadas por meio de um protocolo definido. O assistente de IA envia uma requisição estruturada para o servidor MCP, e o servidor responde com dados estruturados que o assistente pode usar. Você pode pensar no MCP como um conector universal para integrações de IA. Em vez de criar conexões personalizadas para cada ferramenta, o MCP permite uma única forma padronizada para que assistentes de IA interajam com sistemas reais e atualizados.
Ao usar o MCP, assistentes de IA não se limitam a gerar respostas apenas a partir dos dados de treinamento. Eles podem recuperar conteúdo ao vivo, acessar documentação estruturada e realizar ações definidas através do servidor MCP, tornando seus resultados mais relevantes e conscientes do contexto.
O desafio que as organizações enfrentam com assistentes de IA
Muitas organizações estão adotando assistentes de IA, tais como:
ChatGPT
Claude
GitHub Copilot
Agentes internos de IA
No entanto, esses assistentes frequentemente não têm acesso direto ao conhecimento estruturado de negócios.
Como resultado:
Ferramentas de IA não podem acessar facilmente bases de conhecimento
A documentação não está integrada aos fluxos de trabalho de IA
Desenvolvedores e equipes de suporte copiam e colam a documentação manualmente
Manter uma documentação consistente torna-se difícil
As organizações precisam de uma forma estruturada de conectar assistentes de IA com seus sistemas de documentação. O Document360 MCP resolve esse problema.
Por que MCP no Document360
A documentação no Document360 é estruturada entre versões de projetos, múltiplas linguagem, hierarquias de categorias e configurações de visibilidade baseadas em funções. Essa estrutura define como o conteúdo é organizado, acessado e governado dentro da sua base de conhecimento.
Quando a documentação é consumida apenas por meio de páginas web renderizadas, grande parte dessa estrutura é experimentada visualmente. Contexto de versão, seleção de linguagem e relações hierárquicas estão presentes, mas nem sempre explícitas quando acessadas programaticamente.
A disponibilidade do MCP depende da configuração e do plano do seu projeto. O MCP Server introduz uma forma padronizada para assistentes de IA interagirem com sua documentação por meio de capacidades definidas, como busca, recuperação e atualização de conteúdo. Em vez de depender apenas de resultados renderizados, assistentes de IA podem interagir com sua base de conhecimento de forma estruturada e controlada.
Por exemplo:
As operações de busca podem abranger várias versões do projeto por padrão ou direcionar uma versão específica quando necessário.
O conteúdo recuperado respeita suas regras de visibilidade e permissões configuradas.
As operações de escrita seguem o comportamento de versionamento existente e preservam a estrutura do conteúdo.
Ao mesmo tempo, o MCP opera inteiramente dentro da sua configuração existente. A disponibilidade de conteúdo reflete as configurações da versão do seu projeto, configuração de idioma, modelo de permissões e regras de visibilidade. Conteúdo não publicado ou restrito permanece regido por essas regras.
Quando ocorrem operações de escrita, o comportamento de versionamento existente é preservado. O MCP não sobrepõe fluxos de trabalho de documentação, regras de publicação ou controles de governança. Ele simplesmente fornece acesso estruturado à sua base de conhecimento enquanto mantém a integridade do seu sistema de documentação.
Antes de começar
Antes de ativar o MCP, certifique-se do seguinte:
Seu projeto está no plano de Negócios ou Empreendedorismo .
Você tem uma função de Proprietário do Projeto ou Administrador . Somente esses papéis podem ativar ou desativar o MCP para um projeto.
Você está usando um assistente de IA suportado (ChatGPT, Claude, GitHub Copilot, Cursor IDE, ou qualquer plataforma que suporte MCP ou conectores personalizados).
Para ativar o MCP e conectar seu assistente de IA, consulte o Connect MCP usando um conector personalizado.
Autenticação e controle de acesso
O MCP usa OAuth para autenticação. Quando você conecta um assistente de IA ao Document360 via MCP, a conexão está vinculada à conta de usuário que completa o fluxo OAuth.
Todas as interações MCP seguem o modelo de controle de acesso baseado em papéis (RBAC) do Document360. Isso significa:
O assistente de IA só pode acessar o conteúdo permitido para o usuário autenticado com base em seus papéis e permissões atribuídos.
Conteúdo restrito ou não publicado permanece regido pelas suas regras de visibilidade existentes.
Operações de escrita (criação ou atualização de artigos e categorias) só são possíveis se o usuário autenticado tiver as permissões apropriadas.
Ativar o MCP não concede acesso irrestrito à sua base de conhecimento por ferramentas externas.
Ferramentas MCP do Document360
O Servidor MCP fornece uma lista de ferramentas que definem como a documentação pode ser buscada, recuperada e gerenciada.
Cada ferramenta representa uma ação específica e intencional contra sua base de conhecimento. Em vez de expor conteúdo bruto ou endpoints abertos, o MCP estrutura interações por meio de operações claramente definidas. Isso garante que o acesso à documentação permaneça previsível, consciente de versões e alinhado com a configuração do seu projeto.
Essas ferramentas, coletivamente, suportam descoberta estruturada, recuperação contextual e atualizações controladas de conteúdo.
Ferramentas de busca e recuperação
Ferramenta | Descrição |
|---|---|
| Realiza uma busca semântica em toda a sua base de conhecimento. Por padrão, busca em todas as versões do projeto, a menos que uma versão específica seja fornecida. Retorna conteúdo relevante junto com metadados e referências de artigos. |
| Recupera o conteúdo completo do artigo usando um ID ou URL do artigo. Suporta múltiplos idiomas e permite buscar versões publicadas ou rascunhas. |
| Recupera a estrutura completa de categorias de uma versão selecionada do projeto, incluindo categorias filhos e artigos associados. |
| Recupera informações detalhadas para uma categoria específica, incluindo seu conteúdo, subcategorias e artigos associados. |
| Lista todas as versões disponíveis do projeto junto com seus identificadores, permitindo operações específicas de cada versão. |
Essas ferramentas permitem descoberta estruturada e acesso contextual ao conteúdo da documentação.
Ferramentas de escrita
Ferramenta | Descrição |
|---|---|
| Cria um novo artigo em uma categoria e versão do projeto especificadas. Suporta formatos de conteúdo estruturado e requer confirmação antes da criação. |
| Atualiza um artigo existente preservando sua estrutura e formatação. Suporta atualizações parciais e exige a recuperação do artigo antes da modificação. |
| Cria uma nova categoria dentro de uma versão selecionada do projeto. Suporta estruturas hierárquicas de categoria. |
| Atualiza propriedades de categoria, como nome, posição, hierarquia ou visibilidade dentro da base de conhecimento. |
| Atualiza o conteúdo das páginas de categoria (aplicável para categorias do tipo Página ou Índice) preservando a estrutura existente. |
As operações de escrita seguem o mesmo comportamento de versionamento e regras de tratamento de conteúdo do editor Document360.
Essas ferramentas de busca e escrita também podem ser usadas em combinação para suportar operações em lote ou múltiplas etapas. Por exemplo, assistentes de IA podem recuperar múltiplos artigos, gerar atualizações em conteúdos relacionados ou criar múltiplos artigos como parte de fluxos de trabalho estruturados. Isso torna o MCP adequado para cenários de automação, como atualizações em massa de conteúdo, criação de documentação em grande escala e manutenção da consistência entre múltiplos artigos. A experiência dos prompts e respostas pode variar dependendo do assistente de IA utilizado, já que cada ferramenta interpreta e processa solicitações de forma diferente.