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 trabalham juntas por meio de prompts, tornando possível realizar 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 seu site de base de conhecimento, tudo com base na estrutura do projeto e nas permissões. Entender como essas ferramentas funcionam ajuda você 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. Pesquisa todas as versões do projeto por padrão, ou uma versão específica quando você precisar. | Encontre documentação relevante, descubra artigos relacionados, pesquise em diferentes versões |
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 |
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. Feito para atualizações parciais, assim você pode 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
Solicitações de MCP estão sujeitas a limites de taxa baseados no seu plano Document360. Esses limites se aplicam a cada usuário em todas as chamadas de ferramentas MCP.
Esses limites ajudam a garantir desempenho confiável e uso justo em todos os fluxos de trabalho de documentação.
Se o limite de taxa for ultrapassado, as requisições podem ser limitadas até que a próxima janela de tempo seja reiniciada.
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
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 chance de fluxos de trabalho interrompidos.