Preview

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités de pré-DG sont proposés "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Connecteur MCP

Le connecteur MCP (Model Context Protocol) vous permet de créer et de configurer une connexion MCP dans Integration Connectors. Vous pouvez utiliser cette connexion dans vos applications métier pour échanger des données et effectuer des opérations avec MCP de manière sécurisée.

Pour obtenir la liste des entités et des opérations compatibles, consultez Exemples d'opérations sur les entités. Pour en savoir plus sur les actions spécifiques aux connecteurs compatibles, consultez Actions.

Toutes les connexions dans Integration Connectors fournissent une couche d'abstraction pour les objets de service sous-jacents. Ces objets sont exposés en tant qu'entités gérables, ce qui vous permet d'effectuer des opérations standards ou d'utiliser des actions spécifiques aux connecteurs.

Versions du connecteur MCP

Le connecteur MCP est compatible avec deux versions :

• MCP v1 : utilisez cette version du connecteur pour accéder à l'API MCP v1.
• MCP v2 : utilisez cette version du connecteur pour accéder à l'API MCP v2.

Pour savoir comment créer une connexion MCP, consultez Créer et configurer un connecteur MCP.

Entités, opérations et actions

Tous les connecteurs Integration Connectors fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que par le biais de cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

Remarque : Vous pouvez afficher les entités, les opérations et les actions d'un connecteur dans la tâche "Connecteurs".

• Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connectés. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, alors que dans un connecteur de serveur de fichiers, ce sont les dossiers, et dans un connecteur de système de messagerie, ce sont les files d'attente.

  Toutefois, il est possible qu'un connecteur n'accepte ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

• Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Voici les opérations possibles :
  • List
  • Get
  • Create
  • Update
  • Delete

  Lorsque vous sélectionnez une entité dans la liste proposée, cela génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche "Connecteurs". Cependant, si un connecteur n'accepte pas l'une des opérations d'entité, cette opération non compatible ne figure pas dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration par le biais de l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et un paramètre de sortie. Toutefois, il est possible qu'un connecteur n'accepte aucune action, auquel cas la liste Actions est vide.

Remarque : Toutes les entités et les actions seront associées à un schéma. Par exemple, un schéma d'action contient les détails des paramètres tels que les noms des paramètres et le type de données correspondant. Le schéma (métadonnées) des entités et des actions est récupéré par la connexion au moment de l'exécution à partir de votre backend. Si des modifications sont apportées au schéma, elles ne sont pas automatiquement répercutées dans vos connexions existantes. Vous devez actualiser manuellement le schéma. Pour actualiser le schéma d'une connexion, ouvrez la page Détails de la connexion, puis cliquez sur Actualiser le schéma de connexion.

Entités et opérations compatibles

Le connecteur MCP est compatible avec les entités et les opérations. Les entités et les opérations spécifiques disponibles dépendent de l'outil connecté via MCP.

Exemples d'opérations d'entité

Cette section fournit des exemples d'opérations d'entité pour différents outils.

Entité "Lister les problèmes Jira"

Cet exemple liste tous les problèmes de l'entité Issues à l'aide d'une connexion Jira MCP.

1. Dans la fenêtre Configurer la tâche "Connecteurs", cliquez sur Entités.
2. Sélectionnez Problèmes dans la liste Entité.
3. Sélectionnez l'opération List (Lister), puis cliquez sur Done (OK).
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Valeur par défaut :

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

Lister toutes les demandes

Cet exemple liste toutes les demandes dans l'entité Demandes.

1. Dans la fenêtre Configurer la tâche "Connecteurs", cliquez sur Entités.
2. Sélectionnez Requests (Demandes) dans la liste Entity (Entité).
3. Sélectionnez l'opération List (Lister), puis cliquez sur Done (OK).

Obtenir un utilisateur par ID

Cet exemple récupère l'utilisateur dont l'AccountId est défini sur "6035864ce2020c0070b5285b" à partir de l'entité Users. `AccountId` est la clé primaire de l'entité Users. Pour obtenir une entité spécifique, utilisez l'opération List avec un filterClause sur la clé primaire, car l'opération Get n'est pas compatible avec cette entité.

1. Dans la fenêtre Configurer la tâche "Connecteurs", cliquez sur Entités.
2. Sélectionnez Utilisateurs dans la liste Entité.
3. Sélectionnez l'opération List (Lister), puis cliquez sur Done (OK).
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur filterClause, puis saisissez `AccountId`=6035864ce2020c0070b5285b dans le champ Valeur par défaut.

Actions

Le connecteur MCP propose différentes actions. Celles disponibles dépendent de l'outil connecté via MCP.

Exemples d'actions

Cette section explique comment effectuer certaines actions disponibles via le connecteur MCP pour différents outils.

Actions Jira : obtenir des problèmes

Cet exemple montre comment lister les problèmes Jira à l'aide d'une connexion MCP configurée pour Jira.

1. Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
2. Sélectionnez l'action get_issues, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Valeur par défaut :

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

Actions linéaires : lister les problèmes

Cet exemple montre comment lister les problèmes dans Linear à l'aide d'une connexion MCP configurée pour Linear.

1. Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
2. Sélectionnez l'action list_issues, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Valeur par défaut :

     {
       "limit": 50
     }

Actions Sentry : Whoami

Cet exemple montre comment obtenir des informations utilisateur à partir de Sentry à l'aide d'une connexion MCP configurée pour Sentry.

1. Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
2. Sélectionnez l'action whoami, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Valeur par défaut :

     {
       "name": "example-org"
     }

Trouver des organisations

Cet exemple montre comment trouver des organisations dans Sentry à l'aide d'une connexion MCP configurée pour Sentry.

1. Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
2. Sélectionnez l'action find_organizations, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Valeur par défaut :

     {}

Actions Intercom : rechercher des conversations

Cet exemple montre comment rechercher des détails de conversation dans Intercom à l'aide d'une connexion MCP configurée pour Intercom.

1. Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
2. Sélectionnez l'action Rechercher, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Valeur par défaut :

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

Limites du système

Le connecteur MCP présente des limites système qui peuvent varier en fonction de l'outil spécifique connecté. Par défaut, Integration Connectors alloue deux nœuds (pour améliorer la disponibilité) à une connexion.

Pour en savoir plus sur les limites applicables à Integration Connectors, consultez Limites.

Remarque : L'autoscaling du nombre de nœuds Integration Connectors s'effectue de manière dynamique en fonction de votre utilisation. Toutefois, si vous souhaitez réserver de la capacité pour de gros volumes sans attendre l'autoscaling, vous pouvez ajuster le nombre minimal de nœuds pour une connexion. Pour traiter davantage de transactions pour une connexion, vous devez disposer de plus de nœuds. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour configurer les valeurs de nœuds, procédez comme suit :

• Si vous avez opté pour le paiement à l'usage, configurez le nombre minimal et le nombre maximal de nœuds sur la page "Modifier la connexion".
• Si vous avez souscrit un abonnement, contactez l'assistance.

Le nombre maximal de transactions qu'un nœud peut traiter dépend de plusieurs facteurs. Par conséquent, avant que vous ajustiez le nombre minimal de nœuds pour améliorer le débit, nous vous recommandons de vérifier si vos systèmes backend sont configurés de manière optimale pour gérer le trafic requis.