Esta página se ha traducido con Cloud Translation API.

Crear y configurar un conector de MCP

En esta página se describe cómo crear y configurar un conector de MCP en Integration Connectors. Para obtener más información sobre el conector de MCP, consulta la información general del conector de MCP.

Antes de empezar

Antes de usar el conector de MCP, completa las siguientes tareas:

En tu proyecto Google Cloud :
- Asegúrate de que la conectividad de red esté configurada. Para obtener información sobre los patrones de red, consulta Conectividad de red.
- Concede el rol de gestión de identidades y accesos roles/connectors.admin al usuario que configure el conector.
- Concede los siguientes roles de gestión de identidades y accesos a la cuenta de servicio que quieras usar para el conector:
  - roles/secretmanager.viewer
  - roles/secretmanager.secretAccessor
  Una cuenta de servicio es un tipo especial de cuenta de Google diseñada para representar a un usuario no humano que necesita autenticarse y disponer de autorización para acceder a los datos de las APIs de Google. Si no tienes una cuenta de servicio, debes crear una. El conector y la cuenta de servicio deben pertenecer al mismo proyecto. Para obtener más información, consulta el artículo Crear una cuenta de servicio.
- Habilita los siguientes servicios:
  - secretmanager.googleapis.com (API Secret Manager)
  - connectors.googleapis.com (API Connectors)
  Para saber cómo habilitar servicios, consulta Habilitar servicios. Si estos servicios o permisos no se han habilitado en tu proyecto anteriormente, se te pedirá que los habilites al configurar el conector.

Configurar el conector

Una conexión es específica de una fuente de datos. Esto significa que, si tiene muchas fuentes de datos, debe crear una conexión independiente para cada una de ellas. Para crear una conexión, sigue estos pasos:

En la Google Cloud consola, vaya a la página Conectores de integración > Conexiones.
Ir a Conexiones
Selecciona o crea un proyecto para usarlo con el conector.
Haz clic en Crear conexión.
Aparecerá la página Crear conexión.
En la sección Ubicación:
1. Haz clic en Región y, a continuación, selecciona una ubicación para la conexión.
  Para ver la lista de todas las regiones admitidas, consulta Ubicaciones.
2. Haz clic en Siguiente.
En la sección Detalles de la conexión, proporciona la siguiente información:
1. Conector: selecciona MCP (vista previa).
2. Versión del conector: selecciona la versión del conector que quieras usar.
3. Nombre de la conexión: introduce un nombre para la conexión.
  Importante: El nombre de la conexión debe ser único en la región seleccionada. El nombre de la conexión debe cumplir las siguientes reglas:
  - El nombre debe contener letras en minúscula, números o guiones.
  - El nombre debe empezar por una letra y terminar en una letra o un número.
  - El nombre no debe superar los 49 caracteres.
4. Descripción: (opcional) escribe una descripción de la conexión.
5. También puedes habilitar Registro en la nube y, a continuación, seleccionar un nivel de registro. De forma predeterminada, el nivel de registro es Error.
6. Cuenta de servicio: selecciona la cuenta de servicio que quieras usar para la conexión. Asegúrate de que la cuenta de servicio tenga los roles y permisos de gestión de identidades y accesos pertinentes.
7. Endpoint de MCP: (opcional) déjelo vacío para usar el endpoint predeterminado: /mcp. Si el endpoint es el mismo que la dirección del host, defina este valor como /. Solo se aplica al servidor HTTP de Streamable.
8. Ajustes del nodo de conexión: (opcional) configura los ajustes del nodo de conexión.
  - Número mínimo de nodos: introduce el número mínimo de nodos de conexión.
  - Número máximo de nodos: introduce el número máximo de nodos de conexión.
  Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Cuantos más nodos haya, más transacciones se procesarán en una conexión. Cuantos menos nodos haya, menos transacciones se procesarán. Para saber cómo afectan los nodos a los precios de los conectores, consulta la sección Precios de los nodos de conexión. Si no introduces ningún valor, de forma predeterminada, el número mínimo de nodos es 2 (para mejorar la disponibilidad) y el número máximo de nodos es 50.
  
  Nota: Solo puedes personalizar los valores de los nodos de conexión si eres cliente de pago por uso.
