Vorschau

Dieses Produkt oder diese Funktion unterliegt den Bedingungen für Pre-GA-Angebote im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und ‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

MCP-Connector

Mit dem MCP-Connector (Model Context Protocol) können Sie eine MCP-Verbindung in Integration Connectors erstellen und konfigurieren. Sie können diese Verbindung in Ihren Geschäftsanwendungen verwenden, um Daten sicher mit MCP auszutauschen und Vorgänge auszuführen.

Eine Liste der unterstützten Entitäten und Vorgänge finden Sie unter Beispiele für Entitätsvorgänge. Informationen zu den unterstützten connectorspezifischen Aktionen finden Sie unter Aktionen.

Alle Verbindungen in Integration Connectors bieten eine Abstraktionsebene für die zugrunde liegenden Dienstobjekte. Diese Objekte werden als verwaltbare Entitäten verfügbar gemacht, sodass Sie Standard-Vorgänge ausführen oder connectorspezifische Aktionen verwenden können.

MCP-Connector-Versionen

Der MCP-Connector unterstützt zwei Versionen:

• MCP v1: Mit dieser Connector-Version können Sie auf die MCP v1 API zugreifen.
• MCP v2: Mit dieser Connector-Version können Sie auf die MCP v2 API zugreifen.

Informationen zum Erstellen einer MCP-Verbindung finden Sie unter MCP-Connector erstellen und konfigurieren.

Entitäten, Vorgänge und Aktionen

Alle Integration Connectors bieten eine Abstraktionsebene für die Objekte der verbundenen Anwendung. Sie können nur über diese Abstraktion auf die Objekte einer Anwendung zugreifen. Die Abstraktion wird Ihnen als Entitäten, Vorgänge und Aktionen zur Verfügung gestellt.

Hinweis: Sie können die Entitäten, Vorgänge und Aktionen eines Connectors in der Connectors-Aufgabe aufrufen.

• Entität: Eine Entität kann als Objekt oder Sammlung von Attributen in der verbundenen Anwendung oder im verbundenen Dienst verstanden werden. Die Definition einer Entität unterscheidet sich von Connector zu Connector. Beispiel: In einem Datenbank-Connector sind Tabellen die Entitäten, in einem Dateiserver-Connector sind Ordner die Entitäten und in einem Nachrichtensystem-Connector sind Warteschlangen die Entitäten.

  Es ist jedoch möglich, dass ein Connector keine Entitäten unterstützt oder keine Entitäten enthält. In diesem Fall ist die Liste Entities leer.

• Vorgang: Ein Vorgang ist die Aktivität, die Sie für eine Entität ausführen können. Sie können einen der folgenden Vorgänge für eine Entität ausführen:
  • Liste
  • Abrufen
  • Erstellen
  • Aktualisieren
  • Löschen

  Durch Auswahl einer Entität aus der verfügbaren Liste wird eine Liste der Vorgänge generiert, die für die Entität verfügbar sind. Eine detaillierte Beschreibung der Vorgänge finden Sie in den Entitätsvorgängen der Connectors-Aufgabe. Wenn ein Connector jedoch keine der Entitätsvorgänge unterstützt, werden diese nicht unterstützten Vorgänge nicht in der Operations-Liste aufgeführt.

• Aktion: Eine Aktion ist eine Funktion erster Klasse, die über die Connector-Benutzeroberfläche für die Integration verfügbar gemacht wird. Mit einer Aktion können Sie Änderungen an einer oder mehreren Entitäten vornehmen, die von Connector zu Connector unterschiedlich sind. Normalerweise hat eine Aktion einige Eingabeparameter und einen Ausgabeparameter. Es ist jedoch möglich, dass ein Connector keine Aktionen unterstützt. In diesem Fall ist die Actions-Liste leer.

Hinweis : Allen Entitäten und Aktionen ist ein Schema zugeordnet. Ein Aktionsschema enthält beispielsweise die Parameterdetails wie die Parameternamen und den entsprechenden Datentyp. Das Schema (Metadaten) für Entitäten und Aktionen wird von der Verbindung zur Laufzeit aus Ihrem Backend abgerufen. Wenn es Änderungen am Schema gibt, werden diese nicht automatisch in Ihren bestehenden Verbindungen berücksichtigt. Sie müssen das Schema manuell aktualisieren. Wenn Sie das Schema für eine Verbindung aktualisieren möchten, öffnen Sie die Seite Verbindungsdetails der Verbindung und klicken Sie dann auf Verbindungsschema aktualisieren.

Unterstützte Entitäten und Vorgänge

Der MCP-Connector unterstützt Entitäten und Vorgänge. Welche genau verfügbar sind, hängt vom Tool ab, das über MCP verbunden ist.

Beispiele für Entitätsvorgänge

In diesem Abschnitt finden Sie Beispiele für Entitätsvorgänge für verschiedene Tools.

