Zum Hauptinhalt springen

MCP-Clients

Das Model Context Protocol (MCP) ist ein offener Standard, um KI-Modellen Tools bereitzustellen. Viele Dienste bieten einen MCP-Server an, und Sie können auch einen eigenen schreiben. Ein KI-MCP-Client verbindet MonoChat mit einem MCP-Server, damit die Tools dieses Servers Ihren KI-Knoten und KI-Agenten zur Verfügung gestellt werden können, neben den KI-Tool-Funktionen, die Sie in MonoChat schreiben.

Sie verwalten sie unter Einstellungen › Automatisierung › KI-MCP-Clients.

So funktioniert es​

  1. Sie fügen die Adresse des MCP-Servers hinzu und verbinden. MonoChat liest aus, was der Server anbietet: seine Tools, Ressourcen, Ressourcenvorlagen und Prompts.
  2. Beim Speichern behält MonoChat diese Liste als Inhalt des Clients.
  3. In einem Knoten KI-Chat-Completion erstellen oder einem Knoten KI-Agent wählen Sie die Tools aus, die dieser Knoten haben soll, und Sie können die Beschreibung jedes Tools für das Modell umschreiben.
  4. Während der Konversation entscheidet das Modell, wann ein Tool aufgerufen wird; MonoChat ruft den MCP-Server auf und gibt das Ergebnis an das Modell zurück.

Einem Knoten stehen nur die Tools zur Verfügung, die Sie ihm hinzufügen, sodass jeder Knoten genau das sieht, was er braucht.

MCP-Client hinzufügen​

  1. Gehen Sie zu Einstellungen › Automatisierung › KI-MCP-Clients und klicken Sie auf + (Erstellen).

  2. Füllen Sie die Felder aus:

    FeldBeschreibung
    NameEin Name für den Server, der in den Seitenleisten der Knoten neben jedem seiner Tools angezeigt wird.
    BeschreibungOptionale Notizen.
    VersionDie Client-Version, die MonoChat dem Server beim Verbinden mitteilt, zum Beispiel 1.0.0.
    EndpointDie Basis-URL des MCP-Servers. MonoChat verbindet sich mit dem SSE-Transport unter <Endpoint>/sse, geben Sie die Adresse also ohne /sse ein.
    Auth-TypKeine, Basic (mit Benutzername und Passwort) oder Bearer (mit Token). Die Zugangsdaten werden mit dem Client gespeichert.

  3. Klicken Sie auf Verbinden. MonoChat verbindet sich mit dem Server und zeigt in Tabs, was es gefunden hat:

    • Server-Info: Name, Version, Protokollversion und Anweisungen des Servers.
    • Tools: Name und Beschreibung jedes Tools.
    • Ressourcen, Ressourcenvorlagen und Prompts, sofern der Server welche anbietet.

  4. Wenn die Liste stimmt, klicken Sie auf Speichern. Um die Adresse zu ändern und es erneut zu versuchen, klicken Sie auf die Schaltfläche Trennen daneben.

tipp

Wenn Verbinden fehlschlägt, prüfen Sie, ob der Endpoint aus dem Internet erreichbar ist, ob der Server den SSE-Transport unterstützt und ob die URL nicht bereits auf /sse endet.

Tool-Liste aktualisieren​

Wenn der MCP-Server Tools hinzufügt oder ändert, öffnen Sie den Client mit Aktualisieren. MonoChat verbindet sich erneut und zeigt den aktuellen Inhalt; klicken Sie auf Aktualisieren, um die neue Liste zu speichern.

Beim Löschen eines Clients wird auch sein Inhalt entfernt, sodass Knoten die Tools verlieren, die von ihm stammten.

Tools einem Knoten zuweisen​

Knoten „KI-Chat-Completion erstellen"​

  1. Öffnen Sie den Knoten und scrollen Sie zu Einstellungen für KI-MCP-Client-Content-Tools.
  2. Klicken Sie auf KI-MCP-Client-Content-Tools festlegen. Die Seitenleiste KI-MCP-Client-Content-Tools listet die Tools auf, die diesem Knoten bereits hinzugefügt wurden.
  3. Klicken Sie auf + (Erstellen) und wählen Sie dann ein Tool unter KI-MCP-Client-Content-Tools. Tools werden als <client name> - <tool name> aufgelistet.
  4. Die Beschreibung wird mit der eigenen Beschreibung des Tools gefüllt. Bearbeiten Sie sie, wenn Sie dem Modell genauer sagen möchten, wann das Tool zu verwenden ist, zum Beispiel „Use this to look up an order by its number". Die Beschreibung ist erforderlich.
  5. Wiederholen Sie dies für jedes Tool und speichern Sie dann den Knoten.

In derselben Seitenleiste können Sie die Beschreibung eines Tools aktualisieren oder es aus dem Knoten entfernen.

Knoten „KI-Agent"​

Der Knoten KI-Agent hat dieselbe Schaltfläche KI-MCP-Client-Content-Tools festlegen in seinem Abschnitt Tool-Einstellungen. Die ausgewählten MCP-Tools werden dem Agenten zusammen mit den KI-Bereichen und KI-Tools des Knotens angeboten, bei jedem Harness. Siehe KI-Agenten.

Info

Eine Agent-Ausführung prüft, ob jedes MCP-Tool des Knotens in Ihrem Workspace noch existiert. Wenn Sie einen MCP-Client löschen, den ein Knoten verwendet, schlagen Ausführungen dieses Knotens mit „An AI scope or MCP tool was not found in this workspace." fehl, bis Sie das Tool aus dem Knoten entfernen.

Berechtigungen​

Der Zugriff wird über die Rollenberechtigungen Read / Create / Update / Delete AI MCP clients in automation und Read AI MCP client contents in automation gesteuert. Siehe Rollen.