Custom Agents erweitern deinen KI-Assistenten mit spezialisierten Fähigkeiten und Zugriff auf externe Tools. Durch die Anbindung eines MCP-Servers (Model Context Protocol) kannst du deinem Agenten die Möglichkeit geben, echte Aktionen in Drittanbieter Systemen auszuführen – z. B. Ideen einreichen, Tickets erstellen oder Daten aus internen Diensten abrufen und das alles direkt aus deinem KI-Assistenten heraus.

Dieser Artikel führt dich durch die Schritte, wie du einen Custom Agent erstellst, ihn mit einem MCP-Server verbindest und ihn für deine Nutzenden freigibst.

Was ist ein MCP-Server?

MCP (Model Context Protocol) ist ein offener Standard, mit dem sich KI-Assistenten sicher mit externen Tools und Datenquellen verbinden können. Ein MCP-Server fungiert als Brücke zwischen deinem KI-Assistenten und einem anderen System. Er stellt eine definierte Reihe von „Tools“ bereit, die der Assistent im Namen deiner Nutzenden verwenden kann.

In Flip sind MCP-Server die Basis für Custom Agents. Wenn Nutzende den KI-Assistenten etwas fragen, das zum Zweck eines Custom Agents passt, übergibt der Assistent die Anfrage an diesen Agenten. Dieser nutzt dann die verbundenen Tools, um die Aufgabe zu erledigen.

Beispielhafte Anwendungsfälle

• Internes Wissen — Abfragen einer eigenen Wissensdatenbank, von FAQs oder einer internen API, die nicht durch die Standard-Datenquellen von Flip abgedeckt sind.

• Ideen- und Feedback-Sammlung — Mitarbeitende können Ideen, Vorschläge oder Feedback einreichen, durchsuchen und dafür abstimmen.

• Status und Berichterstattung — Daten aus internen Dashboards, Monitoring-Tools oder Statusseiten abrufen.

• Nachschlagen von Referenzen — Produktdetails finden, Richtlinien einsehen oder Referenzdaten aus internen Systemen abrufen.

Wichtig: So funktioniert die Authentifizierung

Flip unterstützt derzeit die Authentifizierung per API-Schlüssel für MCP-Server. Das bedeutet, dass jede Anfrage des KI-Assistenten, unabhängig davon, welche:r Flip-Nutzer:in gerade chattet, mit demselben gemeinsam genutzten API-Schlüssel an den MCP-Server gesendet wird.

In der Praxis bedeutet das aktuell:

• Der MCP-Server sieht alle Anfragen so, als kämen sie von einem einzigen Konto (dem Inhaber des API-Schlüssels).

• Jede Aktion, die der Agent im verbundenen System ausführt, wird technisch gesehen von diesem Konto durchgeführt.

• Der MCP-Server kann die Identität des Flip-Nutzenden hinter einer Anfrage nicht unabhängig überprüfen.

Das funktioniert gut für reine Lesezugriffe und Aktionen, bei denen die Identität des Nutzenden eher als Metadaten und nicht als Sicherheitsgrenze dient. Zum Beispiel beim Abfragen einer Wissensdatenbank oder beim Einreichen einer Idee.

Für Aktionen, die eine Authentifizierung oder Autorisierung pro Nutzer:in erfordern, ist dies nicht geeignet.  Zum Beispiel für das Buchen von Urlaub im HR-System, den Zugriff auf persönliche Gehaltsabrechnungen oder alles, bei dem das verbundene System genau prüfen muss, wer was tut. Für diese Szenarien hat der MCP-Server derzeit keine Möglichkeit, die Identität des Flip-Nutzenden zu bestätigen, und alle Aktionen würden dem Inhaber des gemeinsamen API-Schlüssels zugeordnet.

Wir arbeiten aktiv an der Erweiterung der Authentifizierung Optionen. Wenn dein Anwendungsfall einen anderen Ansatz erfordert, zum Beispiel OAuth pro Nutzer:in, damit das verbundene System jede:n Flip-Nutzer:in identifizieren kann, lass uns bitte wissen, wie du dich authentifizieren möchtest. Dein Feedback hilft uns bei der Priorisierung der nächsten Schritte.

Bevor du startest

• Du benötigst Root-Admin-Berechtigungen, um Custom Agents zu erstellen oder zu bearbeiten.

• Du brauchst die URL eines MCP-Servers, der den Streamable HTTP-Transport unterstützt.

• Wenn der MCP-Server eine Authentifizierung erfordert, halte den Header-Namen und den API-Schlüssel bereit.

• Du kannst bis zu 10 Custom Agents pro Workspace erstellen.

Schritt 1: Öffne die Einstellungen für Custom agents

1. Öffne die Admin Konsole.

2. Gehe in der linken Seitenleiste auf KI-Assistent → Custom Agent.

