Agora que você conectou o servidor MCP do Document360 aos seus assistentes de IA, vamos explorar como eles podem usar ferramentas MCP para buscar, recuperar, criar, atualizar, gerenciar fluxos de trabalho e publicar conteúdo na sua base de conhecimento.
Essas ferramentas funcionam em conjunto por meio de prompts, permitindo tarefas de documentação em múltiplas etapas com uma única instrução. Por exemplo, um assistente de IA pode buscar artigos existentes, recuperar detalhes de categorias, criar nova documentação, atualizar conteúdo existente, mover conteúdo por etapas de fluxo de trabalho e publicá-lo no site da sua base de conhecimento, tudo com base na estrutura do projeto e nas permissões. Entender como essas ferramentas funcionam ajuda a criar prompts mais eficazes e a construir fluxos de trabalho de documentação eficientes.
Ferramentas MCP
Ferramentas de busca e recuperação
| Ferramenta | O que ele faz | Use isso para |
|---|---|---|
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. | Descubra artigos relacionados, explore um tema ou encontre documentação quando você não souber exatamente a frase usada |
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. | Encontre cada documento contendo um termo exato, recursos de conteúdo ou trecho de código antes de uma atualização em massa |
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. | Construa uma lista de avaliações para um lançamento, audite uma categoria ou encontre tudo atualizado desde uma data |
document360-mcp-get-article |
Recupera o conteúdo completo de qualquer artigo usando seu ID ou URL. Funciona em vários idiomas e permite acessar versões publicadas e rascunhos. | Leia artigos existentes, revise o conteúdo preliminar, busque artigos antes de atualizar |
document360-mcp-get-categories |
Recupera a estrutura completa de categorias de uma versão selecionada do projeto, incluindo categorias filhos e artigos associados. | Navegue pela hierarquia da base de conhecimento, encontre IDs de categoria, entenda a estrutura da documentação |
document360-mcp-get-category |
Recupera tudo sobre uma categoria específica, seu conteúdo, subcategorias e artigos associados usando o ID da categoria. | Inspecionar uma categoria profundamente, ler o conteúdo da página da categoria, validar a categoria antes das atualizações |
document360-mcp-get-project-versions |
Lista todas as versões disponíveis do seu projeto junto com seus identificadores para que você possa executar operações específicas de cada versão com precisão. | Selecione a versão correta, crie prompts conscientes da versão, recupere IDs de versão válidos |
document360-mcp-get-workflow-statuses |
Lista os status do fluxo de trabalho configurados para o projeto, junto com seus identificadores e flags. | Descubra os status de fluxo de trabalho disponíveis, recupere os IDs de status antes de passar o conteúdo pelas etapas de revisão |
document360-mcp-get-workflow-assignees |
Lista os usuários e grupos que podem ser atribuídos ao fluxo de trabalho de um documento específico. | Encontre IDs válidos de cedentes antes de atribuir uma etapa do fluxo de trabalho, identifique quem pode revisar um documento |
Qual ferramenta de busca você deve usar? Depende do que você está procurando:
- Se você souber o assunto , mas não as palavras exatas, use
document360-mcp-search. Por exemplo, "o que nossos documentos dizem sobre redefinir uma senha?" - Se você souber a palavra ou frase exata que deseja encontrar, use
document360-mcp-find-text. Por exemplo, para encontrar todo artigo que contenha{{old_api_key}}. - Se você não tem um termo de busca e só quer uma lista de documentos, use
document360-mcp-list-documents. Por exemplo, todo artigo de uma categoria que foi atualizado no mês passado.
Ferramentas de escrita
| Ferramenta | O que ele faz | Use isso para |
|---|---|---|
document360-mcp-create-article |
Cria um novo artigo dentro de uma categoria específica e uma versão do projeto apoiando conteúdo estruturado. | Crie nova documentação na categoria certa, relabore artigos de ajuda faltantes, gere primeiros rascunhos a partir de prompts |
document360-mcp-update-article |
Atualiza um artigo existente preservando sua estrutura e formatação. Construído para atualizações parciais para que você possa revisar uma seção sem mexer no restante do artigo. | Atualize documentação desatualizada, revise artigos durante as atualizações do produto, reescreva seções específicas sem afetar o restante |
document360-mcp-create-category |
Cria uma nova categoria dentro de uma versão selecionada do projeto. Suporta estruturas aninhadas para que você possa construir subcategorias conforme seu conteúdo cresce. | Adicionar novas seções de documentação, criar subcategorias para novos recursos, organizar o conteúdo em novas estruturas |
document360-mcp-update-category |
Atualiza propriedades de categoria, como nome, posição, hierarquia ou visibilidade. | Renomear categorias, reorganizar a hierarquia, melhorar a estrutura |
document360-mcp-update-category-content |
Atualiza o conteúdo das páginas de categorias preservando a estrutura existente. | Atualize o conteúdo da página ou do índice das categorias, revise a visão geral da categoria ou seções introdutórias, atualize as orientações em nível de categoria sem afetar o restante da estrutura |
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. | Avance o conteúdo pelas etapas de revisão, designe revisores, defina prazos para tarefas de fluxo de trabalho |
document360-mcp-publish-article |
Publica um artigo promovendo seu rascunho mais recente para a versão ao vivo. | Faça um rascunho de artigo ativo no site da base de conhecimento após criá-lo ou atualizá-lo |
document360-mcp-unpublish-article |
Despublica um artigo e o remove do site da base de conhecimento ativa. O conteúdo é preservado e pode ser republicado. | Tire um artigo desatualizado ou incorreto do ar sem apagar |
document360-mcp-publish-category |
Publica o conteúdo mais recente de rascunho da categoria de página até a versão ao vivo. | Crie uma categoria de página ativa após atualizar seu conteúdo |
document360-mcp-unpublish-category |
Despublica uma categoria de Página e a remove do site da base de conhecimento ativa. O conteúdo é preservado e pode ser republicado. | Remova uma categoria de Página do site da base de conhecimento ativa sem excluí-la |
Limites de taxa
As requisições MCP estão sujeitas a limites de taxa baseados no seu plano Document360. Os limites são aplicados por usuário, por projeto, em todas as chamadas de ferramentas MCP dentro de uma janela fixa de um minuto. Operações de leitura e escrita compartilham o mesmo limite, então buscar, recuperar, criar e atualizar chamadas são todas extraídas de um mesmo pool. Dependendo do seu plano, o limite de taxa é de 60 ou 100 solicitações por minuto.
Esses limites ajudam a garantir desempenho confiável e uso justo em todos os fluxos de trabalho de documentação. Se você ultrapassar o limite de taxa, as requisições subsequentes podem ser retardadas até o início da próxima janela de um minuto.
Isso pode acontecer quando:
- Executando prompts automáticos frequentes
- Realizando buscas repetidas em rápida sucessão
- Execução de múltiplas operações de criação ou atualização ao mesmo tempo
Se seu fluxo de trabalho exigir um limite maior, entre em contato com seu Gerente de Sucesso do Cliente ou support@document360.com. Limites mais altos podem ser configurados de acordo com suas necessidades e podem envolver um custo adicional.
Melhores práticas para gerenciar limites de solicitações MCP
Para evitar limitação:
- Espaça pedidos frequentes ou automatizados
- Divida grandes fluxos de trabalho em sequências menores de prompts
- Reutilizar o contexto da categoria ou artigo recuperado sempre que possível
- Evite buscas paralelas repetidas em múltiplas versões
Isso ajuda a manter uma experiência MCP mais suave e reduz a probabilidade de interrupções no fluxo de trabalho.