MCP Servers
MCP Server (Model Context Protocol Server) sind externe Dienste, die Tools und Funktionen über eine standardisierte Schnittstelle bereitstellen. Dadurch können Agenten auf Funktionalitäten zugreifen, die außerhalb von Bubble Chat implementiert sind – zum Beispiel spezialisierte APIs, Datenbanken oder externe Dienste.
Das Model Context Protocol (MCP) ist ein offener Standard für die Integration von externen Tools in KI-Systemen. Ein MCP Server stellt seine verfügbaren Funktionen über eine definierte Schnittstelle zur Verfügung. Nach der Aktivierung wird eine Funktion eines MCP Servers als Tool in Bubble Chat verfügbar und kann Agenten zugewiesen werden.
Was ist ein MCP Server?
Ein MCP Server erweitert die Fähigkeiten deiner Agenten, indem er spezialisierte Funktionen bereitstellt, die in Echtzeit aufgerufen werden können. Der Agent entscheidet selbstständig, wann er welche Funktion verwenden muss, um die Anfrage eines Benutzers zu beantworten.
Beispiel: Wetterdaten abrufen
Stell dir vor, du betreibst einen MCP Server, der aktuelle Wetterdaten liefert. Dieser Server bietet eine Funktion getWeather(city) an.
So funktioniert das Zusammenspiel:
- Benutzer fragt: «Wie ist das Wetter in Zürich?»
- Agent analysiert: Der Agent erkennt, dass er Wetterdaten benötigt
- MCP-Aufruf: Der Agent ruft die Funktion
getWeather("Zürich")auf dem MCP Server auf - Server antwortet: Der MCP Server liefert aktuelle Wetterdaten (Temperatur, Bedingungen, etc.)
- Agent formuliert Antwort: Der Agent verarbeitet die Daten und antwortet: «In Zürich ist es derzeit 18°C und bewölkt.»
Durch dieses Prinzip können Agenten auf beliebige externe Datenquellen und Dienste zugreifen, ohne dass diese Logik direkt in Bubble Chat implementiert sein muss.
Übersicht
Die Listenansicht zeigt alle konfigurierten MCP Server. Über das Suchfeld kann die Liste nach Namen gefiltert werden. Ein Klick auf einen Server öffnet die Detailansicht mit allen verfügbaren Funktionen.
Neuen MCP Server hinzufügen
Ein neuer MCP Server wird über den +-Button hinzugefügt. Im Erstellungsdialog werden folgende Informationen erfasst:
| Feld | Beschreibung |
|---|---|
| Name | Eindeutiger Name für den MCP Server |
| URL | Adresse des MCP Servers (z.B. http://localhost:3000/mcp/sse) |
Nach dem Speichern wird automatisch eine Synchronisation durchgeführt, bei der alle vom Server angebotenen Funktionen abgerufen werden.
MCP Server bearbeiten
In der Detailansicht eines MCP Servers kann der Name angepasst werden. Falls sich die URL des MCP Servers ändert, muss der Server gelöscht und mit der neuen URL neu hinzugefügt werden.
Synchronisation
Die Synchronisation gleicht die lokale Funktionsliste mit dem Remote-Server ab. Sie wird automatisch beim Erstellen durchgeführt und kann jederzeit manuell über den Sync-Button ausgelöst werden. Ausserdem wird täglich überprüft, ob der MCP Server die Tools weiterhin anbietet.
Bei der Synchronisation werden:
- Neue Funktionen mit Status Neu erstellt hinzugefügt
- Geänderte Funktionen mit Status Aktualisiert markiert
- Nicht mehr verfügbare Funktionen mit Status Nicht verfügbar gekennzeichnet
Funktionen verwalten
Jede Funktion eines MCP Servers kann einzeln aktiviert oder deaktiviert werden:
Funktion aktivieren
Beim Aktivieren einer Funktion:
- Wird automatisch ein entsprechendes Tool erstellt
- Das Tool kann anschliessend Agenten zugewiesen werden
- Die Funktion erscheint in der globalen Tool-Liste
Funktion deaktivieren
Eine Funktion kann nur deaktiviert werden, wenn sie in keinem Agenten mehr verwendet wird. Beim Deaktivieren wird das zugehörige Tool aus der globalen Liste entfernt.
Aktivierte MCP-Funktionen werden automatisch als Tools mit folgenden Eigenschaften angelegt:
- Name: Funktionsname aus dem MCP Server
- Beschreibung: Funktionsbeschreibung vom Server
- Konfiguration: Referenz auf MCP Server und Funktionsname
Wichtig: MCP Tools können nicht manuell angepasst werden, da sie vom MCP Server fix definiert sind. Änderungen an der Funktionsdefinition werden nur durch eine erneute Synchronisation mit dem Server übernommen.
Sync-Status
Jede Funktion zeigt ihren aktuellen Synchronisationsstatus:
| Status | Bedeutung |
|---|---|
| Neu erstellt | Die Funktion wurde neu vom Server bereitgestellt |
| Aktualisiert | Die Funktionsdefinition hat sich geändert |
| Nicht verfügbar | Die Funktion wird vom Server nicht mehr angeboten (REMOVED) |
MCP Server löschen
Ein MCP Server kann über die Aktionsleiste im Detailbereich gelöscht werden. Dabei werden folgende Prüfungen durchgeführt:
Ein MCP Server kann nur gelöscht werden, wenn keines der zugehörigen Tools mehr in einem Agenten verwendet wird.
Entferne zuerst alle Tools dieses Servers aus den betroffenen Agenten, bevor du den Server löschst.
Beim Löschen werden:
- Der MCP Server aus der Konfiguration entfernt
- Alle zugehörigen Tools gelöscht (auch wenn sie nicht aktiv in Agenten verwendet werden)
- Alle Funktionsdefinitionen entfernt
Das Löschen eines MCP Servers ist unwiderruflich. Alle Konfigurationen und Tool-Zuweisungen gehen verloren und müssen bei erneutem Hinzufügen neu vorgenommen werden.
Umgang mit nicht verfügbaren Funktionen
Wenn eine Funktion den Status Nicht verfügbar erhält:
- Prüfe, ob die Funktion noch in Agenten verwendet wird
- Ersetze die Funktion bei Bedarf durch eine Alternative
- Deaktiviere die Funktion, um sie aus der Tool-Liste zu entfernen