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 vier 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. Du als Administrator autorisierst hier einmalig; die dabei gespeicherte Verbindung gilt anschließend für alle Nutzer deiner Organisation – alle greifen also über dieselbe Verbindung zu.
• OAuth (pro Benutzer) – für externe Server, die pro Person eine eigene Anmeldung verlangen (z. B. weil jeder Nutzer nur seine eigenen Daten sehen soll). Im Auswahlfeld heißt diese Option OAuth 2.1 (pro Benutzer). Hier autorisierst du als Administrator nicht für die ganze Organisation: Du legst nur den Server an, und jeder Nutzer verbindet sich anschließend selbst (siehe Persönliche Verbindung für Nutzer). Es wird also keine gemeinsame Verbindung für alle gespeichert.

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.

Tools laden bei „OAuth (pro Benutzer)”

Bei den anderen Authentifizierungsarten ruft symbiofy die Tool-Liste direkt beim Speichern ab. Bei OAuth (pro Benutzer) geht das nicht: Es existiert noch keine Anmeldung, mit der sich der Server abfragen ließe. Ein frisch angelegter Server hat deshalb zunächst keine Tools – und solange niemand autorisiert hat, gibt es auch nichts freizugeben.

Damit du trotzdem Tools freigeben kannst, autorisierst du als Administrator deine eigene Anmeldung. Damit lädt symbiofy die Tool-Liste des Servers, und du kannst anschließend wie gewohnt einzelne Tools aktivieren.

Dafür gibt es zwei Wege:

1. Direkt nach dem Anlegen – sobald du einen Server mit dieser Authentifizierung gespeichert hast, öffnet sich der Dialog Server autorisieren, um Tools zu laden. Klicke auf Jetzt autorisieren, um dich anzumelden und die Tools zu laden. Mit Später überspringst du den Schritt.
2. Später über die Server-Karte – hat der Server noch keine Tools, zeigt seine Karte den Hinweis „Noch keine Tools geladen — bei OAuth pro Benutzer können Tools erst nach deiner einmaligen Autorisierung geladen und aktiviert werden.” und einen Button Autorisieren & Tools laden. Dieser öffnet denselben Dialog.

Wichtig: Deine Autorisierung als Administrator dient nur dazu, die Tool-Liste zu laden. Alle anderen Nutzer müssen sich weiterhin selbst verbinden, um die Tools tatsächlich nutzen zu können.

Persönliche Verbindung für Nutzer

Server mit OAuth (pro Benutzer) verbindet jede Person selbst. Das geht in den eigenen Benutzereinstellungen unter Integrationen im Abschnitt MCP-Server (persönliche Anmeldung). Dort erscheinen alle Server, die eine individuelle Autorisierung verlangen. Pro Server stehen zur Verfügung:

• Verbinden – meldet dich beim externen Dienst an (Popup mit Login- und Zustimmungsseite).
• Trennen – hebt deine Verbindung wieder auf.
• Erneut anmelden – erscheint, wenn deine Anmeldung abgelaufen ist (Status Erneute Anmeldung nötig).

Solange du dich nicht verbunden hast, stehen dir die Tools dieses Servers nicht zur Verfügung – andere Nutzer sind davon nicht betroffen.

Nutzt du im Chat einen Bot, dessen persönlich zu autorisierenden Server du noch nicht verbunden hast, blendet der Chat einen Hinweis mit einem Verbinden-Button ein („Verbinde dich einmalig, damit die Tools dieses Servers für dich verfügbar werden.”). Bis du das tust, bleiben die betroffenen Tools für dich einfach ausgeblendet.

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.

Bei OAuth (pro Benutzer) gilt die abgelaufene Anmeldung immer nur für eine einzelne Person. Betroffene Nutzer melden sich selbst in ihren Benutzereinstellungen → Integrationen über Erneut anmelden neu an – nicht der Administrator. Läuft deine Administrator-Anmeldung (mit der du die Tools geladen hast) ab, erneuerst auch du sie auf demselben Weg.

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.