MCP-Connector erstellen und konfigurieren

Auf dieser Seite wird beschrieben, wie Sie einen MCP-Connector in Integration Connectors erstellen und konfigurieren. Weitere Informationen zum MCP-Connector finden Sie in der Übersicht zum MCP-Connector.

Hinweis

Führen Sie vor der Verwendung des MCP-Connectors die folgenden Aufgaben aus:

  • In Ihrem Google Cloud Projekt:
    • Prüfen Sie, ob eine Netzwerkverbindung eingerichtet ist. Informationen zu Netzwerkmustern finden Sie unter Netzwerkverbindung.
    • Weisen Sie dem Nutzer der den Connector konfiguriert, die IAM-Rolle „roles/connectors.admin“ zu.
    • Weisen Sie dem Dienstkonto, das Sie für den Connector verwenden möchten, die folgenden IAM-Rollen zu:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Ein Dienstkonto ist eine spezielle Art von Google-Konto, das einen nicht menschlichen Nutzer repräsentiert. Es muss authentifiziert und autorisiert werden, um Zugriff auf Daten in Google APIs zu erhalten. Wenn Sie kein Dienstkonto haben, müssen Sie eins erstellen. Der Connector und das Dienstkonto müssen zum selben Projekt gehören. Weitere Informationen finden Sie unter Dienstkonto erstellen.

    • Aktivieren Sie die folgenden Dienste:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (Connectors API)

      Informationen zum Aktivieren von Diensten finden Sie unter Dienste aktivieren. Wenn diese Dienste oder Berechtigungen für Ihr Projekt zuvor nicht aktiviert wurden, werden Sie aufgefordert, sie beim Konfigurieren des Connectors zu aktivieren.

Connector konfigurieren

