Criando servidores MCP do Swagger

Crie um Servidor MCP Swagger no Orchestrator fornecendo um documento OpenAPI que descreve a API a ser exposta como ferramentas.

Observação:

Essa funcionalidade está em visualização.

Um Servidor MCP Swagger transforma um documento OpenAPI em ferramentas MCP. Você fornece o documento, e cada operação que ele descreve se torna uma ferramenta que o servidor invoca por HTTP.

Pré-requisitos

• A permissão Criar no nível da pasta para servidores MCP.
• O documento do OpenAPI para a API, como um URL ou como um arquivo que você pode colar.

Criar um servidor MCP Swagger

1. Em Agent Gateway > Servidores MCP, selecione o menu Adicionar Servidor MCP .

2. Em Externo, selecione Swagger.

3. Digite um Nome. Este é o nome de exibição mostrado na lista de servidores.

4. Insira um Campo de dados dinâmico.

   Observação:

   O campo de dados dinâmico aceita apenas letras minúsculas, números e hifens e deve ter entre 3 e 50 caracteres. Ele se torna o último segmento do URL do servidor.

5. Se desejar, insira uma Descrição de até 500 caracteres.

6. Escolha como fornecer o documento da OpenAPI: selecione Do URL e insira o URL do Swagger do qual ele é servido ou selecione Colar JSON e cole o próprio documento.

   Observação:

   Do URL é a opção de preferência, pois é a única que é compatível com a atualização das ferramentas posteriormente. Use Colar JSON quando o documento não for servido em um endereço que o UiPath possa alcançar. Alternar entre as duas opções apaga o que você inseriu na outra.

7. Selecione o Tipo de Conexão: Padrão para conectar-se diretamente pela internet pública ou Privada (Relay) para rotear o tráfego por meio do UiPath Relay para uma API dentro de sua própria rede.

8. Adicione os Cabeçalhos que a API espera, um por linha, no formulário Name:value.

   Observação:

   O valor resolvido é enviado para a API como o cabeçalho configurado; portanto, use cabeçalhos baseados em ativos apenas para pontos de extremidade em que você confia com esses segredos.

   Em vez de colar um segredo, atribua a um cabeçalho um valor do formulário %ASSETS/AssetName%. A UiPath a resolve em relação ao ativo na pasta do servidor antes de enviar a solicitação, e a chamada falha em vez de encaminhar um espaço reservado não resolvido se o ativo não puder ser lido. O preenchimento automático lista apenas ativos que permitem o acesso de automações e API.

9. Opcionalmente, expanda Proteções e configure-as.

10. Selecione Adicionar.

Resultado: a UiPath lê o documento, buscando-o se você tiver fornecido uma URL, e cria uma ferramenta por operação que ela descreve. Se o documento não puder ser lido, o servidor não será criado e o erro nomeia o motivo. Selecione Copiar URL na linha do servidor para obter seu endereço:

https://cloud.uipath.com/{org_name}/{tenant_name}/agenthub_/mcp/{folder_key}/{server_slug}

Os ativos Text, Secret, Bool, Integer, Credential e Windows Credential são compatíveis com cabeçalhos suportados por ativos; Os ativos Credential e Windows Credential são resolvidos no valor da senha. Os ativos de lista de valores-chave não são compatíveis, pois um valor de cabeçalho deve ser resolvido em uma string.

Para obter alterações na API posteriormente, selecione Atualizar no servidor. Ela rele o documento a partir do seu URL e recria a lista de ferramentas; os clientes conectados veem a nova lista na próxima vez que solicitarem uma. Um servidor criado a partir de um documento colado não tem URL para reler, portanto, mantê-lo atual significa editar o documento colado.

Observação:

Em uma conexão padrão , a solicitação que a UiPath faz para a API tem um tempo limite de 30 segundos e um limite de resposta de 1 MiB, e a chamada da ferramenta é mantida aberta até que retorne. Operações de longa duração e operações que retornam grandes cargas não são adequadas para esse tipo de servidor.

As chamadas aparecem na guia Execuções no servidor.

Para saber como os chamadores autenticam e quais permissões eles precisam, consulte Autenticação do servidor MCP. Para saber o que esse tipo de servidor é e como ele se compara aos outros, verifique Tipos de servidor MCP.