Zum Inhalt springen

MCP-Client-Verbindung

Einführung

Eine MCP-Client-Verbindung, 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 Agent-Version 10.83 / 11.21 oder höher ist erforderlich, um 3LO zu verwenden.

Erstellen oder Bearbeiten einer MCP-Client-Verbindung

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

Eine vorhandene MCP-Client-Verbindung 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 spezifische 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 aus, die auf der Seite App-Registrierungen im Management Console konfiguriert ist. Weitere Informationen zur Konfiguration einer MCP-Client-Connector-Anwendung auf der Seite App-Registrierungen finden Sie in den MCP-Client 3-beinigen OAuth 2.0 (3LO) Voraussetzungen.

      • 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

      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 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 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.
    • Eine MCP-Initialisierungsanfrage wird ausgeführt, um die Konnektivität zu überprüfen. Ob der MCP-Server während der Initialisierung die Anmeldeinformationen validiert, hängt von der Serverimplementierung ab. Zum Beispiel validiert Postman die Anmeldeinformationen nur während der List Tools oder Invoke Tools Operationen.
    • 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.

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

  • Discard Changes: 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.

  • Delete: 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-Clientverbindung hergestellt 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 Palette der Entwurfskomponenten zugänglich. Für Details siehe 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 vorgesehen. Verwenden Sie die zurückgegebenen Daten, um die Invoke Tools-Aktivität zu konfigurieren.

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

  • List Resources (Beta): Ruft verfügbare Ressourcen von einem MCP-Server ab und ist als Quelle in einem Vorgang vorgesehen.

  • List Prompts (Beta): Ruft verfügbare Eingabeaufforderungen von einem MCP-Server ab und ist als Quelle in einem Vorgang vorgesehen.

  • Get Prompt (Beta): Ruft spezifische Eingabeaufforderungen von einem MCP-Server ab und ist als Quelle in einem Vorgang vorgesehen.

  • Read Resource (Beta): Ruft spezifische Ressourcen von einem MCP-Server ab und ist als Quelle in einem Vorgang vorgesehen.