Tipos de servidor MCP

Servidores MCP da UiPath

O Servidor UiPath MCP expõe artefatos UiPath (fluxos de trabalho de RPA, agentes, fluxos de trabalho de API, processos por agente e atividades do Integration Service) como ferramentas MCP. Use-a quando a lógica de automação já existir no UiPath e precisar ser disponibilizada para modelos de IA.

Esse tipo de servidor é criado e gerenciado diretamente dentro da UiPath Platform, fornecendo integração nativa, implantação simplificada e governança centralizada por meio do Orchestrator.

Como funciona

A configuração acontece inteiramente no Orchestrator, na guia Servidores MCP com escopo de pasta. Os usuários selecionam os artefatos para expor como ferramentas e salvam o servidor. Nenhum empacotamento, código ou processo externo é necessário.

Depois de configurado, o servidor é acessível por meio do URL padrão do UiPath MCP Server. Para o formato da URL, consulte Obter a URL do servidor MCP.

Autenticação

Os servidores UiPath MCP usam o modelo de autenticação padrão de Servidor MCP. Para obter detalhes sobre os métodos compatíveis e permissões necessárias, consulte Autenticação do servidor MCP.

Uma restrição adicional se aplica: as ferramentas suportadas por atividades do Integration Service exigem tokens de contexto do usuário. Essas ferramentas funcionam com o login interativo ou o fluxo OAuth do MCP, mas não com tokens de acesso pessoal ou credenciais do cliente de aplicativos externos.

Configuração

Para obter instruções passo a passo, consulte Criação de servidores UiPath MCP.

Servidores MCP remotos

O Servidor MCP remoto permite que o UiPath se conecte a servidores MCP hospedados fora da Plataforma UiPath. O Orchestrator atua como um proxy, encaminhando solicitações de MCP para uma URL externa que você fornece.

O Servidor MCP remoto abrange dois cenários:

• Serviços de terceiros gerenciados externamente: por exemplo, Atlassian MCP ou Stripe MCP, alcançados pela internet pública.
• Servidores MCP no local que devem ser alcançados a partir do UiPath Cloud sem abrir portas de entrada. Ao marcar a opção Conectar por meio de Relay , o UiPath Relay estabelece um túnel de saída de longa duração de sua rede para o UiPath Cloud, e o Servidor MCP remoto é configurado em relação ao URL do relay. Nenhuma VPN, exposição pública ou conectividade de entrada é necessária.

Em ambos os cenários, o ponto de extremidade remoto deve falar HTTP Streamable.

Como funciona

A configuração acontece no Orchestrator fornecendo a URL remota e um conjunto opcional de cabeçalhos HTTP personalizados. Nenhum pacote, código ou processo da UiPath está envolvido.

Quando uma ferramenta é invocada, o Orchestrator encaminha a chamada para a URL remota junto com quaisquer cabeçalhos personalizados que estejam configurados. Cabeçalhos específicos da UiPath, incluindo o token de portador, não são encaminhados para o servidor remoto, portanto, sua identidade da UiPath nunca o alcança. Cabeçalhos personalizados com valores que contêm termos como secret, api_key ou token são mascarados na UI após o salvamento.

Custom header values can reference Orchestrator Assets using the %ASSETS/AssetName% syntax. Remote MCP Servers resolve these references through the Orchestrator asset API before forwarding the request, without requiring a robot or robot key. For details, check Using Orchestrator Assets in MCP Servers.

Autenticação

Os servidores MCP remotos usam o modelo de autenticação de Servidor MCP padrão. Todos os quatro métodos de autenticação compatíveis funcionam com esse tipo. Para obter detalhes, consulte Autenticação do servidor MCP.

Configuração

Para obter instruções passo a passo, consulte Criação de um servidor MCP remoto.

Servidores MCP de comando

O Servidor MCP de Comando permite que a UiPath integre um servidor MCP existente a partir de um feed de pacote externo, como NPM (npx) ou PyPI (uvx), usando um comando compatível com a plataforma. Use-a para executar servidores MCP pré-existentes ou de terceiros sem reempacotá-los como artefatos da UiPath.

Como funciona

Os servidores MCP de comando são executados no UiPath Serverless e são compatíveis com servidores MCP Python e JavaScript/Node.js. Cada servidor mantém uma sessão por trabalho, com uma duração máxima de trabalho de 15 minutos.

A configuração acontece no Orchestrator fornecendo o comando e seus argumentos. Nenhum pacote, código ou definição de processo da UiPath é necessário. A configuração é armazenada como uma entrada em mcp.json arquivo. Por exemplo:

{
  "servers": {
    "filesystem-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    }
  }
}

Um Servidor MCP de Comando compartilha o mesmo formato de runtime e configuração que os servidores MCP codificados e auto-hospedados. Para obter detalhes, consulte Base compartilhada do Servidor MCP.

Variáveis e segredos do ambiente

Environment variables are configured directly on the MCP Server in Orchestrator and are stored encrypted. Orchestrator Assets can be referenced for secrets management using the %ASSETS/AssetName% syntax. For details, check Using Orchestrator Assets in MCP Servers.

Autenticação

Os servidores MCP de comando usam o modelo de autenticação padrão de servidor MCP. Cada chamada de ferramenta inicia um trabalho sem servidor, portanto, os chamadores precisam das permissões MCPServers.View e Jobs.Create . Para obter detalhes, consulte Autenticação do servidor MCP.

Configuração

Para obter instruções passo a passo, consulte Criação de servidores MCP de comando.

