Versión preliminar

Este producto o función está sujeto a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección de Términos Generales del Servicio de los Términos Específicos del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles sin modificaciones y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Conector de MCP

El conector del Protocolo de contexto del modelo (MCP) te permite crear y configurar una conexión de MCP en Integration Connectors. Puedes usar esta conexión en tus aplicaciones comerciales para intercambiar datos y realizar operaciones con el MCP de forma segura.

Para obtener la lista de entidades y operaciones admitidas, consulta Ejemplos de operaciones de entidades. Para obtener información sobre las acciones específicas del conector admitidas, consulta Acciones.

Todas las conexiones en Integration Connectors proporcionan una capa de abstracción para los objetos de servicio subyacentes. Estos objetos se exponen como entidades administrables, lo que te permite realizar operaciones estándar o usar acciones específicas del conector.

Versiones del conector de MCP

El conector de MCP admite dos versiones:

• MCP v1: Usa esta versión del conector para acceder a la API de MCP v1.
• MCP v2: Usa esta versión del conector para acceder a la API de MCP v2.

Para obtener información sobre cómo crear una conexión de MCP, consulta Crea y configura un conector de MCP.

Entidades, operaciones y acciones

Todos los Integration Connectors proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se expone como entidades, operaciones y acciones.

Nota: Puedes ver las entidades, operaciones y acciones de un conector en la tarea de conectores.

• Entidades: Una entidad puede considerarse como un objeto o una colección de propiedades en la aplicación o servicio conectados. La definición de una entidad difiere de conector a conector. Por ejemplo, en un conector de bases de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; en un conector de sistema de mensajería, las colas son las entidades.

  Sin embargo, es posible que un conector no admita o tenga ninguna entidad, en cuyo caso la lista Entities estará vacía.

• Operaciones: Una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
  • Lista
  • Obtener
  • Crear
  • Actualizar
  • Borrar

  Cuando se selecciona una entidad de la lista disponible, se genera una lista de operaciones disponibles para esa entidad. Para obtener una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea de conectores. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, esas operaciones no admitidas no se incluirán en la lista Operations.

• Acción: Una acción es una función de primera clase que está disponible para la integración mediante la interfaz de Conectores. Una acción te permite realizar cambios en una entidad o entidades y variar de un conector a otro. Por lo general, una acción tendrá algunos parámetros de entrada y un parámetro de salida. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Nota: Todas las entidades y acciones tendrán un esquema asociado. Por ejemplo, un esquema de acción tendrá los detalles del parámetro, como los nombres de los parámetros y su tipo de datos correspondiente. El esquema (metadatos) de las entidades y las acciones se recupera de tu backend en el tiempo de ejecución de la conexión. Si hay actualizaciones en el esquema, estas no se reflejarán automáticamente en tus conexiones existentes. Deberás actualizar el esquema de forma manual. Para actualizar el esquema de una conexión, abre la página Detalles de la conexión y, luego, haz clic en Actualizar el esquema de conexión.

Operaciones y entidades compatibles

El conector de MCP admite entidades y operaciones, y las específicas disponibles dependen de la herramienta conectada a través de MCP.

Ejemplos de operaciones de entidades

En esta sección, se proporcionan ejemplos de operaciones de entidades para diferentes herramientas.

Entidad List Jira Issues

En este ejemplo, se enumeran todos los problemas en la entidad Issues con una conexión de MCP de Jira.

1. En la ventana Configurar tarea de conector, haz clic en Entidades.
2. Selecciona Issues en la lista Entity.
3. Selecciona la operación List y, luego, haz clic en Listo.
4. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   {
         "operation": "LIST_ENTITIES",
         "connection_name": "projects/YOUR_PROJECT_ID/locations/YOUR_LOCATION/connections/YOUR_JIRA_CONNECTION_NAME",
         "service_name": "projects/YOUR_TENANT_PROJECT_ID/locations/YOUR_LOCATION/namespaces/cloudrun/services/YOUR_RUNTIME_SERVICE",
         "host": "https://YOUR_TENANT_PROJECT_ID-YOUR_LOCATION.us-west1-runtime-connectors-google.com",
         "entity": "Issues",
         "entity_id": "Issues",
         "page_token": ""
       }

Enumera todas las solicitudes

