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 conteúdo, além de manter termos de glossário, gerenciar lembretes de avaliação, trabalhar nas tarefas atribuídas e enviar feedback de artigos, 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.
-
O MCP está disponível nos planos Business e Enterprise. Se seu projeto estiver em um plano diferente, a página de Configurações de IA > MCP irá pedir para você atualizar antes de poder ativar o MCP.
Se seu projeto já estiver em um plano Business ou Enterprise, mas a página MCP ainda mostrar um pedido de atualização, primeiro confirme seu plano atual em Configurações > portal de base de conhecimento > Faturamento > Meu plano. Se a aba Meu plano mostrar corretamente Negócio ou Empresa e a página MCP ainda bloquear o acesso, entre em contato com o suporte do Document360 para que a equipe possa verificar a elegibilidade do seu plano do lado deles.
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 Conecte o MCP ao seu assistente de IA.
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 (como criar ou atualizar artigos, categorias e termos do glossário) 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.
- As ferramentas de tarefas só mostram e agem nas tarefas atribuídas ao usuário autenticado, diretamente ou por meio de um grupo.
- O feedback do artigo enviado pelo MCP é registrado contra o usuário autenticado. Contas de leitores podem enviar feedback do artigo, mas não podem usar outras ferramentas de escrita.
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 apoiam coletivamente descoberta estruturada, recuperação contextual, atualizações controladas de conteúdo, gerenciamento de fluxos de trabalho, operações de publicação, gestão de glossários, lembretes de revisões, gerenciamento de tarefas e feedback de artigos.
Quando o Document360 lança novas ferramentas MCP, seu assistente de IA não as detecta automaticamente. Atualize a lista de ferramentas no seu assistente de IA, ou desconecte e reconecte o conector do Document360 para começar a usá-las.
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 em qualquer lugar da sua documentação e retorna todas as categorias de artigos e páginas que a contêm, com seus URLs públicos. |
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. |
document360-mcp-list-glossary-terms |
Lista os termos do glossário do projeto, incluindo a definição de cada termo e as variantes linguísticas. |
document360-mcp-list-review-reminders |
Lista os artigos e categorias de páginas em um espaço de trabalho que possuem um lembrete de avaliação, seja estagnado ou agendado, com a data de revisão mais cedo primeiro. |
document360-mcp-get-my-tasks |
Lista as tarefas atribuídas a você em um espaço de trabalho, incluindo tarefas de fluxo de trabalho, feedback dos leitores e lembretes de revisão. Esta é a mesma lista da página de Tarefas no portal. |
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. |
document360-mcp-create-glossary-term |
Adiciona um novo termo ao glossário, seja como termo global ou como termo em nível linguístico para um idioma. |
document360-mcp-update-glossary-term |
Atualiza o termo ou definição de um termo glossário. Apenas os campos que você altera são atualizados. |
document360-mcp-set-article-review-reminder |
Agenda um lembrete de revisão em um artigo, sinaliza para revisão agora ou remove o lembrete. |
document360-mcp-snooze-task |
Ele adia uma das suas tarefas até uma data específica, ou traz uma tarefa que estava soneca. |
document360-mcp-mark-task-done |
Marca uma das suas tarefas do fluxo de trabalho como concluída, assim como Marca como concluída na página de Tarefas . Não muda o status do fluxo de trabalho. |
document360-mcp-update-feedback-status |
Atualiza o status, o destinatário ou a nota interna do feedback dos leitores atribuídos a você. |
document360-mcp-send-article-feedback |
Envia feedback sobre um artigo publicado para sua equipe de documentação, por exemplo, quando o conteúdo está pouco claro, desatualizado ou faltando informações. O feedback aparece no gerenciador de Feedback. |
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 .