MCP-Server

Über MCP-Server verbindest du externe Tool-Server mit symbiofy. Die dort bereitgestellten Tools stehen anschließend deinen SymbioBots im Chat zur Verfügung – zum Beispiel, um Daten aus einem anderen System abzurufen oder eine Aktion dort auszulösen. Du findest die Verwaltung im Administrationsbereich unter MCP-Server verwalten (erreichbar über die Integrationen-Übersicht).

Hinweis: Die Verwaltung von MCP-Servern ist Administratoren deiner Organisation vorbehalten. Hinzugefügte Server gelten nur für deine eigene Organisation.

Server hinzufügen

1. Klicke auf Server hinzufügen
2. Gib einen Namen ein (z. B. “Meta MCP”)
3. Trage die URL des MCP-Servers ein
4. Wähle den Transport: Streamable HTTP oder Server-Sent Events
5. Wähle die Authentifizierung (siehe unten)
6. Klicke auf Verbinden

Beim Speichern verbindet sich symbiofy mit dem Server und ruft dessen Tool-Liste ab.

Authentifizierung

Je nachdem, was der Server verlangt, stehen drei Methoden zur Auswahl:

• Keine – der Server benötigt keine Anmeldung.
• API-Schlüssel – du hinterlegst einen Schlüssel. Optional kannst du unter Header-Name einen abweichenden Header angeben (Standard: Authorization als Bearer-Token).
• OAuth 2.0 – beim Klick auf Mit OAuth verbinden öffnet sich ein Popup mit der Login- und Zustimmungsseite des externen Dienstes. Nach erteilter Freigabe wird der Server automatisch verbunden.

Tipp zu OAuth: Falls der Anbieter keine automatische Registrierung unterstützt, erscheint ein kurzes Formular. Trage dort die Client-ID und – sofern vom Anbieter ausgegeben – das Client-Secret ein und klicke auf Mit Zugangsdaten erneut versuchen.

Hinweis: Wird das Popup nicht geöffnet, hat dein Browser es vermutlich blockiert. Erlaube Popups für diese Seite und versuche es erneut.

Tools freigeben

Nach dem Hinzufügen meldet der Server seine verfügbaren Tools. Diese sind zunächst deaktiviert – du gibst sie gezielt frei:

1. Klicke beim Server auf Tools anzeigen
2. Aktiviere die gewünschten Tools einzeln über den Schalter
3. Mit Alle aktivieren bzw. Alle deaktivieren schaltest du alle auf einmal um

Wichtig: Ein Server ohne aktivierte Tools erscheint nicht in deinen Bots oder Skills. Solange kein Tool aktiviert ist, zeigt symbiofy auf der Server-Karte einen entsprechenden Hinweis an.

In SymbioBots nutzen

Sobald mindestens ein Tool aktiviert ist, taucht der Server bei der Konfiguration der Tools eines SymbioBots als auswählbarer Eintrag auf. Dort entscheidest du, welche Bots auf den Server zugreifen dürfen.

Im Chat fragt der Bot vor jeder Nutzung eines MCP-Tools nach deiner Bestätigung. Du kannst dann Einmalig erlauben, In diesem Chat immer erlauben oder Ablehnen wählen. Tools externer MCP-Server werden nicht von symbiofy geprüft – prüfe sie daher vor dem Erlauben.

Erneute Autorisierung bei OAuth

Laufen die OAuth-Zugangsdaten eines Servers ab, zeigt die Server-Karte den Hinweis OAuth-Zugangsdaten abgelaufen — erneute Autorisierung erforderlich an. Klicke auf Erneut autorisieren, um dich erneut anzumelden und die Verbindung wiederherzustellen.

Server verwalten

• Erneut synchronisieren – aktualisiert die Tool-Liste, wenn der Server neue Tools bereitstellt oder Tools entfernt wurden.
• Bearbeiten – ändert Verbindungsdaten oder hinterlegt einen neuen API-Schlüssel.
• Löschen – entfernt den Server. Klicke ein zweites Mal zur Bestätigung.

Hinweis: Mit dem Schalter oben rechts auf der Karte aktivierst oder deaktivierst du einen Server vorübergehend, ohne ihn zu löschen.