Entenda as ligações OAuth
Distinguir o login numa ligação MCP da autorização dos seus serviços upstream.
Traduzido automaticamente do inglês. Ler o original em inglês
2 min de leitura · Guia do cliente
O OAuth é um padrão de autenticação compatível, mas cada fluxo de consentimento deve ser configurado e testado para o destino exato. Um teste de chave API bem-sucedido não estabelece a prontidão do OAuth para um cliente de IA específico.
Identifique as duas relações de consentimento#
Um cliente de IA pode autenticar-se numa instalação ou na sua gateway utilizando um fluxo de login primário compatível. Separadamente, um servidor pode necessitar de credenciais OAuth para chamar um serviço upstream em nome de uma conta empresarial.
Eles não são intercambiáveis. Um corretor OAuth upstream pode necessitar de autorização do fornecedor e de terminais de token, detalhes e escopos de registo do cliente. Não alterne uma ligação de chave API existente para OAuth apenas porque o cliente oferece um botão OAuth.
Siga o fluxo de ligação acordado#
Utilize o endereço exato do servidor ou gateway na transferência. Quando um ecrã de consentimento do navegador for aberto, verifique o domínio, a conta e o acesso solicitado. Autorize apenas o público e o âmbito pretendidos utilizando o processo normal do fornecedor.
Não envie um URL de retorno de chamada contendo um código de autorização para suporte ou cole-o numa conversa de IA. Mantenha os tokens e os segredos do cliente na rota de configuração encriptada suportada.
Verifique após consentimento#
Confirme se o cliente de IA regressa a um estado ligado, descobre apenas as ferramentas pretendidas e conclui a ação de leitura apenas acordada na conta correta. Onde a atualização fizer parte do fluxo configurado, verifique-a em vez de assumir que a ligação inicial durará indefinidamente.
Quando o consentimento falha#
Registe o estágio e o erro redigido. Um endereço de redireccionamento incompatível, um fluxo de registo sem suporte, uma conta errada, um âmbito em falta ou uma concessão upstream expirada podem exigir correções diferentes. Não desative a autenticação, aceite um aviso de certificado ou reutilize o token de outra pessoa como solução alternativa.