3. Klicke auf Agent erstellen (oder + Neuer Agent, wenn du bereits Agenten eingerichtet hast).

   

Schritt 2: Konnektor hinzufügen

Jeder Custom Agent benötigt mindestens einen Konnektor, das ist der MCP-Server, der dem Agenten seine Tools bereitstellt.

1. Klickt im Schritt Konnektoren auf + Konnektor hinzufügen.

   

2. Trage die Details für den Konnektor ein:

   • Name — Ein eindeutiger Name für den Konnektor (z. B. „Ideen-Manager MCP-Server“).

   • MCP-Server-URL — Die vollständige URL deines MCP-Servers.

   • Transport — Wähle Streamable HTTP.

   • Authentifizierung — Wähle API-Schlüssel, wenn dein Server einen Schlüssel erfordert, oder Keine für einen offenen Server.

3. Wenn du API-Schlüssel ausgewählt hast, gib den Kopfzeile Name und den API-Schlüssel ein, die dir von deinem MCP-Server bereitgestellt wurden.

   

4. Klicke auf Speichern.

Schritt 3: Tool-Berechtigungen festlegen

Sobald dein Konnektor gespeichert ist, erkennt Flip automatisch die vom MCP-Server bereitgestellten Tools. Standardmäßig sind alle Tools blockiert, bis du sie explizit freigibst.

1. Überprüfe die Liste der Tools unter Tool-Berechtigungen.

2. Schalte den Regler bei jedem Tool auf Zulassen, das der Agent verwenden können soll. Du kannst auch das Dropdown-Menü Zulassen / Blockieren oben rechts nutzen, um alle Tools auf einmal zu aktualisieren.

   

3. Klicke auf Weiter, um fortzufahren.

Gut zu wissen: Erlaube nur die Tools, die dein Agent auch wirklich braucht. Nicht genutzte Tools blockiert zu lassen, hilft dem KI-Assistenten, die richtige Aktion zu wählen, und reduziert unerwünschtes Verhalten.

Schritt 4: Die Identität des Agenten definieren

Im Schritt Agenten-Details gibst du deinem Agenten einen Namen, einen Zweck und die Anweisungen, denen er folgen soll.

1. Klicke auf das Feld Icon, um ein Symbol auszuwählen. Dieses Icon erscheint im Chat, sobald der Agent aktiv ist.

   

2. Gib einen Agenten-Namen ein (z. B. „Ideen-Manager“).

3. Schreibe eine Beschreibung. Dein KI-Assistent nutzt es, um zu entscheiden, wann dieser Agent aktiviert werden soll. Beschreibe genau, was der Agent tut und (ebenso wichtig), wofür er nicht verwendet werden sollte.

   

4. Schreibe Anweisungen für den Agenten. Diese sagen dem Agenten, wie er sich verhalten soll – seine Rolle, sein Tonfall, Grundregeln und etwaige Einschränkungen. 

Tipp: Klicke auf Schreibe mit AI, um eine Beschreibung basierend auf dem von dir eingerichteten Konnektor und den Tools zu generieren. Du kannst den Vorschlag dann bearbeiten oder auf Verwenden klicken, um ihn einzufügen.

5. Klicke auf Weiter, wenn du fertig bist.

Schritt 5: Nutzerberechtigungen festlegen

Du kannst auswählen, welche Nutzergruppen mit dem Agenten interagieren dürfen. Wenn du dieses Feld leer lässt, nutzt der Agent dieselben Nutzergruppen, die in deinen allgemeinen Einstellungen für den KI-Assistenten konfiguriert sind.

1. Klicke auf das Dropdown-Menü Gruppen hinzufügen.

2. Suche nach den Nutzergruppen, die Zugriff erhalten sollen, und wähle sie aus.

Schritt 6: Den Agenten aktivieren

Neue Agenten werden im Status Inaktiv erstellt. Um den Agenten für deine Nutzenden freizugeben:

1. Klicke oben auf der Agentenseite auf das Status-Badge Inaktiv

   

2. Wähle Aktiv.

3. Klicke auf Agent erstellen.

Teste deinen Agenten

Um zu überprüfen, ob alles wie erwartet funktioniert, öffne den KI-Assistenten in Flip und sende eine Nachricht, die zum Zweck des Agenten passt. Der Assistent sollte deinen Custom Agent aktivieren und die verbundenen Tools nutzen, um zu antworten.

Verwalte deine Agenten

Auf der Übersichtsseite für Custom Agents kannst du:

• Einen Agenten bearbeiten, um Konnektoren, Anweisungen oder Berechtigungen zu aktualisieren.

• Zwischen Aktiv und Inaktiv wechseln, um die Verfügbarkeit zu steuern, ohne den Agenten zu löschen.

• Einen Agenten löschen, den du nicht mehr benötigst.