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 und entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Erstellen oder Bearbeiten einer MCP-Client-Verbindung

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

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

Konfigurieren einer MCP-Client-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die MCP-Client-Verbindung 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-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 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.

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

      • 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 auswä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 ein, 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 ein, 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 sein.

    • 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, 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 Automatische Connector-Aktualisierung deaktivieren Organisationsrichtlinie.

  • Ä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-Clientverbindung hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfskanvas, 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.