Servidores MCP codificados

Um servidor MCP codificado é um servidor MCP Python escrito usando a estrutura FastMCP do pacote Python mcp e, em seguida, empacotado e publicado no Orchestrator como um artefato UiPath NuGet (.nupkg). A biblioteca uipath-mcp fornece a camada de runtime que integra o servidor à UiPath Platform.

Use esse tipo quando um Servidor MCP personalizado deve ser criado e hospedado na UiPath, com código armazenado, versionado e distribuído por meio do sistema de gerenciamento de pacotes da UiPath.

Como funciona

Os servidores MCP codificados são executados no UiPath Serverless. Cada servidor mantém uma sessão por trabalho, com uma duração máxima de trabalho de 15 minutos. As chamadas de ferramentas ativas estão sujeitas a um tempo limite de conexão de aproximadamente 3,5 minutos, e as sessões inativas são encerradas após aproximadamente 6 a 7 minutos de inatividade.

Para implantar um servidor MCP codificado, o código do servidor é compactado e publicado no Orchestrator usando a CLI uipath-mcp ; em seguida, o servidor MCP codificado é configurado no Orchestrator na mesma pasta em que o pacote foi implantado. O servidor é referenciado por uma entrada mcp.json :

{
  "servers": {
    "math-server": {
      "type": "stdio",
      "command": "python",
      "args": ["server.py"]
    }
  }
}

Como um servidor MCP de Comando, um servidor codificado é definido por mcp.json entrada. A diferença é que um servidor codificado executa código de um artefato UiPath NuGet publicado no Orchestrator, em vez de extrair um pacote de um feed externo.

Um servidor MCP codificado compartilha o mesmo runtime, formato de configuração e transporte que servidores MCP de Comando e Auto-hospedados. Para obter detalhes, consulte Base compartilhada do Servidor MCP.

Variáveis e segredos do ambiente

For Coded MCP Servers, environment variables are not configured on the MCP Server entity itself. Instead, they are set on the process in Orchestrator, in Settings > Environment Variables, and are stored encrypted. Orchestrator Assets can be referenced for secrets management using the %ASSETS/AssetName% syntax. For details, check Using Orchestrator Assets in MCP Servers.

Autenticação

Os servidores MCP codificados usam o modelo de autenticação padrão de Servidor MCP. Cada chamada de ferramenta inicia um trabalho sem servidor, portanto, os chamadores precisam das permissões MCPServers.View e Jobs.Create . Para obter detalhes, consulte Autenticação do servidor MCP.

Configuração

Para obter instruções passo a passo, consulte Criação de servidores MCP codificados. Para obter detalhes de implementação e um guia de introdução, consulte o uipath-mcp início rápido.

Servidores MCP auto-hospedados

O Servidor MCP auto-hospedado é executado em infraestrutura controlada pelo usuário, máquinas locais, servidores locais ou ambientes de nuvem privada, enquanto se conecta à UiPath para governança e capacidade de descoberta. Use-a quando o Servidor MCP precisar acessar recursos locais que não são acessíveis a partir da infraestrutura de nuvem ou quando a política exigir que o runtime esteja em um hardware de propriedade do cliente.

Como funciona

Um Servidor MCP auto-hospedado não pode ser configurado por meio da interface gráfica do Orchestrator. Em vez disso, ele se registra na UiPath quando iniciado localmente. Ao contrário de servidores MCP codificados e de comando, uma instância de runtime auto-hospedada é compatível com várias sessões simultâneas, com distribuição aleatória quando várias sessões se conectam ao mesmo campo de dados dinâmico. O ciclo de vida do servidor é totalmente controlado por você.

Um Servidor MCP auto-hospedado compartilha o mesmo runtime, formato de configuração e transporte que servidores MCP de Comando e Codificados. Para obter detalhes, consulte Base compartilhada do Servidor MCP.

Registrando o servidor

Antes de iniciar o servidor, o tempo de execução precisa saber em qual pasta do Orchestrator registrá-lo. Dois caminhos de registro são compatíveis, dependendo do método de autenticação:

• Com autenticação interativa (uipath auth): UIPATH_FOLDER_PATH é definido como o caminho da pasta. O runtime resolve isso para uma chave de pasta automaticamente.
• Com autenticação de credenciais do cliente: UIPATH_FOLDER_KEY é definido diretamente para a pasta GUID, pois a API de resolução de pasta não é compatível com credenciais do cliente.

Exemplos de comandos de registro:

# Interactive auth
export UIPATH_FOLDER_PATH=<your-folder-path>
uipath run my-mcp

# Client-credential auth
export UIPATH_FOLDER_KEY=<your-folder-key>
uipath run my-mcp

Depois de registrado, o servidor aparece no Orchestrator e é acessível por meio do URL do ponto de extremidade padrão. Para o formato da URL, consulte Obter a URL do servidor MCP.

Autenticação

A autenticação opera em duas camadas para servidores MCP auto-hospedados:

• O token uipath auth do desenvolvedor (ou credenciais do cliente) registra o runtime.
• O token de portador do chamador autentica cada chamada de ferramenta.

O token do chamador nunca chega ao runtime local. A UiPath o valida na nuvem e encaminha apenas a mensagem de protocolo do MCP.

Para obter detalhes sobre os métodos de autenticação compatíveis e permissões necessárias, consulte Autenticação do servidor MCP.

Configuração

Para obter detalhes de implementação e um guia de introdução, consulte o início rápidouipath-mcp .