Eine Verbindung gilt für eine Datenquelle. Wenn Sie also viele Datenquellen haben, müssen Sie für jede Datenquelle eine separate Verbindung erstellen. So erstellen Sie eine Verbindung:

  1. Rufen Sie in der Google Cloud Console die Seite Integration Connectors > Verbindungen auf.

    Zu „Verbindungen“

  2. Wählen Sie ein Projekt für den Connector aus oder erstellen Sie ein Projekt.
  3. Klicken Sie auf Verbindung erstellen.

    Die Seite Verbindung erstellen wird angezeigt.

  4. Im Abschnitt Standort :
    1. Klicken Sie auf Region und wählen Sie dann einen Standort für die Verbindung aus.

      Eine Liste aller unterstützten Regionen finden Sie unter Standorte.

    2. Klicken Sie auf Weiter.
  5. Geben Sie im Abschnitt Verbindungsdetails die folgenden Details an:
    1. Connector: Wählen Sie MCP (Vorschau) aus.
    2. Connector-Version: Wählen Sie die Version des Connectors aus, die Sie verwenden möchten.
    3. Verbindungsname: Geben Sie einen Namen für die Verbindung ein.
    4. Beschreibung: Geben Sie optional eine Beschreibung für die Verbindung ein.
    5. Optional können Sie Cloud Logging aktivieren, und dann eine Logebene auswählen. Die Logebene ist standardmäßig auf Error gesetzt.
    6. Dienstkonto: Wählen Sie das Dienstkonto aus, das für die Verbindung verwendet werden soll. Achten Sie darauf, dass das Dienstkonto die entsprechenden IAM-Rollen und ‑Berechtigungen hat.
    7. MCP-Endpunkt: Optional. Lassen Sie das Feld leer, um den Standardendpunkt /mcp zu verwenden. Wenn der Endpunkt mit der Hostadresse identisch ist, setzen Sie ihn auf /. Gilt nur für den streamfähigen HTTP-Server.
    8. Einstellungen für Verbindungsknoten: Konfigurieren Sie optional die Einstellungen für Verbindungsknoten.
      • Mindestanzahl von Knoten: Geben Sie die Mindestanzahl von Verbindungsknoten ein.
      • Maximale Anzahl von Knoten: Geben Sie die maximale Anzahl von Verbindungsknoten ein.

      Ein Knoten ist eine Einheit (oder ein Replikat) einer Verbindung, die Transaktionen verarbeitet. Mehr Knoten verarbeiten mehr Transaktionen für eine Verbindung und weniger Knoten verarbeiten weniger Transaktionen. Informationen zu den Auswirkungen von Knoten auf die Connector-Preise finden Sie unter Preise für Verbindungsknoten. Wenn Sie keine Werte eingeben, ist die Mindestanzahl von Knoten standardmäßig auf 2 (für eine bessere Verfügbarkeit) und die maximale Anzahl von Knoten auf 50 gesetzt.

    9. Klicken Sie auf Weiter.
  6. Geben Sie im Abschnitt Ziele die Details zum Remote-Host (Backend-System) ein, zu dem Sie eine Verbindung herstellen möchten.
    1. Zieltyp: Wählen Sie den Zieltyp aus.
      • Wenn Sie den Zielhostnamen oder die Ziel-IP-Adresse angeben möchten, wählen Sie Hostadresse aus und geben Sie die Adresse in das Feld Host 1 ein.
      • Wählen Sie Endpunktanhang aus, um eine private Verbindung herzustellen. Wählen Sie in der Liste Endpunktanhang den Endpunktanhang aus, der für Ihr Backend-System erstellt wurde.

      Wenn Sie eine öffentliche Verbindung zu Ihren Backend-Systemen mit zusätzlicher Sicherheit herstellen möchten, können Sie statische ausgehende IP-Adressen für Ihre Verbindungen konfigurieren und dann Ihre Firewallregeln konfigurieren, um nur bestimmte statische IP-Adressen zuzulassen.

      Beispiele für zu verwendende Hostadressen:

      • https://your-service.example.com/sse (keine Authentifizierung)
      • https://your-oauth-provider.example.com/sse (OAuth 2.0 – Autorisierungscode)
      • https://your-api-key-service.example.com/sse (Authentifizierung über API-Schlüssel)
    2. Wenn Sie weitere Ziele eingeben möchten, klicken Sie auf + Ziel hinzufügen.
    3. Klicken Sie auf Weiter.
  7. Wählen Sie im Abschnitt Authentifizierung die Authentifizierung für die Verbindung aus und konfigurieren Sie sie:

    Keine Authentifizierung

    Dieser Typ wird für Hosts ohne spezifische Authentifizierungsanforderungen verwendet.

    OAuth 2.0 – Autorisierungscode

    Dieser Typ wird für Hosts verwendet, die den OAuth 2.0-Grant-Typ „Autorisierungscode“ unterstützen.

    1. Client-ID : Geben Sie die Client-ID ein, die von Ihrer externen Anwendung bereitgestellt wird.
    2. Bereiche : Geben Sie die erforderlichen Berechtigungsbereiche ein.
    3. Clientschlüssel : Wählen Sie das Secret Manager-Secret mit dem Clientschlüssel aus.
    4. Secret-Version : Wählen Sie die Secret Manager-Secret-Version für den Clientschlüssel aus.
    5. PKCE aktivieren: Optional. Aktivieren Sie PKCE für den Autorisierungscode-Vorgang. Aktivieren Sie diese Option nur, wenn der Server PKCE unterstützt.
    6. Autorisierungs-URL: Geben Sie die URL für die Autorisierung ein.
    7. Zugriffstoken-URL: Geben Sie die URL ein, um das Zugriffstoken abzurufen.

    Für die Authorization code Authentifizierung müssen Sie nach dem Erstellen der Verbindung einige zusätzliche Schritte ausführen, um die Authentifizierungskonfiguration abzuschließen. Weitere Informationen finden Sie unter Zusätzliche Schritte nach dem Erstellen der Verbindung.

    Zusätzliche Schritte nach dem Erstellen der Verbindung

    Wenn Sie für die Authentifizierung „OAuth 2.0 – Autorisierungscode“ ausgewählt haben, müssen Sie nach dem Erstellen der Verbindung die folgenden zusätzlichen Schritte ausführen:

    1. Suchen Sie auf der Seite Verbindungen die neu erstellte Verbindung.
    2. Der Status der neuen Verbindung ist Autorisierung erforderlich.
    3. Klicken Sie auf Autorisierung erforderlich.

      Der Bereich Autorisierung bearbeiten wird angezeigt.

    4. Kopieren Sie den Wert Weiterleitungs-URI in Ihre externe Anwendung.
    5. Überprüfen Sie die Autorisierungsdetails.
    6. Klicken Sie auf Autorisieren.

      Wenn die Autorisierung erfolgreich ist, wird der Verbindungsstatus auf der Seite „Verbindungen“ auf Aktiv gesetzt.

    Authentifizierung über API-Schlüssel

    Dieser Typ wird für Hosts verwendet, die einen API-Schlüssel für die Authentifizierung erfordern.

    • API-Schlüssel: Wählen Sie das Secret Manager-Secret mit dem API-Schlüssel aus. Beispiel: projects/PROJECT_ID/secrets/your-api-key-secret/versions/1.
    • Name des API-Schlüsselparameters : Der Name des Parameters für den API-Schlüssel. Beispiel: Authorization.
    • Speicherort des API-Schlüssels : Der Speicherort, an den der API-Schlüssel gesendet wird. Beispiel: Header.
  8. Klicken Sie auf Weiter.
  9. Prüfen Sie im Abschnitt Überprüfen die Verbindungs- und Authentifizierungsdetails. Wenn Sie Änderungen vornehmen möchten, klicken Sie auf einen der vorherigen Abschnitte.
  10. Klicken Sie auf Erstellen.

    Integration Connectors beginnt mit der Erstellung der Verbindung mit der angegebenen Konfiguration. Die Erstellung der Verbindung dauert einige Minuten. Nachdem die Verbindung erstellt wurde, werden Sie zur Seite Verbindungen weitergeleitet.

