Saltar al contenido

Conexión de cliente MCP en Jitterbit Studio

Introducción

Una conexión de cliente MCP, creada mediante el conector de 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 de cliente MCP asociadas a esa conexión para usarlas como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Nota

Para usar autenticación OAuth 2.0 de 3 etapas (3LO) con el conector de cliente MCP, se requieren requisitos previos adicionales. Se requiere la versión del agente 10.83 / 11.21 o posterior para usar 3LO.

Crear o editar una conexión de cliente MCP

Se crea una nueva conexión de cliente MCP mediante el conector de cliente MCP desde una de estas ubicaciones:

Se puede editar una conexión de cliente MCP existente desde estas ubicaciones:

Configurar una conexión de cliente MCP

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de cliente MCP.

Consejo

Los campos con un icono de variable permiten usar variables globales, variables de proyecto y variables de Jitterbit. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar un menú con las variables existentes entre las que elegir.

  • Nombre de conexión: Ingresa 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 extremo de cliente MCP, que se refiere tanto a una conexión específica como a sus actividades.

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

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

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

    • Concesión de código de autorización: Selecciona esta opción para autenticarte en el servidor MCP mediante autenticación 3LO.

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

  • Iniciar sesión con OAuth: Haz clic para autenticarte usando OAuth en una pestaña del navegador separada y proporciona consentimiento para que Jitterbit acceda a la aplicación compatible con MCP.

    • Token de acceso: Selecciona esta opción para autenticarte en el servidor MCP usando un token de acceso.

      • Token portador: Ingresa un token portador para la autenticación en el servidor MCP. El administrador del servidor MCP o el proveedor de servicios emite este token.

  • Configuración opcional: Haz clic para expandir la configuración opcional adicional:

    • Versión del protocolo: Selecciona la versión del protocolo MCP que deseas usar. Puedes elegir entre 2024-11-05, 2025-03-26, 2025-06-18 (predeterminada) o 2026-07-28. Se recomienda usar la versión predeterminada a menos que el servidor MCP requiera una versión específica.

    • Tiempo de espera (en milisegundos): Ingresa el tiempo máximo en milisegundos para esperar a que el servidor MCP responda. El valor predeterminado es 30000 milisegundos (30 segundos). Aumenta este valor para redes lentas u operaciones de servidor de larga duración.

    • Encabezados de solicitud personalizados (Se envían con cada solicitud al servidor MCP): Ingresa cualquier encabezado adicional para incluir con todas las solicitudes enviadas al servidor MCP. Puedes usar este campo para pasar cualquier encabezado específico del servidor. Para agregar una fila de encabezado de solicitud, haz clic en el icono agregar e ingresa una Clave de encabezado y un Valor de encabezado.

      Para guardar la fila, haz clic en el icono enviar en la columna más a la derecha.

      Para editar o eliminar una sola fila de encabezado de solicitud, colócate sobre la columna más a la derecha y usa el icono editar o el icono eliminar.

      Para eliminar todas las filas de encabezado de solicitud, haz clic en Borrar todo.

      Importante

      Los campos de la tabla muestran el icono 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 configuración de proxy (Solo agente privado): Al usar un agente privado, se puede seleccionar esta configuración para usar la configuración de proxy del agente privado.

  • Prueba: Haz clic para verificar la conexión usando la configuración especificada. Cuando se prueba la conexión:

    • El agente o los agentes del grupo de agentes asociado al entorno actual descargan la versión más reciente del conector. Este conector admite suspender la descarga de la versión más reciente del conector usando la política organizacional Deshabilitar actualización automática del conector.
    • Se ejecuta una solicitud de inicialización de MCP para verificar la conectividad, excepto para la versión del protocolo 2026-07-28, que no utiliza un protocolo de enlace de inicialización. Si el servidor MCP valida las credenciales durante la inicialización depende de la implementación del servidor. Algunos servidores MCP validan las credenciales solo cuando se realiza una operación Listar herramientas o Invocar herramientas, en lugar de durante la prueba de conexión.
    • El conector recupera y almacena automáticamente cualquier ID de sesión que el servidor MCP devuelve en los encabezados de respuesta cuando pruebas la conexión, luego lo incluye en todas las solicitudes posteriores al servidor MCP, incluidas las solicitudes de las actividades Listar herramientas e Invocar herramientas. No es necesario que configures manualmente el ID de sesión como un encabezado de solicitud personalizado. Esto no se aplica a la versión del protocolo 2026-07-28, que no utiliza un ID de sesión.
    • Si el servidor MCP no admite la versión del protocolo seleccionada, la prueba de conexión muestra un error que enumera las versiones del protocolo que el servidor admite.

  • Guardar: Haz clic para guardar y cerrar la configuración de 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 (consulta Dependencias de componentes, eliminación y extracción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Próximos pasos

Después de crear una conexión de cliente MCP, colocas un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilicen como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Se puede acceder a las acciones de menú de una conexión y sus tipos de actividad desde el panel del proyecto y la paleta de componentes de diseño. Para obtener más detalles, consulta Menús de acciones en Conceptos básicos de conectores.

Estos tipos de actividad están disponibles:

  • Listar herramientas: Recupera las herramientas disponibles de un servidor MCP y está diseñada para usarse como origen en una operación. Utiliza los datos devueltos para configurar la actividad Invocar herramientas.

  • Invocar herramientas: Ejecuta una herramienta específica en un servidor MCP y está diseñada para usarse como destino en una operación. Utiliza primero la actividad Listar herramientas para ver las herramientas disponibles y sus campos requeridos.

  • Listar recursos: Recupera los recursos disponibles de un servidor MCP y está diseñada para usarse como origen en una operación.

  • Listar indicaciones: Recupera las indicaciones disponibles de un servidor MCP y está diseñada para usarse como origen en una operación.

  • Obtener indicación: Recupera indicaciones específicas de un servidor MCP y está diseñada para usarse como origen en una operación.

  • Leer recurso: Recupera recursos específicos de un servidor MCP y está diseñada para usarse como origen en una operación.