Conectar o ChatGPT ou o Claude
O servidor MCP remoto deixa um assistente buscar, ler e perguntar ao conhecimento da sua conta, em seu nome — e, se você permitir, também criar, editar, arquivar e desarquivar conhecimento. Ele só começa depois que uma pessoa da conta autoriza, e quem escolhe o nível é ela.
O endereço
https://api.rag.abeesys.com/mcp
Cole exatamente este endereço. Ele é o deste ambiente: a autorização é emitida para ele, e o assistente confere. O endereço do dev-router (api-rag.dev.abeesys.com) responde, mas não serve para conectar — a autorização não fecha por ali.
ChatGPT
- Nas configurações do ChatGPT, em Apps e conectores, ligue o modo desenvolvedor.
- Crie um conector, cole o endereço acima e escolha OAuth.
- O ChatGPT abre a página de autorização do portal. Entre com o link de acesso, se pedir, confira o assistente e o endereço de volta, e escolha o nível.
Claude
- No Claude, em Configurações, Conectores, adicione um conector personalizado com o endereço acima.
- No Claude Code:
claude mcp add --transport http abeesys-rag https://api.rag.abeesys.com/mcp, e depois/mcppara autorizar. - A autorização é a mesma tela do portal. No Claude Code, a volta é para o seu computador (
localhost), e a tela avisa disso.
Os dois níveis
Quando o assistente pede para escrever, a tela de autorização mostra o que cada nível permite e três botões: Permitir ler e escrever, Permitir só ler e Recusar. Não há opção marcada por padrão. Quando ele pede só para ler, a tela tem Autorizar e Recusar.
- Ler (
rag.read) - Buscar, ler e perguntar ao conhecimento da conta. Não altera nada.
- Escrever (
rag.write) - Criar, editar, arquivar e desarquivar conhecimento da base comum da conta. Vem sempre junto de ler.
Uma autorização só de leitura nunca ganha escrita sozinha: para escrever, conecte de novo no assistente e escolha "Permitir ler e escrever".
O que o assistente faz
Com qualquer nível:
search: os itens do conhecimento que a busca da pergunta traria, até 10.fetch: o texto atual de um item.ask: a resposta verificada, com o nível de confiança e as origens.
Só com "ler e escrever":
create_knowledge: inclui um conhecimento novo na base comum, já publicado. Com umachave, repetir o mesmo pedido não duplica: devolve o registro, ou grava uma versão nova se o texto mudou.update_knowledge: grava uma versão nova de um item. A versão anterior fica no histórico. O que não vai no pedido fica como está; para tirar a validade (vigente_de,vigente_ate), afonteou oidiomajá gravados, envie o argumento como texto vazio.archive_knowledge: tira um item de todas as respostas, sem apagar texto nem versão.unarchive_knowledge: devolve às respostas um item arquivado.
O que o assistente grava publica direto: vale nas respostas na hora, para todos os sistemas e pessoas da conta, como uma inclusão pela API. Não há rascunho nem fila de aprovação. Nada é apagado: editar guarda a versão antiga, arquivar se desfaz com unarchive_knowledge, e cada mudança fica no rastro do item com a pessoa que autorizou e o assistente.
O alcance é só a base comum da conta: o que está publicado, sem rascunho, vetado, negativo nem escopo — para ler, sem o arquivado; para editar, arquivar e desarquivar, com ele. A autorização não abre a API REST nem o painel.
Um assistente conectado só para ler que tentar escrever recebe a resposta "Este assistente foi conectado só para ler", e nada é gravado.
Revogar
No painel, em Assistentes conectados, cada autorização mostra o assistente, para onde ele volta, quem autorizou, quando, o último uso e o que pode: "ler" ou "ler e escrever". Revogar vale na hora: a próxima chamada do assistente é recusada, de leitura ou de escrita. Remover a pessoa que autorizou também derruba as autorizações dela.
Para tirar a escrita de um assistente, revogue a autorização e conecte de novo, escolhendo "Permitir só ler".