Pular para o conteúdo
openapi.yaml ↓

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

  1. Nas configurações do ChatGPT, em Apps e conectores, ligue o modo desenvolvedor.
  2. Crie um conector, cole o endereço acima e escolha OAuth.
  3. 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

  1. No Claude, em Configurações, Conectores, adicione um conector personalizado com o endereço acima.
  2. No Claude Code: claude mcp add --transport http abeesys-rag https://api.rag.abeesys.com/mcp, e depois /mcp para autorizar.
  3. 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:

Só com "ler e escrever":

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".