MCP-Verbindung in einer Integration verwenden

Nachdem Sie die Verbindung erstellt haben, ist sie in Application Integration verfügbar. Sie können die Verbindung in einer Integration über die Aufgabe „Connectors“ verwenden.

  • Informationen zum Erstellen und Verwenden der Aufgabe „Connectors“ in Application Integration finden Sie unter Aufgabe „Connectors“.

Integration mit dem MCP-Connector erstellen

So erstellen Sie eine Integration mit dem MCP-Connector:

  1. Fügen Sie Ihrer Integration einen API-Trigger hinzu:
    1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

      Zu Application Integration

    2. Klicken Sie im Navigationsmenü auf Integrationen. Die Seite Liste der Integrationen wird angezeigt.
    3. Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration erstellen , um eine neue zu erstellen.
    4. Wenn Sie eine neue Integration erstellen:
      1. Geben Sie im Bereich Integration erstellen einen Namen und eine Beschreibung für die Integration ein.
      2. Wählen Sie eine Region für die Integration aus.
      3. Optional. Wählen Sie ein Dienstkonto für die Integration aus.
      4. Klicken Sie auf Erstellen. Die neu erstellte Integration wird im Integrationseditor geöffnet.
    5. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
    6. Klicken Sie auf das Element API-Trigger und platzieren Sie es im Designer.
  2. Fügen Sie bei Bedarf Datenabgleich hinzu.
  3. Rufen Sie Aufgaben auf und wählen Sie einen der oben aufgeführten Connectors oder den von Ihnen erstellten Connector aus, falls zutreffend.
  4. Klicken Sie auf Connector konfigurieren und wählen Sie Aktionen aus. Die Standardeinstellungen sind vorab ausgewählt.

    In einem Drop-down-Menü werden verschiedene Aktionen angezeigt, die in diesem Kontext Tools sind.

    Screenshot mit den verfügbaren Aktionen in der MCP-Connector-Konfiguration.

    1. Konfigurieren Sie die erforderlichen Eingabeparameter für die Aktion. Sie können diese als Integrationseingaben festlegen, Variablen aus vorherigen Aufgaben verwenden oder direkt Standardwerte angeben.
    2. Übergeben Sie die erforderlichen Argumente und testen Sie die Verbindung.

      Screenshot mit der Aufgabeneingabe in der MCP-Connector-Konfiguration.

Eine Liste der unterstützten Entitäten und Vorgänge finden Sie unter Unterstützte Entitäten und Vorgänge. Informationen zu den unterstützten connectorspezifischen Aktionen finden Sie unter Unterstützte Aktionen.

Anwendungsfallbeispiel in Application Integration

Die folgenden Beispiele zeigen, wie Sie die Aufgabe „Connectors“ in Application Integration verwenden, um Vorgänge mit Ihrer konfigurierten MCP-Verbindung auszuführen.

Beispiel – Jira: Vorgang erstellen

So erstellen Sie einen Vorgang in Jira mit einer MCP-Verbindung:

  1. Wählen Sie im Dialogfeld Connector konfigurieren Ihre Jira-MCP-Verbindung aus (z.B. jira-connection).
  2. Klicken Sie auf Aktionen.
  3. Wählen Sie die Aktion create_issue aus.
  4. Klicken Sie auf Fertig.
  5. Übergeben Sie im Abschnitt Aufgabeneingabe die folgenden Argumente: 
    {
  "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."
  }
}

Verbindungen mit Terraform erstellen

Sie können die Terraform Ressource verwenden, um eine neue Verbindung zu erstellen.

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

Eine Beispielvorlage für Terraform zum Erstellen einer Verbindung finden Sie unter Beispielvorlage.

Wenn Sie diese Verbindung mit Terraform erstellen, müssen Sie die folgenden Variablen in Ihrer Terraform-Konfigurationsdatei festlegen:

Parameter name Datentyp Erforderlich Beschreibung
proxy_enabled BOOLEAN Falsch Setzen Sie diese Option auf „true“, um einen Proxyserver für die Verbindung zu konfigurieren.
proxy_auth_scheme ENUM Falsch Der Authentifizierungstyp, der für die Authentifizierung beim Proxy „ProxyServer“ verwendet werden soll. Unterstützte Werte: BASIC, DIGEST, NONE
proxy_user STRING Falsch Ein Nutzername, der für die Authentifizierung beim Proxy „ProxyServer“ verwendet werden soll.
proxy_password SECRET Falsch Ein Passwort, das für die Authentifizierung beim Proxy „ProxyServer“ verwendet werden soll.
proxy_ssltype ENUM Falsch Der SSL-Typ, der beim Herstellen einer Verbindung zum Proxy „ProxyServer“ verwendet werden soll. Unterstützte Werte: AUTO, ALWAYS, NEVER, TUNNEL