En este ejemplo, se enumeran todas las solicitudes en la entidad solicitudes.

1. En la ventana Configurar tarea de conector, haz clic en Entidades.
2. Selecciona Requests en la lista Entity.
3. Selecciona la operación List y, luego, haz clic en Listo.

Obtén un usuario por su ID

En este ejemplo, se obtiene el usuario con AccountId como "6035864ce2020c0070b5285b" de la entidad Users. `AccountId` es la clave primaria de la entidad Users. Para obtener una entidad específica, usa la operación List con un filterClause en la clave primaria, ya que la operación Get no es compatible con esta entidad.

1. En la ventana Configurar tarea de conector, haz clic en Entidades.
2. En la lista Entidad, selecciona Usuarios.
3. Selecciona la operación List y, luego, haz clic en Listo.
4. En la sección Task Input de la tarea Connectors, haz clic en filterClause y, luego, ingresa `AccountId`=6035864ce2020c0070b5285b en el campo Valor predeterminado.

Acciones

El conector de MCP proporciona varias acciones, y las específicas disponibles dependen de la herramienta conectada a través de MCP.

Ejemplos de acciones

En esta sección, se describe cómo realizar algunas de las acciones disponibles a través del conector de MCP para diferentes herramientas.

Acciones de Jira: Obtener problemas

En este ejemplo, se muestra cómo enumerar los problemas de Jira con una conexión de MCP configurada para Jira.

1. En el cuadro de diálogo Configurar tarea de conector, haz clic en Acciones.
2. Selecciona la acción get_issues y, luego, haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

     {
       "issue_ids": ["YOUR_ISSUE_ID_1", "YOUR_ISSUE_ID_2"]
     }

Acciones lineales: Enumera problemas

En este ejemplo, se muestra cómo enumerar problemas en Linear con una conexión de MCP configurada para Linear.

1. En el cuadro de diálogo Configurar tarea de conector, haz clic en Acciones.
2. Selecciona la acción list_issues y, luego, haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

     {
       "limit": 50
     }

Sentry Actions: Whoami

En este ejemplo, se muestra cómo obtener información del usuario de Sentry con una conexión de MCP configurada para Sentry.

1. En el cuadro de diálogo Configurar tarea de conector, haz clic en Acciones.
2. Selecciona la acción whoami y, luego, haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

     {
       "name": "example-org"
     }

Cómo encontrar organizaciones

En este ejemplo, se muestra cómo encontrar organizaciones en Sentry con una conexión de MCP configurada para Sentry.

1. En el cuadro de diálogo Configurar tarea de conector, haz clic en Acciones.
2. Selecciona la acción find_organizations y, luego, haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

     {}

Acciones de Intercom: Buscar conversaciones

En este ejemplo, se muestra cómo buscar detalles de conversaciones en Intercom con una conexión de MCP configurada para Intercom.

1. En el cuadro de diálogo Configurar tarea de conector, haz clic en Acciones.
2. Selecciona la acción search y, luego, haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

     {
       "query": "object_type:conversations state:open created_at:gt:2024-01-01"
     }

Limitaciones del sistema

El conector de MCP tiene limitaciones del sistema que pueden variar según la herramienta específica que se conecte. De forma predeterminada, Integration Connectors asigna 2 nodos (para una mejor disponibilidad) a una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Nota: La cantidad de nodos de Integration Connectors se ajustará automáticamente según tu uso. Sin embargo, si deseas reservar capacidad para grandes volúmenes sin esperar el ajuste de escala automático, puedes ajustar el valor mínimo de nodos para una conexión. Se requieren más nodos para procesar más transacciones para una conexión. Por el contrario, se requieren menos nodos si una conexión procesa menos transacciones. Para configurar los valores del nodo, haz lo siguiente:

• Si eres cliente de pago por uso, configura el valor mínimo y máximo del nodo en la página de edición de la conexión.
• Si eres cliente de un servicio basado en suscripciones, comunícate con el equipo de asistencia.

La cantidad máxima de transacciones que puede controlar un nodo depende de varios factores. Por lo tanto, antes de ajustar la cantidad mínima de nodos para mejorar el rendimiento, te recomendamos que verifiques si tus sistemas de backend están configurados de manera óptima para controlar el tráfico requerido.