Teste de servidores MCP

Teste um servidor UiPath MCP diretamente, fora de qualquer cliente de IA, usando o UiPath MCP Inspetor, o MCP Inspetor de código aberto, cURL ou Postman.

Antes de conectar um servidor MCP a um cliente de IA, teste diretamente a conexão e o comportamento da ferramenta. Testar fora de um cliente de IA permite que você isole se um problema é originado no servidor MCP, sua autenticação ou no cliente de IA.

Teste com o UiPath MCP Inspetor

O UiPath MCP Inspetor é executado dentro do Orchestrator e não requer configuração separada.

Acessar o Inspetor

1. Na página Servidores MCP, selecione um servidor MCP.

2. Selecione o ícone Inspetor.

   

Chame uma ferramenta

1. Selecione uma ferramenta da lista.

2. Insira os parâmetros de entrada da ferramenta.

3. Selecione Invocar para inspecionar o resultado.

   

Testes com o MCP Inspetor (CLI)

O Inspetor MCP é uma ferramenta de código aberto que se conecta a qualquer servidor MCP por meio de HTTP Streamable.

Pré-requisitos

• O Node.js é instalado para executar o comando npx.
• A URL do Servidor MCP, disponível na página Servidores MCP no Orchestrator.
• Um token de portador. Para a opção mais simples, use um token de acesso pessoal (PAT). Para outros tipos de token compatíveis, consulte Autenticação do servidor MCP.

1. A partir de um terminal, execute o seguinte comando. É o mesmo no macOS, Linux e Windows (PowerShell 7 ou Git Bash):

   npx @modelcontextprotocol/inspector@0.22.0
   

   O comando abre a interface gráfica da Web do Inspetor no seu navegador.

2. Insira a URL do Servidor MCP.

3. Selecione HTTP Streamable como o tipo de transporte.

4. Na seção Autenticação , insira o token no formato Bearer <token>.

5. Select Connect.

   

Resultado

Depois de conectado, você pode:

• Liste ferramentas para verificar se todas as suas ferramentas aparecem com esquemas JSON corretos.
• Chame ferramentas para executar ferramentas com entradas de teste e inspecionar respostas.
• Assista à sessão para ver o ciclo de vida de initialize → initialized → request em tempo real.
• Valide esquemas para detectar incompatibilidades de tipos antes que elas atinjam um LLM.

Teste com cURL

Use cURL para enviar solicitações JSON-RPC brutas e inspecionar o ciclo completo de solicitação/resposta, incluindo cabeçalhos.

Pré-requisitos

• Um token de portador. Verifique a autenticação do Servidor MCP para ver métodos compatíveis.
• A URL do Servidor MCP, disponível na página Servidores MCP no Orchestrator.

1. Defina o token e a URL do servidor como variáveis de ambiente:

   TOKEN="your-bearer-token"
   SERVER_URL="https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folder}/{slug}"
   

2. Inicialize a sessão do MCP:

   curl -v -X POST "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event-stream" \
     -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "initialize",
       "params": {
         "protocolVersion": "2025-06-18",
         "capabilities": {},
         "clientInfo": {"name": "curl-test", "version": "1.0"}
       }
     }'
   

   Use o sinalizador -v para ver os cabeçalhos de resposta e salve o valor do cabeçalho mcp-session-id. Cada solicitação subsequente precisa dele.

   Observação:

   Os servidores UiPath MCP são compatíveis com a versão do protocolo 2025-06-18. O envio de 2025-11-25 (a versão de especificação do MCP mais recente) pode funcionar, já que o servidor responde com a versão compatível, mas use 2025-06-18 para evitar um comportamento não compatível.

3. Envie a notificação inicializada:

   curl -X POST "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -H "mcp-session-id: $SESSION_ID" \
     -d '{"jsonrpc": "2.0", "method": "notifications/initialized"}'
   

   O servidor responde com 202 Accepted e sem corpo. O servidor exige essa notificação antes de processar solicitações de ferramentas.

4. Liste as ferramentas disponíveis:

   curl -X POST "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "mcp-session-id: $SESSION_ID" \
     -H "Content-Type: application/json" \
     -d '{
       "jsonrpc": "2.0",
       "id": 2,
       "method": "tools/list"
     }'
   

5. Chame uma ferramenta:

   curl -X POST "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "mcp-session-id: $SESSION_ID" \
     -H "Content-Type: application/json" \
     -d '{
       "jsonrpc": "2.0",
       "id": 3,
       "method": "tools/call",
       "params": {
         "name": "add",
         "arguments": {"a": 5, "b": 3}
       }
     }'
   

6. Fechar a sessão:

   curl -X DELETE "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "mcp-session-id: $SESSION_ID"
   

Teste com Postman

O Postman é compatível com solicitações MCP nativamente.

1. Crie uma solicitação de MCP em sua coleção.
2. Selecione HTTP como o transporte, para HTTP Streamable.
3. Insira a URL do Servidor MCP.
4. Na aba Autorização , configure a autenticação do Token de Portador com seu token.
5. Select Connect.

O Postman lida com o ciclo de vida da sessão, incluindo initialize e notifications/initialized, automaticamente.

Dica:

Para enviar solicitações JSON-RPC brutas manualmente, por exemplo, para controlar cada solicitação e resposta individualmente, use o Postman como um cliente REST simples e siga o mesmo fluxo de solicitação que Teste com cURL.