Zum Inhalt springen

MCP-Client-Verbindung in Jitterbit Studio

Einführung

Eine MCP-Client-Verbindung, die mit dem MCP-Client-Connector erstellt wird, 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 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 (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu verarbeiten) verwendet werden.

Tipp

Um eine Verbindung zu einem Server herzustellen, den Sie in Jitterbit MCP erstellt haben, siehe Mit dem MCP-Client-Connector zu einem Jitterbit-MCP-Server verbinden.

Hinweis

Um 3-legged OAuth 2.0 (3LO) authentication mit dem MCP-Client-Connector zu verwenden, werden zusätzliche Voraussetzungen benötigt. 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 Konfigurationsbildschirms der MCP-Client-Verbindung beschrieben.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Geben Sie entweder eine öffnende eckige Klammer [ in das Feld ein oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen.

  • 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 Endpunkt-Pfad (z. B. /mcp) enthalten. Beispiel: https://api.example.com/mcp.

  • Authentifizierungsmechanismus: Wählen Sie den Authentifizierungsmechanismus aus, entweder Access Token oder No Auth.

    • No Auth: 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 aus, die in der Management Console auf der Seite App Registrations konfiguriert ist. Weitere Informationen zur Konfiguration einer MCP-Client-Connector-Anwendung auf der Seite App Registrations finden Sie unter MCP Client 3-legged OAuth 2.0 (3LO) prerequisites.

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

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

      • Bearer Token: Geben Sie ein Bearer Token für die Authentifizierung beim MCP-Server ein. Der MCP-Server-Administrator oder Dienstanbieter gibt diesen Token aus.

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

    • Protokollversion: Wählen Sie die zu verwendende MCP-Protokollversion. Sie können zwischen 2024-11-05, 2025-03-26, 2025-06-18 (Standard) oder 2026-07-28 wählen. Die Standardversion ist 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 wird. Der Standard ist 30000 Millisekunden (30 Sekunden). Erhöhen Sie diesen Wert für langsame Netzwerke oder lange laufende Server-Operationen.

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

      Um die Zeile zu speichern, klicken Sie auf das Bestätigungssymbol in der äußersten rechten Spalte.

      Um eine einzelne Request-Header-Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die äußerste rechte Spalte und verwenden Sie das Bearbeitungssymbol oder das Löschsymbol.

      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 aktiviert werden, um Private Agent Proxy-Einstellungen zu nutzen.

  • Test: Klicken Sie hier, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Beim Testen der Verbindung:

    • Der Agent bzw. die Agents in der dem aktuellen Environment zugeordneten Agent-Gruppe laden die neueste Version des Connectors herunter. Dieser Connector unterstützt das Aussetzen des Herunterladens der neuesten Connector-Version durch die Verwendung der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.
    • Es wird eine MCP Initialize-Anfrage ausgeführt, um die Konnektivität zu überprüfen. Ausnahme: Die Protokollversion 2026-07-28 verwendet keinen Initialize-Handshake. Ob der MCP-Server Anmeldedaten während der Initialisierung validiert, hängt von der Server-Implementierung ab. Einige MCP-Server validieren Anmeldedaten erst, wenn eine List Tools- oder Invoke Tools-Operation ausgeführt wird, nicht beim Verbindungstest.
    • Der Connector ruft automatisch jede Session-ID ab, die der MCP-Server beim Testen der Verbindung in den Response-Headern zurückgibt, speichert sie und bezieht sie 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 Session-ID nicht manuell als benutzerdefinierten Request-Header konfigurieren. Dies gilt nicht für die Protokollversion 2026-07-28, die keine Session-ID verwendet.
    • Falls 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, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Nach Änderungen an einer neuen oder vorhandenen Konfiguration klicken, um die Konfiguration ohne Speichern zu schließen. Eine Meldung fordert zur Bestätigung auf, dass die Änderungen verworfen werden sollen.

  • Löschen: Nach dem Öffnen einer vorhandenen Verbindungskonfiguration klicken, 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 zur Bestätigung auf, dass die Verbindung gelöscht werden soll.

Nächste Schritte

Nach dem Erstellen einer MCP-Client-Verbindung 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 verbrauchen) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Designkomponentenpalette verfügbar. Details 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 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 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 als Quelle in einem Vorgang vorgesehen.

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

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

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