HelpDocs
Busque e recupere o conteúdo de artigos, crie e atualize artigos, reorganize categorias e obtenha análises sobre o que os leitores pesquisam.
Documentação
Visão geral do MCP do HelpDocs
O servidor MCP (Model Context Protocol) do HelpDocs permite que assistentes de IA como Claude e OpenAI se conectem diretamente à sua Base de Conhecimento. Depois de conectado, seu assistente pode pesquisar, ler e até redigir artigos para você, sem sair do conforto da interface do seu assistente de IA.
Este recurso está disponível em determinados planos.
Recursos do MCP
Após a conexão, seu assistente de IA poderá:
- Pesquisar seus artigos e categorias
- Ler o conteúdo completo de qualquer artigo
- Criar, atualizar e excluir artigos e categorias (incluindo rascunhos)
- Obter análises e detalhes da conta
O MCP é um padrão aberto, portanto a mesma configuração funciona em qualquer cliente compatível com MCP.
Conectando ao MCP
Primeiro, habilite o MCP no HelpDocs:
- Vá para Configurações > IA
- Certifique-se de que Habilitar Ferramentas de IA esteja marcado
- Selecione Acesso MCP no menu suspenso Escolher recursos
- Clique em Salvar alterações
As etapas exatas variam dependendo do cliente de IA que você está usando, mas o processo de configuração é semelhante em todas as plataformas. Você precisará fornecer ao seu cliente um nome:
HelpDocs
e uma URL MCP:
https://•••••••••••••••••••••••••• Clique para revelar a URL Copiar
Depois de adicionado, vamos orientá-lo nas etapas para Autorizar o uso do MCP.
Se você tiver várias contas do HelpDocs, poderá escolher qual delas conectar ao seu MCP por meio do fluxo de autorização 🏄♂️
Conectando sem um navegador
O fluxo de autorização acima precisa que alguém clique em Autorizar em um navegador. Se o seu cliente for executado sem interface gráfica—um pipeline de CI, um script agendado, um agente auto-hospedado—não haverá ninguém para fazer isso.
Nesse caso, você pode autenticar com uma chave de API em vez disso, usando uma chave criada em Configurações > API.
Confirmando que funciona
Depois de conectado, pergunte ao seu assistente algo como "Pesquise meus artigos do HelpDocs por cobrança". Se ele retornar uma lista dos seus artigos, está tudo certo ✅
Não está vendo resultados? Tente isto 👇
- Verifique novamente se a URL está correta e não foi revogada, indo para Configurações > API
- Certifique-se de que o host e o caminho foram inseridos exatamente, sem espaços no final
- Reconecte o cliente para atualizar a autorização
É isso! Seu assistente de IA agora está conectado diretamente à sua Base de Conhecimento 🚀