Autenticação com um token de acesso pessoal

Os tokens de acesso pessoal (PATs) são tokens com escopos definidos pelo usuário com uma vida útil configurável (até um ano). Eles são úteis quando você precisa de um token de vida mais longa do que o login interativo fornece, ou quando você não pode executar uipath auth interativamente, mas ainda precisa autenticar como usuário.

Quando você cria um PAT, deve selecionar permissões do recurso Acesso à API do Orchestrator que cubram as operações MCP de que você precisa.

Pré-requisitos

• Você tem a função Automation User, Automation Developer ou Folder Administrator na pasta que contém o Servidor MCP. Essas funções incluem a permissão MCPServers.View .

Gerar um token de acesso pessoal

1. Acesse UiPath, selecione o ícone do usuário e, em seguida, selecione Preferências.

2. Navegue até Token de acesso pessoal e selecione Gerar novo token.

3. Insira um nome e uma data de validade.

4. Em Escopos, selecione as seguintes permissões do recurso Acesso à API do Orchestrator :

   • OR.Execution: necessário para listar ferramentas. Os servidores MCP chamam a API ListReleases do Orchestrator para resolver metadados do processo, e esse ponto de extremidade exige esse escopo.
   • OR.Jobs: necessário para executar ferramentas. Todos os tipos de servidor MCP que executam processos como ferramentas (UiPath, Codificado e Comando) chamam a API StartJobs do Orchestrator, que requer esse escopo.

5. Selecione Salvar e copie o token imediatamente.

   Importante:

   O token é mostrado apenas uma vez. Se você não copiá-lo agora, deverá gerar um novo token.

Resultado

O token agora está disponível para uso no cabeçalho Authorization de solicitações HTTP para o servidor MCP.

Use o token de acesso pessoal

Para chamar um servidor MCP com o token:

curl -X POST "https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}" \
  -H "Authorization: Bearer <your-PAT>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{...},"id":1}'

características do token

• Token opaco com público UiPath.Orchestrator.
• Expiração configurável (até um ano).
• O acesso é a interseção dos escopos do PAT e as permissões de funções no nível da pasta do usuário.
• Funciona com qualquer cliente HTTP (cURL, Postman, Inspetor MCP, código personalizado).

Limitações

• OS PATs estão vinculados a uma identidade de usuário específica. Se o usuário estiver desativado, o PAT deixará de funcionar.
• OS PATs só podem ser criados por usuários que têm acesso interativo à UiPath.
• As atividades do Integration Service não são compatíveis com a autenticação PAT. A conexão ao MCP é bem-sucedida, mas as chamadas de ferramenta que dependem de conexões do Integration Service falham.