Servidor MCP remoto com login OAuth: por que não colar chave no agente

Um servidor MCP remoto com login OAuth deixa a pessoa entrar no próprio serviço pelo navegador, sem colar nenhuma chave no arquivo de configuração do agente. Vale para os conectores que têm login OAuth, como os do Google; serviços que só aceitam chave pedem a chave colada uma vez na tela de login do conector. O agente recebe uma autorização para usar o serviço, e a senha continua com quem a tem. Isso muda o que pode vazar, o que pode ser revogado e quem decide o que o agente faz.

Por que não colar chave no agente

Quando um agente precisa de uma chave de API, a forma mais comum é colá-la no arquivo de configuração do cliente. Funciona, mas a chave passa a morar num arquivo local, em geral em texto puro, e qualquer um que tenha acesso a esse arquivo tem acesso à conta. Se a chave vaza, o estrago só para quando alguém a troca manualmente, e isso costuma demorar.

Com OAuth, o cliente não guarda o segredo do serviço. Ele guarda um token de acesso, que tem prazo e pode ser revogado sem mudar a senha da conta. A pessoa também vê, na própria conta do serviço, que aquele acesso existe e pode retirá-lo.

O que a pessoa autoriza

Na primeira vez que o cliente chama o servidor, ele abre a tela de login no navegador. A pessoa entra com a conta que já usa, por exemplo a conta Google, e vê a lista de permissões que o conector está pedindo.

Essa lista é o contrato. Um conector de leitura pede só leitura. Um de escrita pede também a permissão de alterar, e as ferramentas que alteram algo pedem a sua aprovação dentro do cliente antes de executar. Se a lista não couber no que você quer, você recusa e nada é liberado.

O que o agente recebe

Depois da autorização, o servidor troca o código do login por um token de acesso e o usa para falar com o serviço em nome da pessoa, sem mantê-lo além do que a conexão exige. O agente não recebe a senha nem a chave original do serviço; ele recebe a capacidade de fazer as chamadas que a permissão cobre, e só isso.

Para serviços que não têm login OAuth, como alguns que só aceitam chave, o caminho é diferente: a chave é colada uma única vez numa tela de login do próprio conector e guardada criptografada no servidor, não no arquivo do cliente. O agente continua sem ver o segredo.

Leitura e escrita não são a mesma coisa

Um detalhe que importa no dia a dia: ferramentas de leitura se declaram como tal e rodam sem pedir confirmação, porque olhar um relatório não altera nada. Ferramentas de escrita pedem aprovação antes de agir. Assim, o agente pode consultar seus números à vontade, mas publicar, pausar uma campanha ou enviar um convite continua dependendo de você.

No Connectors, a divisão aparece nas próprias ferramentas: as de leitura se declaram como tal e as de escrita pedem aprovação. Se as permissões pedidas no login parecem maiores do que a tarefa, vale desconfiar e recusar.

O que fica guardado

Guardar o token não é guardar os dados do serviço. No caso dos conectores feitos no Agents, ficam guardados os tokens de acesso, criptografados, enquanto a conexão existir, e contadores de uso para os limites, apagados em até dois dias. Os dados do serviço só passam pelo servidor: não são guardados, vendidos nem usados para treinar modelos.

Para revogar, basta desconectar o conector no cliente ou retirar a permissão na conta do próprio serviço.

Perguntas frequentes

O login OAuth é mais seguro que uma chave?

Em geral sim, porque o segredo da conta não sai do serviço e o acesso pode ser retirado a qualquer momento na conta do serviço. Também é mais fácil de revogar do que trocar uma chave espalhada em arquivos. Mas a segurança depende também de pedir só as permissões necessárias.

O agente consegue fazer tudo o que a minha conta faz?

Não. Ele faz o que a permissão concedida cobre. Além disso, as ações de escrita pedem a sua aprovação dentro do cliente.

E se o serviço não tiver login OAuth?

Então a chave é colada uma vez na tela de login do conector e guardada criptografada no servidor, fora do arquivo do cliente. Ainda é melhor do que deixá-la em texto puro na configuração.

Para continuar lendo

• O que é um servidor MCP e para que ele serve

• Como conectar o Claude às suas ferramentas com um conector MCP

• Agente que pede aprovação antes de enviar, pagar, apagar ou publicar

Conectar seus serviços sem espalhar chaves

Os conectores do Agents, que são servidores MCP remotos com login, seguem essa lógica: você cola o endereço, entra com a sua conta e pede. Os dados só passam pelo servidor, sem serem guardados, vendidos nem usados para treinar modelos. Conhecer o Connectors

Fontes

• Referência do Connectors para pessoas e agentes (llms.txt)

• Página do Connectors