Casos de uso e fluxos de MCP

Etapas de configuração para conectar uma ferramenta externa pública ou privada à UiPath como um servidor MCP remoto e a autenticação necessária para cada uma.

Muitas das ferramentas de que seus agentes precisam já existem em outro lugar, talvez em um software que seja executado silenciosamente dentro de sua própria infraestrutura. Um servidor MCP remoto permite que você traga qualquer um deles para a UiPath como uma ferramenta MCP, para que seus agentes possam descobri-los e chamá-los da mesma forma que usam ferramentas criadas nativamente na plataforma e herdando as funcionalidades de governança da UiPath Platform.

A forma como você se conecta depende de onde a ferramenta reside:

• Diretivamente, se já estiver público na internet.
• Por meio do UiPath Relay, se ele estiver dentro de sua própria rede.

Esta página orienta ambos, com as etapas de configuração para cada um. Para os outros tipos de Servidor MCP, UiPath, Codificado, Comando e Auto-hospedado, consulte Tipos de servidor MCP.

Casos de uso

• Traga a API de um parceiro para suas automações: sua equipe já tem acesso à API para uma transportadora ou um provedor de pagamento. Como um Servidor MCP remoto, ele está disponível para seus agentes diretamente, sem nenhuma integração personalizada para criar ou manter.
• Conecte uma ferramenta SaaS de que seus agentes já precisam: muitas plataformas populares publicam seu próprio servidor MCP público. Depois de ser adicionada ao Orchestrator, ela fica disponível para todos os agentes e automação com acesso a essa pasta.
• Alcance um sistema interno sem expô-lo à internet: seu sistema de emissão de tíquetes ou um serviço legado é executado dentro do seu próprio data center e não pode ser publicado publicamente. Por meio do Relay, seus agentes podem chamar suas ferramentas sem uma única porta de entrada aberta.

Resumo

	Caso de uso 1: relay	Caso de uso 2: direto
Melhor para	Ferramentas dentro de sua própria rede ou data center	Ferramentas já acessíveis na internet
Configuração extra	Cliente de Relay instalado e registrado na sua rede	Nada além de adicionar o Servidor MCP
Alterações do firewall de entrada	Nenhum, o relay mantém um túnel somente de saída aberto	Nenhum

Caso de uso 1: MCP externo por meio de relay + OAuth

Fluxo de solicitação

O cenário

Uma ferramenta de que seus agentes precisam, um ERP, um sistema de emissão de tíquetes ou um serviço legado, é executada dentro da sua própria rede, atrás de um firewall, e não é acessível a partir da internet pública. Você quer que seus agentes da UiPath chamem suas ferramentas da mesma forma que chamam qualquer outro servidor MCP em seu catálogo, sem expô-lo à internet.

Acessibilidade e identidade precisam ser abordadas:

• Alcance de um host sem rota pública - resolvido via UiPath Relay
• Prova da identidade da UiPath do chamador - resolvida por meio da autenticação dinâmica do OAuth

A própria credencial da ferramenta permanece separada de ambas.

Se a ferramenta já estiver acessível a partir da internet pública, use o Caso de uso 2, pois o Relay não é necessário.

Configuração da conexão

Pré-requisitos:

• Relay provisionado para seu tenant, com o cliente de Relay instalado e registrado em sua rede. Consulte o guia do administrador do Relay para habilitação.
• Sua identidade tem a permissão MCPServers.View na pasta que conterá o servidor MCP. As funções Automation User e Automation Developer o incluem.
• A credencial que a própria ferramenta requer, uma chave de API ou uma conexão do Integration Service, está pronta nessa pasta.

Instruções

1. Na página Servidores MCP , selecione Adicionar Servidor MCP.
2. Selecione o tipo Remoto .
3. Insira um Nome para o servidor MCP.
4. Adicione uma Descrição.
5. Defina o tipo de conexão como Privado (Relay).
6. Configurar a autenticação:
   • Conexão: selecione ou adicione uma conexão do Integration Service a ser usada para obter o token de autenticação.
     
   • Token de autenticação: na seção Cabeçalho, adicione um token de autenticação estático. Recomendamos fazer referência a um ativo em vez de codificar um segredo, por Authorization: %ASSETS/RemoteBearerToken%,.
     
