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.

Dies funktioniert, wenn das System nicht wissen muss, um welchen einzelnen Nutzer:in es sich handelt, beispielsweise bei der Suche nach unternehmensweitem Wissen oder beim Abruf von Statusberichten.

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 du deinen Connector gespeichert hast, erkennt Flip automatisch die Tools, die der MCP-Server bereitstellt. Standardmäßig sind alle Tools gesperrt, bis du sie ausdrücklich erlaubst.

Sieh dir die Tool-Liste unter Tool-Berechtigungen an.

1. Öffne im Schritt Connectors den Connector, dessen Tools du konfigurieren möchtest. Falls der Agent noch keinen Connector hat, füge über Add connector einen hinzu.
2. Suche unter Tool-Berechtigungen das Tool, das du konfigurieren möchtest.
3. Wähle in der Zeile des Tools Needs approval. Nutzer müssen dann jeden Aufruf dieses Tools bestätigen.

Hinweis: Für jedes Tool gibt es drei Einstellungen: Always allow erlaubt Ask AI, das Tool ohne Rückfrage zu verwenden. Bei Needs approval wird vor jedem Aufruf eine Karte zum Bestätigen der Aktion angezeigt. Blocked macht das Tool für Ask AI nicht verfügbar. Neue Tools sind zunächst auf Blocked gesetzt. Die Tools sind in Read-only tools und Other tools gruppiert. Über das Menü in der Kopfzeile einer Gruppe kannst du die Einstellung für alle Tools dieser Gruppe gleichzeitig ändern.

FAQ

Kann ich die Angaben auf der Bestätigungskarte ändern?

Nein. Die Angaben auf der Karte sind schreibgeschützt. Wähle Deny und stelle deine Anfrage an Ask AI mit den korrigierten Angaben erneut.

Was passiert, wenn ich eine Aktion ablehne?

Die Aktion wird nicht ausgeführt. Ask AI erfährt, dass du sie abgelehnt hast, und die Unterhaltung geht weiter. Du kannst die Anfrage erneut stellen, beispielsweise mit anderen Angaben.

Warum werde ich mehrmals gefragt?

Für jeden Tool-Aufruf ist eine eigene Entscheidung erforderlich. Wenn Ask AI mehrere Aufrufe gleichzeitig ausführen möchte, werden die Karten gestapelt und du beantwortest sie nacheinander. Ask AI fährt fort, sobald du über jede Karte entschieden hast.

Kann ich weiterschreiben, während eine Karte geöffnet ist?

Nein. Das Nachrichtenfeld ist ausgeblendet, bis du Allow oder Deny auswählst.

Was passiert, wenn ich nicht sofort entscheide?

Die Anfrage wartet auf deine Entscheidung. Wenn du später zum Chat zurückkehrst, ist die Karte noch da.

Bedeutet "Allow", dass die Aktion erfolgreich war?

Nein. Allow gibt den Aufruf frei, aber im verbundenen System kann trotzdem ein Fehler auftreten. In diesem Fall erklärt Ask AI das Problem in seiner Antwort oder zeigt eine Fehlermeldung an. Die Bestätigungskarte bestätigt nicht, dass die Aktion erfolgreich war.

Warum sehe ich keine Bestätigungskarte?

Ein Admin muss das Tool auf Needs approval setzen, und die Option muss für deine Organisation aktiviert sein. Ein Tool mit Always allow wird ohne Karte ausgeführt. Ein Tool mit Blocked steht Ask AI nicht zur Verfügung.

Eine Ask-AI-Aktion vor der Ausführung prüfen

Hinweis: Diese Funktion ist noch nicht als für die Produktionsumgebung eingeführt gekennzeichnet. Möglicherweise ist sie für deine Organisation noch nicht verfügbar.

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.