Zum Inhalt springen

MCP-Clientverbindung

Einführung

Eine MCP-Clientverbindung, die mit dem MCP-Client-Connector erstellt wurde, ermöglicht den Zugriff auf einen Model Context Protocol (MCP)-Server. Dieser Connector ist ein MCP-Client, der sich mit einem externen MCP-Server verbindet, um dessen Werkzeuge und Funktionen zu nutzen. Sobald eine Verbindung konfiguriert ist, können Instanzen von MCP-Client-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Hinweis

Um 3-beinige OAuth 2.0 (3LO)-Authentifizierung mit dem MCP-Client-Connector zu verwenden, sind zusätzliche Voraussetzungen erforderlich. Die Agentenversion 10.83 / 11.21 oder höher ist erforderlich, um 3LO zu verwenden.

Erstellen oder Bearbeiten einer MCP-Clientverbindung

Eine neue MCP-Clientverbindung wird mit dem MCP-Client-Connector von einem dieser Standorte erstellt:

Eine vorhandene MCP-Clientverbindung kann von diesen Standorten bearbeitet werden:

Konfigurieren einer MCP-Clientverbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die MCP-Clientverbindung wird im Folgenden beschrieben.

Tipp

Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede MCP-Clientverbindung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den MCP-Client-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

  • MCP-Server-URL: Geben Sie den vollständigen HTTP-Endpunkt des MCP-Servers ein. Die URL muss das Protokoll (http:// oder https://) und den spezifischen Endpunktpfad (wie /mcp) enthalten. Zum Beispiel https://api.example.com/mcp.

  • Authentifizierungsmechanismus: Wählen Sie den Authentifizierungsmechanismus, entweder Zugriffstoken oder Keine Authentifizierung.

    • Keine Authentifizierung: Wählen Sie diese Option, wenn keine Authentifizierung beim MCP-Server erforderlich ist.

    • Authorization Code Grant: Wählen Sie diese Option, um sich beim MCP-Server mit 3LO-Authentifizierung zu authentifizieren.

      • OAuth-Anwendung: Wählen Sie eine MCP-Client-Connector-Anwendung, die in der Management Console auf der Seite App-Registrierungen konfiguriert ist. Weitere Informationen zur Konfiguration einer MCP-Client-Connector-Anwendung auf der Seite App-Registrierungen finden Sie in den MCP-Client Voraussetzungen für 3-beinige OAuth 2.0 (3LO).

      • Mit OAuth anmelden: Klicken Sie, um sich in einem separaten Browser-Tab mit OAuth zu authentifizieren und Jitterbit die Zustimmung zu erteilen, auf die von MCP unterstützte Anwendung zuzugreifen.

  • Zugriffstoken: Wählen Sie diese Option, um sich mit einem Zugriffstoken beim MCP-Server zu authentifizieren.

    • Bearer-Token: Geben Sie ein Bearer-Token zur Authentifizierung beim MCP-Server ein. Dieses Token wird vom Administrator des MCP-Servers oder vom Dienstanbieter ausgegeben.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Protokollversion: Wählen Sie die zu verwendende MCP-Protokollversion aus. Sie können aus 2025-06-18 (Standard), 2025-03-26 oder 2024-11-05 wählen. Die Standardversion wird empfohlen, es sei denn, der MCP-Server erfordert eine spezifische Version.

    • Zeitüberschreitung (in Millisekunden): Geben Sie die maximale Zeit in Millisekunden an, die gewartet werden soll, bis der MCP-Server antwortet. Der Standardwert beträgt 30000 Millisekunden (30 Sekunden). Erhöhen Sie diesen Wert für langsame Netzwerke oder lang laufende Serveroperationen.

    • Benutzerdefinierte Anforderungsheader (Mit jeder Anfrage an den MCP-Server gesendet): Geben Sie zusätzliche Header an, die mit allen an den MCP-Server gesendeten Anfragen enthalten sein sollen. Sie können dieses Feld verwenden, um server-spezifische Header zu übergeben. Um eine Zeile für einen Anforderungsheader hinzuzufügen, klicken Sie auf das Hinzufügen-Symbol und geben Sie einen Header-Schlüssel und Header-Wert ein.

      Um die Zeile zu speichern, klicken Sie auf das Bestätigen-Symbol in der rechten Spalte.

      Um eine einzelne Zeile für einen Anforderungsheader zu bearbeiten oder zu löschen, fahren Sie mit der Maus über die rechte Spalte und verwenden Sie das Bearbeiten-Symbol oder das Löschen-Symbol.

      Um alle Zeilen für Anforderungsheader zu löschen, klicken Sie auf Alle löschen.

      Wichtig

      Die Felder in der Tabelle zeigen das Variablen-Symbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 betragen.

    • Proxy-Einstellungen verwenden (Nur privater Agent): Bei Verwendung eines privaten Agents kann diese Einstellung ausgewählt werden, um die Proxy-Einstellungen des privaten Agents zu verwenden.

  • Test: Klicken Sie, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Deaktivieren Sie die automatische Connector-Aktualisierung Organisationsrichtlinie.

    Hinweis

    Der Connector ruft automatisch jede Sitzungs-ID ab und speichert sie, die der MCP-Server in den Antwort-Headern zurückgibt, wenn Sie die Verbindung testen, und fügt sie dann in alle nachfolgenden Anfragen an den MCP-Server ein, einschließlich Anfragen von den List Tools und Invoke Tools Aktivitäten. Sie müssen die Sitzungs-ID nicht manuell als benutzerdefinierten Anfrage-Header konfigurieren.

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine MCP-Client-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie in den Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • List Tools: Ruft verfügbare Tools von einem MCP-Server ab und ist als Quelle in einem Vorgang gedacht. Verwenden Sie die zurückgegebenen Daten, um die Invoke Tools activity zu konfigurieren.

  • Invoke Tools: Führt ein bestimmtes Tool auf einem MCP-Server aus und ist als Ziel in einem Vorgang gedacht. Verwenden Sie zuerst die List Tools activity, um verfügbare Tools und deren erforderliche Felder anzuzeigen.