7. Em Remote URL, insira o endereço da ferramenta conforme visto dentro de sua rede, o mesmo endereço que o cliente de Relay já alcança.
8. Selecione Adicionar.

Autenticação do chamador

Os chamadores autenticam-se da mesma forma que com qualquer outro servidor MCP: por meio do fluxo OAuth do MCP para clientes interativos, como um IDE, ou um token de acesso pessoal, aplicativo externo ou logon interativo para chamadores automatizados. Consulte Autenticação do Servidor MCP para obter a matriz do método completa.

POST https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}
Authorization: Bearer <token>
Content-Type: application/json

{ "jsonrpc": "2.0", "method": "tools/list", "id": 1 }

Suas credenciais de login nunca são compartilhadas com a ferramenta. Sua própria credencial, do campo Cabeçalhos ou Conexão acima, é aplicada separadamente em cada chamada.

Verificação da conexão

Uma chamada tools/list que retorna as ferramentas da ferramenta confirma que a identidade do chamador e a própria credencial da ferramenta foram aprovadas. Se a chamada falhar:

• 401 geralmente significa o token do chamador.
• 403 geralmente significa que a pasta não está MCPServers.View.
• 502 ou 504 geralmente significa que o cliente de Relay está offline ou que a ferramenta rejeitou sua própria credencial.

Consulte Solução de problemas da autenticação do servidor MCP e Solução de problemas de servidores MCP para obter mais detalhes.

Caso de uso 2: MCP externo, direto + OAuth

O cenário

Uma ferramenta de que seus agentes precisam já está publicada na internet pública, um SaaS ou servidor MCP parceiro, ou um que você hospeda e se expõe. Você deseja que seus agentes o chamem da mesma forma que chamam qualquer outro servidor MCP, com a mesma governança e trilha de auditoria, sem precisar do Relay.

Se a ferramenta for privada ou local, use o Caso de uso 1 .

Configuração da conexão

Pré-requisitos:

• Sua identidade tem a permissão MCPServers.View na pasta que conterá o servidor MCP. As funções Automation User e Automation Developer o incluem.
• A credencial que a própria ferramenta requer, uma chave de API ou uma conexão do Integration Service, está pronta nessa pasta.

Instruções

1. Na página Servidores MCP , selecione Adicionar Servidor MCP.
2. Selecione o tipo Remoto .
3. Insira um Nome para o servidor MCP.
4. Adicione uma Descrição.
5. Defina o tipo de conexão como Padrão.
6. Configurar a autenticação:
   • Conexão: selecione ou adicione uma conexão do Integration Service a ser usada para obter o token de autenticação.
     
   • Token de autenticação: na seção Cabeçalho, adicione um token de autenticação estático. Recomendamos fazer referência a um ativo em vez de codificar um segredo, por Authorization: %ASSETS/RemoteBearerToken%,.
     
7. Em URL remota, insira o endereço da ferramenta conforme visto dentro de sua rede.
8. Selecione Adicionar.

Autenticação do chamador

Os chamadores autenticam-se da mesma forma que com qualquer outro servidor MCP: por meio do fluxo OAuth do MCP para clientes interativos, como um IDE, ou um token de acesso pessoal, aplicativo externo ou logon interativo para chamadores automatizados. Consulte Autenticação do Servidor MCP para obter a matriz do método completa.

POST https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}
Authorization: Bearer <token>
Content-Type: application/json

{ "jsonrpc": "2.0", "method": "tools/list", "id": 1 }

Verificação da conexão

Uma chamada tools/list que retorna as ferramentas da ferramenta confirma que a conexão funciona. Se a chamada falhar:

• 401 geralmente significa o token do chamador.
• 403 geralmente significa que a pasta não está MCPServers.View.
• 502 geralmente significa que a ferramenta está inacessível ou que rejeitou a própria credencial.
• Um erro de conexão onde nenhum é esperado geralmente significa que o endereço é resolvido para um host privado ou interno; alterne para o Caso de uso 1.

Consulte Solução de problemas da autenticação do servidor MCP e Solução de problemas de servidores MCP para obter mais detalhes.