„Jira-Vorgänge auflisten“-Entität

In diesem Beispiel werden alle Probleme in der Probleme-Entität über eine Jira MCP-Verbindung aufgeführt.

1. Klicken Sie im Fenster Connector-Aufgabe konfigurieren auf Entitäten.
2. Wählen Sie in der Liste Entität die Option Probleme aus.
3. Wählen Sie den Vorgang List (Auflisten) aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Standardwert ein:

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

Alle Anfragen auflisten

In diesem Beispiel werden alle Requests in der Requests-Entität aufgelistet.

1. Klicken Sie im Fenster Connector-Aufgabe konfigurieren auf Entitäten.
2. Wählen Sie in der Liste Entity (Rechtssubjekt) die Option Requests (Anfragen) aus.
3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.

Nutzer nach ID abrufen

In diesem Beispiel wird der Nutzer mit der AccountId `6035864ce2020c0070b5285b` aus der Users-Entität abgerufen. `AccountId` ist der Primärschlüssel für die Users-Entität. Wenn Sie eine bestimmte Entität abrufen möchten, verwenden Sie den Vorgang List mit einem filterClause für den Primärschlüssel, da der Vorgang Get für diese Entität nicht unterstützt wird.

1. Klicken Sie im Fenster Connector-Aufgabe konfigurieren auf Entitäten.
2. Wählen Sie in der Liste Entität die Option Nutzer aus.
3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf filterClause und geben Sie dann `AccountId`=6035864ce2020c0070b5285b in das Feld Standardwert ein.

Aktionen

Der MCP-Connector bietet verschiedene Aktionen. Welche verfügbar sind, hängt vom Tool ab, das über MCP verbunden ist.

Beispiele für Aktionen

In diesem Abschnitt wird beschrieben, wie Sie einige der Aktionen ausführen, die über den MCP-Connector für verschiedene Tools verfügbar sind.

Jira-Aktionen: Tickets abrufen

In diesem Beispiel wird gezeigt, wie Sie Jira-Vorgänge mit einer für Jira konfigurierten MCP-Verbindung auflisten.

1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
2. Wählen Sie die Aktion get_issues aus und klicken Sie dann auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Standardwert ein:

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

Lineare Aktionen: Probleme auflisten

In diesem Beispiel wird gezeigt, wie Sie Probleme in Linear auflisten, wenn eine MCP-Verbindung für Linear konfiguriert ist.

1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
2. Wählen Sie die Aktion list_issues aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Standardwert ein:

     {
       "limit": 50
     }

Sentry-Aktionen: Whoami

In diesem Beispiel wird gezeigt, wie Sie Nutzerinformationen von Sentry abrufen. Dazu wird eine MCP-Verbindung verwendet, die für Sentry konfiguriert ist.

1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
2. Wählen Sie die Aktion whoami aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Standardwert ein:

     {
       "name": "example-org"
     }

Organisationen finden

In diesem Beispiel wird gezeigt, wie Sie Organisationen in Sentry über eine für Sentry konfigurierte MCP-Verbindung finden.

1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
2. Wählen Sie die Aktion find_organizations aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Standardwert ein:

     {}

Intercom-Aktionen: Unterhaltungen durchsuchen

In diesem Beispiel wird gezeigt, wie Sie mit einer für Intercom konfigurierten MCP-Verbindung in Intercom nach Konversationsdetails suchen.

1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
2. Wählen Sie die Aktion Suchen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Standardwert ein:

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

Systembeschränkungen

Der MCP-Connector unterliegt Systembeschränkungen, die je nach verbundenem Tool variieren können. Standardmäßig werden für eine Verbindung zwei Knoten (für eine bessere Verfügbarkeit) zugewiesen.

Informationen zu den für Integration Connectors geltenden Limits finden Sie unter Limits.

Hinweis:Die Anzahl der Integration Connectors-Knoten wird dynamisch auf Grundlage Ihrer Nutzung automatisch skaliert. Wenn Sie jedoch Kapazität für große Mengen reservieren möchten, ohne auf das Autoscaling zu warten, können Sie den Mindestknotenwert für eine Verbindung anpassen. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, wenn eine Verbindung weniger Transaktionen verarbeitet. So konfigurieren Sie die Knotenwerte:

• Wenn Sie ein „Pay as you go“-Kunde sind, konfigurieren Sie den Mindest- und Höchstwert für Knoten auf der Seite „Verbindung bearbeiten“.
• Wenn Sie ein Abo haben, wenden Sie sich an den Support.

Die maximale Anzahl von Transaktionen, die ein Knoten verarbeiten kann, hängt von verschiedenen Faktoren ab. Bevor Sie also die Mindestanzahl von Knoten für einen besseren Durchsatz anpassen, sollten Sie prüfen, ob Ihre Backend-Systeme optimal für die Verarbeitung des erforderlichen Traffics eingerichtet sind.