Autenticação padrão para nuvem

Quando os servidores MCP são executados localmente (usando uipath run), a autenticação acontece em duas camadas separadas:

• Runtime para cloud: o runtime local autentica-se para que possa registrar o Servidor MCP na nuvem.
• Cliente para nuvem: os clientes externos autenticam-se quando chamam o ponto de extremidade do Servidor MCP voltado para a nuvem.

Camada 1: runtime para a nuvem (registro do servidor)

O comando uipath run precisa de seu próprio token para registrar o servidor MCP na nuvem. Esta é a autenticação do desenvolvedor, a identidade da pessoa que executa o servidor localmente.

# Authenticate the runtime — interactive login
uipath auth

# Or authenticate the runtime — client credentials
uipath auth --client-id "..." \
  --client-secret "..." \
  --base-url "https://cloud.uipath.com/{org}/{tenant}" \
  --scope "OR.Default"

# Start the local server
uipath run mcp-server

O runtime usa esse token para estabelecer uma conexão do SignalR com a nuvem e registrar as ferramentas do servidor.

Camada 2: cliente para nuvem (chamando o servidor)

Os clientes externos (como MCP Inspetor, cURL, um IDE ou qualquer cliente HTTP) autenticam-se na nuvem por meio de qualquer um dos quatro métodos padrão descritos em Autenticação do servidor MCP. A URL é a mesma que para qualquer outro servidor MCP:

https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}

Como as solicitações fluem

O token de Bearer do cliente nunca chega ao runtime local. A nuvem valida o token e encaminha apenas a mensagem de protocolo MCP por meio do Redis. O runtime local e o processo do servidor MCP não veem o token.

Tipos de servidor MCP aplicáveis

A autenticação campo para nuvem aplica-se a tipos de servidor MCP que têm um runtime local:

• Auto-hospedado: sempre é executado localmente, sempre usa autenticação campo a nuvem.
• Codificado e Comando: use autenticação campo para nuvem quando executado localmente através de uipath run durante o desenvolvimento. Uma vez implantados no Orchestrator, eles são executados como trabalhos em nuvem e nenhum runtime local está envolvido.

Credenciais de cliente com servidores locais

Ao usar credenciais do cliente com uipath run, defina a variável de ambiente UIPATH_FOLDER_KEY . A chamada GetFoldersForCurrentUser do SDK do Python não é compatível com credenciais do cliente. Para obter detalhes, consulte Limitação conhecida: GetFoldersForCurrentUser.