Zum Inhalt springen

MCP-Client-Verbindung in Jitterbit Studio

Einführung

Eine MCP-Client-Verbindung, die mit dem MCP-Client-Connector erstellt wird, stellt den Zugriff auf einen Model Context Protocol (MCP)-Server her. Dieser Connector ist ein MCP-Client, der sich mit einem externen MCP-Server verbindet, um dessen Tools und Funktionen zu nutzen. Nach der Konfiguration einer Verbindung können Sie Instanzen von MCP-Client-Aktivitäten erstellen, die dieser Verbindung zugeordnet sind und entweder als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder als Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden.

Hinweis

Um die 3-legged OAuth 2.0 (3LO)-Authentifizierung mit dem MCP-Client-Connector zu verwenden, sind zusätzliche Voraussetzungen erforderlich. Agent-Version 10.83 / 11.21 oder später ist erforderlich, um 3LO zu verwenden.

MCP-Client-Verbindung erstellen oder bearbeiten

Eine neue MCP-Client-Verbindung wird mit dem MCP-Client-Connector von einem dieser Orte aus erstellt:

Eine vorhandene MCP-Client-Verbindung kann von diesen Orten aus bearbeitet werden:

MCP-Client-Verbindung konfigurieren

Nachfolgend werden die einzelnen Elemente der Benutzeroberfläche des MCP-Client-Verbindungskonfigurationsbildschirms beschrieben.

Tipp

Felder mit einem -Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das -Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede MCP-Client-Verbindung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den MCP-Client-Endpunkt zu identifizieren, der sich auf eine bestimmte Verbindung und ihre 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 (z. B. /mcp) enthalten. Beispiel: https://api.example.com/mcp.

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

    • Keine Authentifizierung: Wählen Sie diese Option, wenn die Authentifizierung beim MCP-Server nicht 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 aus, 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 Voraussetzungen für 3-legged OAuth 2.0 (3LO) des MCP-Clients.

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

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

      • Bearer-Token: Geben Sie ein Bearer-Token zur Authentifizierung beim MCP-Server ein. Der MCP-Server-Administrator oder Dienstanbieter stellt dieses Token aus.

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

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

    • Timeout (in Millisekunden): Geben Sie die maximale Zeit in Millisekunden ein, die auf eine Antwort des MCP-Servers gewartet werden soll. Der Standard ist 30000 Millisekunden (30 Sekunden). Erhöhen Sie diesen Wert für langsame Netzwerke oder zeitintensive Server-Operationen.

    • Benutzerdefinierte Request-Header (werden mit jeder Anfrage an den MCP-Server gesendet): Geben Sie alle zusätzlichen Header ein, die in alle an den MCP-Server gesendeten Anfragen aufgenommen werden sollen. Sie können dieses Feld verwenden, um serverspezifische Header zu übergeben. Um eine Request-Header-Zeile hinzuzufügen, klicken Sie auf das Hinzufügen-Symbol und geben Sie einen Header-Schlüssel und einen Header-Wert ein.

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

      Um eine einzelne Request-Header-Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die rechte Spalte und verwenden Sie das Bearbeitungs-Symbol oder das Lösch-Symbol.

      Um alle Request-Header-Zeilen zu löschen, klicken Sie auf Alle löschen.

      Wichtig

      Felder in der Tabelle zeigen das Variablensymbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit gefüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.

    • Proxy-Einstellungen verwenden (nur Private Agent): Bei Verwendung eines Private Agent kann diese Einstellung ausgewählt werden, um Private-Agent-Proxy-Einstellungen zu verwenden.

  • Test: Klicken Sie, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Wenn die Verbindung getestet wird:

    • Die neueste Version des Connectors wird von dem/den Agent(s) in der Agentgruppe heruntergeladen, die der aktuellen Umgebung zugeordnet ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Automatische Connector-Aktualisierung deaktivieren Organisationsrichtlinie.
    • Eine MCP-Initialisierungsanfrage wird ausgeführt, um die Konnektivität zu überprüfen, mit Ausnahme der Protokollversion 2026-07-28, die keinen Initialisierungs-Handshake verwendet. Ob der MCP-Server Anmeldedaten während der Initialisierung validiert, hängt von der Server-Implementierung ab. Einige MCP-Server validieren Anmeldedaten nur, wenn eine List Tools- oder Invoke Tools-Operation ausgeführt wird, anstatt während des Verbindungstests.
    • Der Connector ruft automatisch alle Session-IDs ab und speichert sie, die der MCP-Server in den Response-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 aus den List Tools- und Invoke Tools-Aktivitäten. Sie müssen die Session-ID nicht manuell als benutzerdefinierten Request-Header konfigurieren. Dies gilt nicht für die Protokollversion 2026-07-28, die keine Session-ID verwendet.
    • Wenn der MCP-Server die ausgewählte Protokollversion nicht unterstützt, zeigt der Verbindungstest einen Fehler an, der die vom Server unterstützten Protokollversionen auflistet.

  • Speichern: Klicken Sie, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder vorhandenen Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine vorhandene Verbindungskonfiguration 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 Meldung fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

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

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Designkomponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Tools auflisten: Ruft verfügbare Tools von einem MCP-Server ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen. Verwenden Sie die zurückgegebenen Daten, um die Aktivität Tools aufrufen zu konfigurieren.

  • Tools aufrufen: Führt ein bestimmtes Tool auf einem MCP-Server aus und ist für die Verwendung als Ziel in einem Vorgang vorgesehen. Verwenden Sie zunächst die Aktivität Tools auflisten, um verfügbare Tools und ihre erforderlichen Felder anzuzeigen.

  • Ressourcen auflisten: Ruft verfügbare Ressourcen von einem MCP-Server ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

  • Eingabeaufforderungen auflisten: Ruft verfügbare Eingabeaufforderungen von einem MCP-Server ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

  • Eingabeaufforderung abrufen: Ruft bestimmte Eingabeaufforderungen von einem MCP-Server ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

  • Ressource lesen: Ruft bestimmte Ressourcen von einem MCP-Server ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.