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, atualização, publicação e gerenciamento de fluxos de trabalho 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, atualização e publicação de conteúdo, além de gerenciar fluxos de trabalho. 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.
- As operações de fluxo de trabalho respeitam as etapas de revisão configuradas do seu projeto e as permissões baseadas em funções.
- As operações de publicação seguem as mesmas regras do portal; o conteúdo só pode ser publicado ou não publicado por usuários com as permissões apropriadas.
-
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, fluxo de trabalho ou publicação, 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, mantendo a integridade do seu sistema de documentação.
Antes de começar
Antes de ativar o MCP, certifique-se do seguinte:
- 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.
- Publicação, despublicação e operações de fluxo de trabalho seguem o mesmo modelo de permissões do portal. Apenas usuários com as permissões apropriadas podem realizar essas ações.
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 suportam coletivamente descoberta estruturada, recuperação contextual, atualizações controladas de conteúdo, gerenciamento de fluxos de trabalho e operações de publicação.
Ferramentas de busca e recuperação
| Ferramenta | Descrição |
|---|---|
document360-mcp-search |
Realiza uma busca semântica em todo o seu projeto de base de conhecimento. Corresponde por significado, não pela redação exata. Pesquisa todas as versões do projeto por padrão, ou uma versão específica quando necessário. |
document360-mcp-find-text |
Encontra uma palavra ou frase exata, com diferencial de maiúsculas e minúsculas, em qualquer lugar da sua documentação e retorna todas as categorias de artigo e página que a contêm, com suas URLs públicas. |
document360-mcp-list-documents |
Lista artigos e categorias de páginas usando filtros como versão, idioma, categoria, status, tags, rótulos ou data de atualização. |
document360-mcp-get-article |
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. |
document360-mcp-get-categories |
Recupera a estrutura completa de categorias de uma versão selecionada do projeto, incluindo categorias filhos e artigos associados. |
document360-mcp-get-category |
Recupera informações detalhadas para uma categoria específica, incluindo seu conteúdo, subcategorias e artigos associados. |
document360-mcp-get-project-versions |
Lista todas as versões disponíveis do projeto junto com seus identificadores, permitindo operações específicas de cada versão. |
document360-mcp-get-workflow-statuses |
Lista os status do fluxo de trabalho configurados para o projeto, com seus identificadores. |
document360-mcp-get-workflow-assignees |
Lista os usuários e grupos que podem ser atribuídos ao fluxo de trabalho de um artigo. |
Essas ferramentas permitem descoberta estruturada e acesso contextual ao conteúdo da documentação.
Ferramentas de escrita
| Ferramenta | Descrição |
|---|---|
document360-mcp-create-article |
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. |
document360-mcp-update-article |
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. |
document360-mcp-create-category |
Cria uma nova categoria dentro de uma versão selecionada do projeto. Suporta estruturas hierárquicas de categoria. |
document360-mcp-update-category |
Atualiza propriedades de categoria, como nome, posição, hierarquia ou visibilidade dentro da base de conhecimento. |
document360-mcp-update-category-content |
Atualiza o conteúdo das páginas de categoria (aplicável para categorias do tipo Página ou Índice) preservando a estrutura existente. |
document360-mcp-publish-article |
Publica um artigo promovendo seu rascunho mais recente para a versão ao vivo. |
document360-mcp-unpublish-article |
Despublica um artigo e o remove do site da base de conhecimento ativa. |
document360-mcp-publish-category |
Publica o conteúdo mais recente de rascunho da categoria de página até a versão ao vivo. |
document360-mcp-unpublish-category |
Despublica uma categoria de Página e a remove do site da base de conhecimento ativa. |
document360-mcp-set-workflow-status |
Define o status do fluxo de trabalho de uma categoria de artigo ou página, com data de entrega opcional, comentário e designados. |
As operações de escrita seguem o mesmo comportamento de versionamento e regras de tratamento de conteúdo do editor Document360.
Essas ferramentas podem ser usadas individualmente ou em combinação para suportar fluxos de trabalho de documentação de ponta a ponta. Por exemplo, assistentes de IA podem buscar um artigo, atualizar seu conteúdo, movê-lo por um fluxo de trabalho de revisão e publicá-lo no site ao vivo – tudo em uma única conversa. 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, fluxos de trabalho estruturados de revisão e aprovação, além de manter a consistência entre múltiplos artigos. A experiência com prompts e respostas pode variar dependendo do assistente de IA utilizado, pois cada ferramenta interpreta e processa solicitações de forma diferente. Você pode monitorar como sua base de conhecimento está sendo acessada pelo MCP usando o painel de análise do servidor MCP .