Importieren von Werkzeugen von einem MCP-Server

Online bearbeiten

Sie können externe Tools von MCP-Servern (Model Context Protocol) importieren und sie zu Ihren Agenten hinzufügen, um die Fähigkeit des Agenten zur Erledigung von Aufgaben zu verbessern.

Entscheiden Sie zunächst, ob Sie ein MCP-Server-Tool direkt in das System oder für einen bestimmten Agenten importieren möchten.

Ein MCP-Server-Tool in das System importieren

So importieren Sie ein MCP-Server-Tool in das System:

  1. Gehen Sie im Menü auf Menü„Build “.

    Wählen Sie in der „ IBM Cloud “-Umgebung den Arbeitsbereich, in dem Sie das Tool erstellen möchten, aus der Arbeitsbereichsliste aus, oder erstellen Sie einen neuen Arbeitsbereich.

  2. Navigieren Sie zu Alle Werkzeuge.

  3. Wählen Sie ein vorhandenes Werkzeug aus oder klicken Sie auf Werkzeug erstellen +, um ein neues Werkzeug hinzuzufügen.

  4. Wählen Sie MCP-Server.

Ein MCP-Server-Tool für einen Agenten importieren

So importieren Sie ein MCP-Server-Tool für einen Agenten:

  1. Gehen Sie im Menü auf Menü„Build “.

    Wählen Sie in der „ IBM Cloud “-Umgebung den Arbeitsbereich für den Agenten aus der Arbeitsbereichsliste aus.

  2. Alle Agenten auswählen.

  3. Finden Sie Ihren Agenten und klicken Sie ihn an.

  4. Klicken Sie im Werkzeugsatz des Agenten im Abschnitt Werkzeugsatz auf Werkzeug hinzufügen.

  5. Klicken Sie auf MCP-Server.

Externe Tools von einem MCP-Server importieren

Um externe Tools von einem MCP-Server zu importieren, führen Sie die folgenden Schritte aus:

  1. Klicken Sie im Dialogfeld „Tool hinzufügen “ auf „MCP-Server“, um das Fenster „Tools hinzufügen und MCP-Server verwalten“ anzuzeigen.

  2. So fügen Sie Tools aus dem vorhandenen MCP-Server hinzu:

    1. Klicken Sie auf das Filter Symbol.

    2. Wählen Sie den Namen des MCP-Servers aus der Liste aus.

    3. Aktivieren Sie die Kontrollkästchen für die Tools, die Sie hinzufügen möchten.

    4. Klicken Sie auf „Zum Agenten hinzufügen ”.

  3. So fügen Sie Ihrem Agenten einen weiteren MCP-Server hinzu:

    1. Klicken Sie auf MCP-Server hinzufügen.

    2. Wählen Sie „Lokaler MCP-Server“ oder „Remote-MCP-Server“, um Tools in Ihren Agenten zu importieren.

Tools von einem lokalen MCP-Server importieren

Um Tools von einem lokalen MCP-Server zu importieren, führen Sie die folgenden Schritte aus:

  1. Wählen Sie „Lokaler MCP-Server“ aus und klicken Sie auf „Weiter “.

  2. Geben Sie die Details des MCP-Servers an, wie Name, Beschreibung und Installationsbefehl.

  3. Optional: Wählen Sie die Verbindung aus der Verbindungsliste aus.

Lokale MCP-Server verwenden für die Kommunikation immer STDIO (Standard Input/Output). Benutzer haben nicht die Möglichkeit, ein anderes Protokoll auszuwählen. STDIO ist standardmäßig ausgewählt und wird automatisch vom Flow Builder verwaltet.

  1. Klicken Sie auf Importieren.

    Wenn die Verbindung erfolgreich hergestellt wurde, bestätigt eine Benachrichtigung, dass der MCP-Server bereit ist und die Tools verfügbar sind.

  2. Klicken Sie auf das Filter Symbol im Suchfeld und wählen Sie dann den Namen des MCP-Servers aus der Liste aus.

  3. Aktivieren Sie die Kontrollkästchen für die Tools, die Sie hinzufügen möchten.

  4. Klicken Sie auf „Zum Agenten hinzufügen ”.

Ihr Agent enthält nun Tools vom lokalen MCP-Server.

Tools von einem entfernten MCP-Server importieren

Um Tools von einem Remote-MCP-Server zu importieren, führen Sie die folgenden Schritte aus:

  1. Wählen Sie „Remote-MCP-Server“ aus und klicken Sie auf „Weiter “.

  2. Geben Sie die MCP-Serverdetails wie Name, Beschreibung, MCP-Server an URL.

  3. Wählen Sie die Transportart aus. Die folgenden Optionen sind verfügbar:

    • Streamable- HTTP : Verwendet Standard- HTTP en und unterstützt streambare Daten. Es streamt die Ausgabe Token für Token, anstatt die gesamte Antwort auf einmal zu senden, sodass große oder langwierige Antworten schrittweise verarbeitet werden können.

    • Server-Sent Events (SSE) : Nutzt eine langlebige Verbindung über „ HTTP “, um ereignisbasierte Echtzeit-Updates vom Server zu empfangen. SSE eignet sich ideal für Tools, die inkrementelle Statusaktualisierungen oder kontinuierliche Daten Event Streams generieren.

