Vista previa

Este producto o función está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos y las funciones previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Conector MCP

El conector Model Context Protocol (MCP) te permite crear y configurar una conexión MCP en Integration Connectors. Puede usar esta conexión en sus aplicaciones empresariales para intercambiar datos de forma segura y realizar operaciones con MCP.

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

Todas las conexiones de Integration Connectors proporcionan una capa de abstracción para los objetos de servicio subyacentes. Estos objetos se exponen como entidades gestionables, 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 MCP v1.
• MCP v2: usa esta versión del conector para acceder a la API MCP v2.

Para obtener información sobre cómo crear una conexión MCP, consulta Crear y configurar un conector MCP.

Entidades, operaciones y acciones

Todos los conectores de integración 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 te muestra como entidades, operaciones y acciones.

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

• Entidad: una entidad se puede considerar como un objeto o un conjunto de propiedades de la aplicación o el servicio conectados. La definición de una entidad varía de un conector a otro. Por ejemplo, en un conector de base de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; y en un conector de sistema de mensajería, las colas son las entidades.

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

• Operación: una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
  • Mostrar
  • Obtener
  • Crear
  • Actualizar
  • Eliminar

  Si selecciona una entidad de la lista disponible, se generará una lista de operaciones disponibles para la entidad. Para ver una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea Connectors. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, esas operaciones no admitidas no se mostrarán en la lista Operations.

• Acción: una acción es una función de primera clase que se pone a disposición de la integración a través de la interfaz del conector. Una acción te permite hacer cambios en una o varias entidades y varía de un conector a otro. Normalmente, 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 de los parámetros, como los nombres de los parámetros y su tipo de datos correspondiente. La conexión obtiene el esquema (metadatos) de las entidades y las acciones en tiempo de ejecución de tu backend. Si se realizan cambios en el esquema, estos no se reflejarán automáticamente en las conexiones que ya tengas. Debes actualizar el esquema manualmente. Para actualizar el esquema de una conexión, abre la página Detalles de la conexión y, a continuación, haz clic en Actualizar esquema de conexión.

Entidades y operaciones admitidas

El conector de MCP admite entidades y operaciones, y las 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.

Listar la entidad Jira Issues

En este ejemplo se enumeran todos los problemas de la entidad problemas mediante una conexión MCP de Jira.

1. En la ventana Configurar tarea de conector, haga clic en Entidades.
2. Selecciona Problemas en la lista Entidad.
3. Seleccione la operación Lista y, a continuación, haga clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Valor predeterminado:

   {
         "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": ""
       }

Mostrar todas las solicitudes

En este ejemplo se enumeran todas las solicitudes de la entidad Solicitudes.

1. En la ventana Configurar tarea de conector, haga clic en Entidades.
2. Selecciona Solicitudes en la lista Entidad.
3. Selecciona la operación Lista y, a continuación, haz clic en Hecho.

Obtener un usuario por ID

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

1. En la ventana Configurar tarea de conector, haga clic en Entidades.
2. Selecciona Usuarios en la lista Entidad.
3. Selecciona la operación Lista y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haga clic en filterClause y, a continuación, introduzca `AccountId`=6035864ce2020c0070b5285b en el campo Valor predeterminado.

Acciones

El conector de MCP ofrece varias acciones, y las 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 incidencias

En este ejemplo se muestra cómo enumerar incidencias de Jira mediante una conexión de MCP configurada para Jira.

1. En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
2. Seleccione la acción get_issues y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Valor predeterminado:

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

Acciones lineales: listar problemas

En este ejemplo se muestra cómo enumerar los problemas de Linear mediante una conexión MCP configurada para Linear.

1. En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
2. Selecciona la acción list_issues y, a continuación, haz clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Valor predeterminado:

     {
       "limit": 50
     }

Acciones de Sentry: Whoami

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

1. En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
2. Seleccione la acción whoami y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Valor predeterminado:

     {
       "name": "example-org"
     }

Buscar organizaciones

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

1. En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
2. Selecciona la acción find_organizations y, a continuación, haz clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Valor predeterminado:

     {}

Acciones de Intercom: buscar conversaciones

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

1. En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
2. Seleccione la acción buscar y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Valor predeterminado:

     {
       "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 en función de la herramienta específica que se conecte. De forma predeterminada, Integration Connectors asigna 2 nodos (para mejorar la disponibilidad) a una conexión.

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

Nota: El número de nodos de Integration Connectors se ajustará automáticamente de forma dinámica en función de tu uso. Sin embargo, si quieres reservar capacidad para grandes volúmenes sin esperar al escalado automático, puedes ajustar el valor mínimo de los nodos de una conexión. Se necesitan más nodos para procesar más transacciones de una conexión. Por el contrario, se necesitan 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 tienes una suscripción, ponte en contacto con el equipo de Asistencia.

El número máximo de transacciones que puede gestionar un nodo depende de varios factores. Por lo tanto, antes de ajustar el número mínimo de nodos para mejorar el rendimiento, le recomendamos que compruebe si sus sistemas backend están configurados de forma óptima para gestionar el tráfico necesario.