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.

Erstellen oder Bearbeiten einer MCP-Client-Verbindung

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

Eine vorhandene MCP-Client-Verbindung kann von diesen Standorten 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 Anfragen an den MCP-Server gesendet werden 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 <span class="icon-check"></span> 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 <span class="icon-edit"></span> Bearbeiten-Symbol oder das <span class="icon-trash"></span> Löschen-Symbol.

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

!!! important "Wichtig"
    Felder in der Tabelle zeigen das <span class="icon-variable"></span> 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](/de/release-notes/harmony-release-notes/summer-2023/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 Organisation Richtlinie Automatische Connector-Aktualisierung deaktivieren.

    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 Anforderungsheader konfigurieren.

  • Änderungen speichern: Klicken Sie, um die Konfigurationsänderungen zu speichern und die Verbindung 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 wirklich 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 wirklich 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 einer Operation bereitzustellen) oder als Ziele (um Daten in einer Operation 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:

  • Werkzeugliste: Ruft verfügbare Werkzeuge von einem MCP-Server ab und ist als Quelle in einer Operation vorgesehen. Verwenden Sie die zurückgegebenen Daten, um die Werkzeuge aufrufen-Aktivität zu konfigurieren.

  • Werkzeuge aufrufen: Führt ein bestimmtes Werkzeug auf einem MCP-Server aus und ist als Ziel in einer Operation vorgesehen. Verwenden Sie zuerst die Werkzeugliste-Aktivität, um verfügbare Werkzeuge und deren erforderliche Felder anzuzeigen.