9. Haz clic en Siguiente.
En la sección Destinos, introduce los detalles del host remoto (sistema backend) al que te quieres conectar.
1. Tipo de destino: selecciona el tipo de destino.
  - Para especificar el nombre de host o la dirección IP de destino, selecciona Dirección de host y introduce la dirección en el campo Host 1.
  - Para establecer una conexión privada, selecciona Endpoint attachment (Endpoint adjunto) y elige el adjunto que quieras de la lista Endpoint Attachment (Endpoint adjunto).
    Nota: Para saber cómo crear una vinculación de endpoint, consulta Vinculación de servicio de PSC y Vinculación de endpoint. Una vez que haya creado el adjunto de endpoint, se mostrará en la lista Adjunto de endpoint.
  Si quieres establecer una conexión pública con tus sistemas backend con seguridad adicional, puedes configurar direcciones IP estáticas salientes para tus conexiones y, a continuación, configurar las reglas de tu cortafuegos para que solo se permitan las direcciones IP estáticas específicas.
  
  Ejemplos de direcciones de host que se pueden usar:
  - https://your-service.example.com/sse (sin autenticación)
  - https://your-oauth-provider.example.com/sse (OAuth 2.0: código de autorización)
  - https://your-api-key-service.example.com/sse (autenticación con clave de API)
2. Para introducir más destinos, haga clic en + Añadir destino.
3. Haz clic en Siguiente.
En la sección Authentication (Autenticación), selecciona y configura la autenticación de la conexión:
Sin autenticación

Este tipo se usa en hosts que no tienen requisitos de autenticación específicos.
OAuth 2.0: código de autorización

Este tipo se usa para los hosts que admiten el tipo de concesión de código de autorización de OAuth 2.0.
1. ID de cliente: introduce el ID de cliente que te ha proporcionado tu aplicación externa.
2. Permisos: introduce los permisos necesarios.
3. Secreto de cliente: elige el secreto de Secret Manager que contenga el secreto de cliente.
4. Versión del secreto: selecciona la versión del secreto de Secret Manager para el secreto de cliente.
5. Habilitar PKCE: opcional: habilita PKCE para el flujo de código de autorización. Habilita esta opción solo si el servidor admite PKCE.
6. URL de autorización: introduce la URL de autorización.
7. URL del token de acceso: introduce la URL para obtener el token de acceso.
Para la autenticación Authorization code, después de crear la conexión, debes completar algunos pasos adicionales para finalizar la configuración de la autenticación. Para obtener más información, consulta Pasos adicionales después de crear la conexión.

Nota: Si utilizas la autenticación Authorization code y has hecho algún cambio en la configuración de tu aplicación, debes volver a autorizar la conexión. Para volver a autorizar, consulta la sección Volver a autorizar con el código de autorización.

Pasos adicionales después de crear la conexión

Si has seleccionado OAuth 2.0 - Código de autorización para la autenticación, debes completar los siguientes pasos adicionales después de crear la conexión:
1. En la página Conexiones, busca la conexión que acabas de crear.
2. El estado de la nueva conexión es Se necesita autorización.
3. Haz clic en Se requiere autorización.
  Aparecerá el panel Editar autorización.
4. Copia el valor de URI de redirección en tu aplicación externa.
5. Verifica los detalles de la autorización.
6. Haz clic en Autorizar.
  Si la autorización se realiza correctamente, el estado de la conexión será Activa en la página Conexiones.
Autenticación con clave de API

Este tipo se usa en hosts que requieren una clave de API para la autenticación.
- Clave de API: selecciona el secreto de Secret Manager que contiene la clave de API. Por ejemplo, projects/PROJECT_ID/secrets/your-api-key-secret/versions/1.
- Nombre del parámetro de la clave de API: el nombre del parámetro de la clave de API. Por ejemplo, Authorization.
- Ubicación de la clave de API: la ubicación en la que se envía la clave de API. Por ejemplo, Header.
Haz clic en Siguiente.
En la sección Revisar, comprueba los detalles de la conexión y la autenticación. Para hacer cambios, haz clic en cualquiera de las secciones anteriores.
Haz clic en Crear.
Integration Connectors empieza a crear la conexión con la configuración proporcionada. La creación de la conexión tarda unos minutos en completarse. Una vez que se haya creado la conexión, el sistema te redirigirá a la página Conexiones.

