Skip to main content

MCP-Server

Über MCP-Server (Model Context Protocol) kannst du deinem Bot zusätzliche Werkzeuge zur Verfügung stellen, die er während des Gesprächs selbstständig aufrufen kann – z. B. um ein Miro-Board zu erstellen, in Dokumenten zu suchen oder eine Benachrichtigung zu verschicken.


MCP-Server hinzufügen

Es gibt zwei Arten von MCP-Servern:

TypBeschreibung
EngineVorkonfigurierte Server, die direkt von der reflact AI-Engine bereitgestellt werden (Miro, DocSearcher, ntfy). Es muss nur ausgewählt werden, welche Tools der Bot nutzen darf.
ExternEin beliebiger, selbst gehosteter MCP-Server, der über eine eigene Server-URL und optionale Authentifizierung eingebunden wird.

Für jeden MCP-Server legst du fest, welche einzelnen Tools der Bot nutzen darf und ob eine manuelle Bestätigung vor der Ausführung nötig ist.


Miro

Mit dem Miro-MCP-Server kann der Bot Miro-Boards kopieren und aktualisieren – nützlich für Workshops oder Trainings, bei denen jeder Nutzer ein eigenes Board erhalten soll.


DocSearcher

Mit dem DocSearcher-MCP-Server kann der Bot gezielt in den hinterlegten Dokumenten suchen. Über die Auswahl Durchsuchbare Dokumente legst du fest, welche Dokumente dabei berücksichtigt werden.


ntfy

Mit dem ntfy-MCP-Server kann der Bot Push-Benachrichtigungen an ein ntfy.sh-Topic senden – z. B. bei Fehlern, wichtigen Ereignissen oder abgeschlossenen Prozessen. Der Bot entscheidet dabei selbst, wann und an welches Topic er sendet – das musst du ihm in den Instruktionen mitteilen.

Schritt 1: Zufälliges Topic erzeugen

Da ntfy.sh-Topics öffentlich sind (jeder, der den Topic-Namen kennt, kann mitlesen), solltest du kein einfaches Wort wie alerts verwenden, sondern einen zufälligen, schwer zu erratenden Namen. Im Drawer zum Hinzufügen des ntfy-Servers kannst du dir über den Button „Zufälliges Topic vorschlagen" direkt einen solchen Namen generieren und kopieren lassen. Beispiel:

bot-alerts-k3m9-x7q2

Schritt 2: ntfy-MCP-Server im Bot aktivieren

  1. Öffne den Bot im Admin-Bereich → Tab SkillsMCP-Server.
  2. Klicke auf „MCP-Server hinzufügen (Engine)".
  3. Wähle im Feld MCP-Server den Eintrag ntfy aus.
  4. Aktiviere in der Tool-Liste das Tool ntfyPublish (Checkbox).
  5. Aktiviere optional den Schalter „Standardmäßig aktiv", damit der Bot das Tool ohne Zutun nutzen kann.
  6. Klicke auf Speichern.

Schritt 3: Bot mitteilen, wann er senden soll

Da es kein separates Eingabefeld für das Topic gibt, muss der Bot per Systemprompt (Bot-Instruktionen) oder per versteckter Nachricht wissen, wann er das ntfyPublish-Tool nutzen soll und welches Topic er dabei verwenden muss.

Beispiel für die Bot-Instruktionen (Tab AllgemeinKonfiguration → Systemprompt):

Wenn ein Fehler auftritt oder ein wichtiger Prozess abgeschlossen wurde,
sende eine Nachricht über das ntfyPublish-Tool an das Topic "bot-alerts-k3m9-x7q2".
Formuliere die Nachricht kurz und verständlich (max. 1-2 Sätze).

Alternativ per versteckter Nachricht (z. B. als Blockly-Baustein „Versteckte Nachricht"), wenn du das Verhalten nur für einen bestimmten Ablauf triggern willst:

Sende jetzt über ntfyPublish eine Nachricht an das Topic "bot-alerts-k3m9-x7q2"
mit dem Inhalt: "Der Nutzer hat den Prozess XY abgeschlossen."

Schritt 4: Benachrichtigungen empfangen

Damit du die Nachrichten tatsächlich siehst, musst du das Topic abonnieren:

  • Per App (empfohlen): ntfy-App für iOS/Android installieren, „+" antippen, Topic-Namen (bot-alerts-k3m9-x7q2) eintragen, abonnieren.
  • Per Browser (ohne App): Öffne
    https://ntfy.sh/bot-alerts-k3m9-x7q2
    und erlaube Web-Push-Benachrichtigungen.
  • Per Kommandozeile (zum Testen):
    curl -s https://ntfy.sh/bot-alerts-k3m9-x7q2/json

Schritt 5: Testen

Sende dem Bot eine Nachricht, die das im Systemprompt beschriebene Ereignis auslöst (z. B. „Simuliere einen Fehler"), und prüfe, ob die Benachrichtigung in der ntfy-App/Browser ankommt.

info

Sicherheitshinweis: ntfy.sh-Topics sind ohne Zugriffskontrolle öffentlich – jeder mit dem Topic-Namen kann mitlesen und selbst Nachrichten senden. Für sensible Inhalte solltest du einen selbst gehosteten ntfy-Server mit Zugriffsschutz verwenden statt des öffentlichen ntfy.sh.