Autenticação com logon interativo (CLI)

O login interativo foi projetado para desenvolvedores que trabalham localmente que precisam de acesso rápido para testar servidores MCP. O cliente nesse método é o UiPath CLI (ferramenta de linha de comando uipath ) executando em sua máquina de desenvolvimento.

Quando você uipath auth, a CLI abre seu navegador padrão para a página de login do UiPath Cloud. Após a autenticação, a CLI salva o token de Portador resultante em um arquivo .env no seu diretório atual. Você inclui esse token no cabeçalho Authorization de suas solicitações HTTP para o ponto de extremidade do servidor MCP.

O login interativo é adequado para os seguintes cenários:

• Desenvolvimento e teste local de servidores MCP.
• Testes rápidos de API com cURL, Postman ou MCP Inspetor.
• Depuração de chamadas de ferramenta MCP com permissões completas de usuário.
• Qualquer cenário em que um desenvolvedor humano está presente no terminal.

Não é adequado para cenários unattended ou automatizados. Nesse caso, use um aplicativo externo . Para integrações de IDE, use o fluxo MCP OAuth.

Pré-requisitos

• O UiPath CLI é instalado em sua máquina de desenvolvimento.
• Você tem uma conta com a função Automation User, Automation Developer ou Folder Administrator na pasta que contém o Servidor MCP.

Autenticar e chamar um servidor MCP

1. Autenticar para UiPath:

   uipath auth
   

   A CLI abre seu navegador padrão. Faça login no UiPath Cloud para concluir a autenticação. A CLI salva o Token de Portador resultante em um arquivo .env em seu diretório atual como UIPATH_ACCESS_TOKEN.

2. Exporte o token para seu ambiente de shell:

   export UIPATH_ACCESS_TOKEN=$(grep UIPATH_ACCESS_TOKEN .env | cut -d= -f2)
   

3. Chame um servidor MCP usando o token exportado:

   curl -X POST "https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}" \
     -H "Authorization: Bearer $UIPATH_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}},"id":1}'
   

Resultado

O Servidor MCP valida o token e responde à solicitação initialize . Você pode enviar mensagens de protocolo MCP subsequentes com o mesmo cabeçalho Authorization em cada solicitação.

características do token

• Tipo: JWT
• Público: inclui OrchestratorApiUserAccess
• Emissor: UiPath Identity Server ({env}.uipath.com/identity_)
• Expiração: uma hora. Não há atualização automática. Execute novamente uipath auth para obter um novo token.

O token concede:

• Acesso a todas as pastas nas quais o usuário conectado possui atribuições de função.
• Todas as permissões que o usuário tem nessas pastas (herdadas de suas funções).
• Compatibilidade com atividades do Integration Service (o contexto do usuário está presente).

Tipos de servidor MCP aplicáveis

Esse método de autenticação funciona com todos os tipos de servidor MCP: UiPath, Codificado, Comando, Auto-hospedado, Remoto e Plataforma.