Usar la conexión MCP en una integración

Una vez que hayas creado la conexión, estará disponible en Application Integration. Puedes usar la conexión en una integración mediante la tarea Conectores.

Para saber cómo crear y usar la tarea Conectores en Application Integration, consulta Tarea Conectores.

Crear una integración con el conector MCP

Para crear una integración mediante el conector de MCP, sigue estos pasos:

Añade un activador de API a tu integración:
1. En la Google Cloud consola, ve a la página Integración de aplicaciones.
  Ir a Integración de aplicaciones
2. En el menú de navegación, haz clic en Integraciones. Aparecerá la página Lista de integraciones.
3. Seleccione una integración o haga clic en Crear integración para crear una.
4. Si vas a crear una integración:
  1. Escribe un nombre y una descripción para la integración en el panel Crear integración.
  2. Selecciona una región para la integración.
    En el menú desplegable Regiones solo se muestran las regiones aprovisionadas en tu Google Cloud proyecto. Para aprovisionar una nueva región, haga clic en Habilitar región. Para obtener más información, consulta Habilitar una nueva región.
  3. Opcional. Selecciona una cuenta de servicio para la integración.
    La opción para seleccionar una cuenta de servicio solo se muestra si has habilitado la gobernanza de la integración en la región seleccionada.
  4. Haz clic en Crear. La integración que acabas de crear se abre en el editor de integraciones.
5. En la barra de navegación del editor de integraciones, haz clic en Activadores para ver la lista de activadores disponibles.
6. Haz clic en el elemento Activador de API y colócalo en el diseñador.
Añada Asignación de datos si es necesario.
Ve a Tareas y elige uno de los conectores de la lista anterior o el que hayas creado, si procede.
Haga clic en Configurar conector y elija las acciones. La configuración predeterminada está preseleccionada.
En un menú desplegable se mostrarán varias acciones, que son herramientas en este contexto.
1. Configura los parámetros de entrada necesarios para la acción. Puedes definirlos como entradas de integración, usar variables de tareas anteriores o especificar valores predeterminados directamente.
2. Transfiere los argumentos necesarios y prueba la conexión.

Para ver la lista de entidades y operaciones admitidas, consulta Entidades y operaciones admitidas. Para obtener información sobre las acciones específicas de los conectores que se admiten, consulta Acciones admitidas.

Ejemplo de caso práctico en Application Integration

En los siguientes ejemplos se muestra cómo usar la tarea Conectores de Application Integration para realizar operaciones con la conexión de MCP configurada.

Ejemplo: Jira: crear incidencia

Para crear una incidencia en Jira mediante una conexión MCP, sigue estos pasos:

En el cuadro de diálogo de la tarea Configurar conector, selecciona tu conexión de Jira MCP (por ejemplo, jira-connection).
Haz clic en Acciones.
Selecciona la acción create_issue.
Haz clic en Listo.

En la sección Entrada de la tarea, transmite los siguientes argumentos:

{
  "fields": {
    "project": {
      "key": "YOUR_PROJECT_KEY"
    },
    "summary": "New issue created from Integration Connectors",
    "issuetype": {
      "name": "Task"
    },
    "description": "This is a test issue created via the MCP Jira connector."
  }
}

Crear conexiones con Terraform

Puedes usar el recurso de Terraform para crear una conexión.

Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

Para ver una plantilla de Terraform de ejemplo para crear una conexión, consulta la plantilla de ejemplo.

Cuando crees esta conexión con Terraform, debes definir las siguientes variables en el archivo de configuración de Terraform:

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
proxy_enabled	BOOLEAN	Falso	Se le asigna el valor true para configurar un servidor proxy para la conexión.
proxy_auth_scheme	ENUM	Falso	Tipo de autenticación que se usará para autenticar el proxy ProxyServer. Los valores posibles son: BASIC, DIGEST y NONE.
proxy_user	STRING	Falso	Nombre de usuario que se usará para autenticar el proxy ProxyServer.
proxy_password	SECRET	Falso	Contraseña que se usará para autenticarse en el proxy ProxyServer.
proxy_ssltype	ENUM	Falso	El tipo de SSL que se debe usar al conectarse al proxy ProxyServer. Los valores admitidos son AUTO, ALWAYS, NEVER y TUNNEL.