Saltar al contenido

Conexión del Cliente MCP

Introducción

Una conexión del Cliente MCP, creada utilizando el conector del Cliente MCP, establece acceso a un servidor del Protocolo de Contexto de Modelo (MCP). Este conector es un cliente MCP que se conecta a un servidor MCP externo para utilizar sus herramientas y capacidades. Una vez que se configura una conexión, se pueden crear instancias de actividades del Cliente MCP asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Nota

Para utilizar la autenticación OAuth 2.0 de 3 patas (3LO) con el conector del Cliente MCP, se requieren prerrequisitos adicionales. Se requiere la versión 10.83 / 11.21 o posterior del agente para utilizar 3LO.

Crear o editar una conexión del Cliente MCP

Se crea una nueva conexión del Cliente MCP utilizando el conector del Cliente MCP desde una de estas ubicaciones:

Una conexión existente del Cliente MCP se puede editar desde estas ubicaciones:

Configurar una conexión de cliente MCP

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión del cliente MCP se describe a continuación.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú que enumera las variables existentes de las que elegir.

  • Nombre de la conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión de cliente MCP y no debe contener barras diagonales (/) ni dos puntos (:). Este nombre también se utiliza para identificar el punto final del cliente MCP, que se refiere tanto a una conexión específica como a sus actividades.

  • URL del servidor MCP: Ingrese el endpoint HTTP completo del servidor MCP. La URL debe incluir el protocolo (http:// o https://) y la ruta del endpoint específico (como /mcp). Por ejemplo, https://api.example.com/mcp.

  • Mecanismo de autenticación: Seleccione el mecanismo de autenticación, ya sea Token de acceso o Sin autenticación.

    • Sin autenticación: Seleccione esta opción si no se requiere autenticación para el servidor MCP.

    • Código de autorización: Seleccione esta opción para autenticarse en el servidor MCP utilizando autenticación 3LO.

      • Aplicación OAuth: Seleccione una aplicación de conector de cliente MCP configurada en la página de Registros de aplicaciones de la Consola de administración. Para obtener más información sobre cómo configurar una aplicación de conector de cliente MCP en la página de Registros de aplicaciones, consulte los requisitos previos de OAuth 2.0 (3LO) para el cliente MCP.

      • Iniciar sesión con OAuth: Haga clic para autenticarse utilizando OAuth en una pestaña del navegador separada y proporcione consentimiento para que Jitterbit acceda a la aplicación compatible con MCP.

  • Token de acceso: Seleccione esta opción para autenticarse en el servidor MCP utilizando un token de acceso.

    • Token Bearer: Ingrese un token bearer para la autenticación en el servidor MCP. Este token es emitido por el administrador del servidor MCP o el proveedor de servicios.

  • Configuraciones opcionales: Haga clic para expandir configuraciones opcionales adicionales:

    • Versión del protocolo: Seleccione la versión del protocolo MCP a utilizar. Puede elegir entre 2025-06-18 (predeterminado), 2025-03-26 o 2024-11-05. Se recomienda la versión predeterminada a menos que el servidor MCP requiera una versión específica.

    • Tiempo de espera (en milisegundos): Ingrese el tiempo máximo en milisegundos para esperar la respuesta del servidor MCP. El valor predeterminado es 30000 milisegundos (30 segundos). Aumente este valor para redes lentas o operaciones de servidor de larga duración.

    • Encabezados de solicitud personalizados (Enviados con cada solicitud al servidor MCP): Ingrese cualquier encabezado adicional que se deba incluir con todas las solicitudes enviadas al servidor MCP. Puede usar este campo para pasar cualquier encabezado específico del servidor. Para agregar una fila de encabezado de solicitud, haga clic en el ícono de agregar e ingrese una Clave de encabezado y Valor de encabezado.

      Para guardar la fila, haga clic en el ícono de enviar en la columna más a la derecha.

      Para editar o eliminar una sola fila de encabezado de solicitud, pase el cursor sobre la columna más a la derecha y use el ícono de editar o el ícono de eliminar.

      Para eliminar todas las filas de encabezados de solicitud, haga clic en Limpiar todo.

      Importante

      Los campos en la tabla muestran el ícono de variable solo en modo de edición. Para que los valores de variable de estos campos se completen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

    • Usar configuraciones de proxy (Solo agente privado): Al utilizar un agente privado, se puede seleccionar esta configuración para usar configuraciones de proxy de agente privado.

  • Prueba: Haz clic para verificar la conexión utilizando la configuración especificada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la Política de Desactivar Actualización Automática del Conector política de organización.

    Nota

    El conector recupera y almacena automáticamente cualquier ID de sesión que el servidor MCP devuelva en los encabezados de respuesta cuando pruebas la conexión, y luego lo incluye en todas las solicitudes subsiguientes al servidor MCP, incluidas las solicitudes de las actividades Lista de Herramientas y Invocar Herramientas. No es necesario configurar manualmente el ID de sesión como un encabezado de solicitud personalizado.

  • Guardar Cambios: Haz clic para guardar y cerrar la configuración de la conexión.

  • Descartar Cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (ver Dependencias de componentes, eliminación y remoción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Próximos pasos

Después de que se ha creado una conexión de Cliente MCP, colocas un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulta Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

  • List Tools: Recupera las herramientas disponibles de un servidor MCP y está destinado a ser utilizado como una fuente en una operación. Utiliza los datos devueltos para configurar la Invoke Tools activity.

  • Invoke Tools: Ejecuta una herramienta específica en un servidor MCP y está destinado a ser utilizado como un objetivo en una operación. Utiliza primero la List Tools activity para ver las herramientas disponibles y sus campos requeridos.