Prueba de servidores MCP

Prueba un servidor MCP de UiPath directamente, fuera de cualquier cliente de IA, utilizando el Inspector de MCP de UiPath, el Inspector de MCP de código abierto, cURL o Postman.

Antes de conectar un servidor MCP a un cliente de IA, prueba el comportamiento de la conexión y la herramienta directamente. Realizar pruebas fuera de un cliente IA te permite aislar si una incidencia se origina en el servidor MCP, su autenticación o el cliente IA.

Pruebas con el UiPath MCP Inspector

El UiPath MCP Inspector se ejecuta dentro de Orchestrator y no requiere configuración independiente.

Acceder al Inspector

1. En la página Servidores MCP, selecciona un servidor MCP.

2. Selecciona el icono del Inspector.

   

Llamar a una herramienta

1. Selecciona una herramienta de la lista.

2. Introduce los parámetros de entrada de la herramienta.

3. Selecciona Invocar para inspeccionar el resultado.

   

Pruebas con el MCP Inspector (CLI)

El Inspector de MCP es una herramienta de código abierto que se conecta a cualquier servidor MCP a través de HTTP transmisible.

Requisitos previos

• Node.js se instala para ejecutar el comando npx.
• La URL del servidor MCP, disponible en la página Servidores MCP en Orchestrator.
• Un token al portador. Para la opción más sencilla, utiliza un token de acceso personal (PAT). Para otros tipos de tokens compatibles, consulta Autenticación del servidor MCP.

1. Desde un terminal, ejecuta el siguiente comando. Es lo mismo en macOS, Linux y Windows (PowerShell 7 o Git Bash):

   npx @modelcontextprotocol/inspector@0.22.0
   

   El comando abre la IU web de Inspector en tu navegador.

2. Introduce la URL del servidor MCP.

3. Selecciona HTTP transmisible como tipo de transporte.

4. En la sección Autenticación , introduce el token en el formato Bearer <token>

5. Select Connect.

   

Resultado

Una vez conectado, puedes:

• Enumerar herramientas para verificar que todas tus herramientas aparecen con esquemas JSON correctos.
• Llamar a herramientas para ejecutar herramientas con entradas de prueba e inspeccionar respuestas.
• Mira la sesión para ver el ciclo de vida initialize → initialized → request en tiempo real.
• Valida los esquemas para detectar las discrepancias de tipos antes de que lleguen a un LLM.

Pruebas con cURL

Utiliza cURL para enviar solicitudes JSON-RPC sin procesar e inspeccionar el ciclo completo de solicitud/respuesta, incluidos los encabezados.

Requisitos previos

• Un token al portador. Consulta la autenticación del servidor MCP para conocer los métodos compatibles.
• La URL del servidor MCP, disponible en la página Servidores MCP en Orchestrator.

1. Establece el token y la URL del servidor como variables de entorno:

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

2. Inicializa la sesión de 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"}
       }
     }'
   

   Utiliza el marcador -v para ver los encabezados de respuesta y guarda el valor del encabezado mcp-session-id. Cada solicitud posterior lo necesita.

   Nota:

   Los servidores MCP de UiPath admiten la versión 2025-06-18 del protocolo. El envío de 2025-11-25 (la última versión de la especificación de MCP) puede funcionar, ya que el servidor responde con la versión que admite, pero utiliza 2025-06-18 para evitar un comportamiento no compatible.

3. Envía la notificación 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"}'
   

   El servidor responde con 202 Accepted y sin cuerpo. El servidor requiere esta notificación antes de procesar solicitudes de herramientas.

4. Enumera las herramientas disponibles:

   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. Llamar a una herramienta:

   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. Cerrar la sesión:

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

Pruebas con Postman

Postman admite solicitudes de MCP de forma nativa.

1. Crea una solicitud de MCP en tu colección.
2. Selecciona HTTP como transporte, para HTTP Streamable.
3. Introduce la URL del servidor MCP.
4. En la pestaña Autorización , configura la autenticación de token portador con tu token.
5. Select Connect.

Postman gestiona el ciclo de vida de la sesión, incluidos initialize y notifications/initialized, automáticamente.

Consejo:

Para enviar solicitudes JSON-RPC sin procesar manualmente en su lugar, por ejemplo, para controlar cada solicitud y respuesta individualmente, utiliza Postman como un cliente REST simple y sigue el mismo flujo de solicitudes que Pruebas con cURL.