Standardmäßig ist „Streamable HTTP “ ausgewählt.

  1. Optional: Wählen Sie die Verbindung aus der Verbindungsliste aus.

  2. Klicken Sie auf Verbinden.

Wenn die Verbindung erfolgreich hergestellt wurde, bestätigt eine Benachrichtigung, dass der MCP-Server bereit ist und die Tools verfügbar sind.

  1. Klicken Sie auf das Filter Symbol im Suchfeld und wählen Sie dann den Namen des MCP-Servers aus der Liste aus.

  2. Aktivieren Sie die Kontrollkästchen für die Tools, die Sie hinzufügen möchten.

  3. Klicken Sie auf „Zum Agenten hinzufügen ”.

Ihr Agent verfügt nun über Tools, die vom Remote-MCP-Server importiert wurden.

Tipp:

  • Orchestrate unterstützt derzeit nur MCP-Servertools, die in Python und TypeScript geschrieben sind. Zukünftige Versionen erweitern diese Funktion um MCP-Serverressourcen und Eingabeaufforderungen.

MCP-Server aus dem Katalog hinzufügen

Fügen Sie MCP-Tools aus dem Katalog zum Toolset Ihres Agenten hinzu, um dessen Funktionen durch vorkonfigurierte Tools von entfernten MCP-Servern zu erweitern. Entwickler können im Katalog nach verfügbaren MCP-Servern suchen, diese bei Bedarf freischalten, eine Verbindung zu einem Remote-MCP-Server herstellen und dessen Tools zur Laufzeit gezielt zu einem Agenten hinzufügen. Nach erfolgreicher Verbindung stehen die mit dem Remote-MCP-Server verknüpften Tools im „ agent.The “-Katalog zur Verfügung. Der Katalog unterstützt derzeit ausschließlich Remote-MCP-Server. Lokale MCP-Server werden nicht unterstützt.

MCP-Server im Katalog anzeigen

So zeigen Sie MCP-Server aus dem Katalog an:

  1. Gehen Sie im Menü auf Menü„Build “.

  2. Zu „Alle Agenten“ gehen.

  3. Finden Sie Ihren Agenten und klicken Sie ihn an.

  4. Klicken Sie im Werkzeugsatz des Agenten im Abschnitt Werkzeugsatz auf Werkzeug hinzufügen.

  5. Wählen Sie „Katalog“ aus.

    Der Katalog wird geöffnet und zeigt die verfügbaren Tools und MCP-Server an. Im Bereich „MCP-Server“ wird zunächst eine Vorschau der verfügbaren Server angezeigt.

  6. Klicken Sie im Abschnitt „MCP-Server“ auf „Alle anzeigen“, um die vollständige Liste der verfügbaren MCP-Server anzuzeigen.

Filtern und Suchen von MCP-Servern

Der MCP-Serverkatalog bietet zahlreiche Filter- und Sortieroptionen, mit denen Sie schnell den MCP-Server finden können, der am besten zu Ihrem Anwendungsfall passt.

Die folgenden Optionen können verwendet werden:

Verwaltung von MCP-Servern

Auf der Seite MCP-Server verwalten können Sie die Details der MCP-Server bearbeiten und nicht mehr benötigte MCP-Server löschen.

Um MCP-Server sowohl für Remote- als auch für lokale MCP-Server zu verwalten, führen Sie die folgenden Schritte aus:

  1. Klicken Sie auf MCP-Server verwalten.

  2. Um die Details für einen MCP-Server zu bearbeiten, klicken Sie auf das Symbol optionssymbol„Optionen“ und anschließend auf „Details bearbeiten “.

  3. Um einen MCP-Server zu löschen, klicken Sie auf das Symbol optionssymbol„Optionen“ und anschließend auf „Löschen “.

Nächste Schritte

Nachdem ein Werkzeug hinzugefügt wurde, kann ein Agent es verwenden. Nachdem Sie Ihre Werkzeuge hinzugefügt haben, sollten Sie Folgendes beachten:

  • Aktualisieren Sie die Beschreibung des Tools. Der Bearbeiter verwendet das Feld für die Werkzeugbeschreibung, um festzustellen, ob und wie er das Werkzeug verwenden wird. Stellen Sie sicher, dass Sie eine detaillierte Beschreibung liefern, wie der Agent das Tool nutzen kann. Um die Werkzeugbeschreibung zu aktualisieren, klicken Sie auf das Werkzeugmenü und wählen Sie Details bearbeiten. Wenn Sie mit Ihrer Beschreibung zufrieden sind, klicken Sie auf Speichern. Sie können die Beschreibung immer wieder überarbeiten, während Sie das Tool testen.

  • Testen Sie das Werkzeug. Um Ihr Tool zu testen, verwenden Sie die Aufforderung im Chatfenster Vorschau, um Ihr Tool aufzurufen.

  • Vergewissern Sie sich, dass der Wert, der von einem Python Werkzeug zurückgegeben wird, dem Datentyp entspricht, den Sie für dieses Werkzeug definiert haben.

Das Model Context Protocol (MCP) ermöglicht es Agenten, externe Tools, die von MCP-Servern bereitgestellt werden, zu erkennen, sich mit ihnen zu verbinden und sie zu starten.