> For the complete documentation index, see [llms.txt](https://docs.melibo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.melibo.de/mcp-server/funktionsubersicht.md). # Funktionsübersicht Der melibo MCP-Server ist ein Model-Context-Protocol-Server. Er stellt Flow-Builder, Knowledge Hub, Team-Postfach und Insights als 64 kuratierte Tools für AI-Agenten bereit. Die Tools sind aus rohen A *** ### Verbindung Der Server ist ein **Streamable-HTTP-Endpunkt** ohne Session-State und ohne SSE. Jede Anfrage ist unabhängig. | Eigenschaft | Wert | | -------------------- | ------------------------------ | | Endpunkt | `POST /mcp` | | Transport | Streamable HTTP, JSON-Response | | Authorization Server | `melibo.eu.auth0.com` | *** ### Architektur & Sicherheit Der Server ist ein reiner **OAuth-2.1-Resource-Server**: Er signiert nichts, registriert keine Clients und hält keine Secrets. Auth0 ist der alleinige Authorization Server. Der Bearer-Token wird verifiziert und unverändert an die melibo-API weitergereicht. | Schutzmechanismus | Wie er wirkt | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Scope-gated pro Aufruf | Jedes Tool verlangt einen Scope, abgeleitet aus der HTTP-Methode – mit expliziter Override-Liste für folgenreiche Aktionen | | Stateless Streamable HTTP | Kein Session-State, kein SSE. Jede Anfrage an `/mcp` ist unabhängig | | Redigierte Antworten | Denylist-Muster (`apiKey`, `secret`, `token`, `password`, `clientSecret`, `webhookSecret`, `authorization`) werden in beliebiger Verschachtelungstiefe entfernt | | Prompt-Injection-Schutz | Jedes Tool-Ergebnis steckt in einem ``-Tag – API-Antworten sind Daten, keine Anweisungen ans Modell | | Audit-Log ohne Payload | Strukturiertes Log pro Aufruf (Tool, Ergebnis, Client, Scope, Upstream-Status, Dauer) – niemals Token, Argumente oder Response-Body | *** ### Scopes Jeder Aufruf ist an einen Scope gebunden. Die Scopes sind hierarchisch: Ein höherer Scope schließt die niedrigeren ein. `mcp:read` ⊂ `mcp:write` ⊂ `mcp:dangerous` | Scope | Bedeutung | | --------------- | ----------------------------------------------------------------------------------- | | `mcp:read` | Lesende Aufrufe – Suchen, Listen, Anzeigen | | `mcp:write` | Schreibende Aufrufe – Erstellen, Aktualisieren, Umschalten | | `mcp:dangerous` | Folgenreiche Aktionen – Löschen, Aktivieren/Deaktivieren, kundensichtbare Antworten | > **⚠️ Achtung:** Tools mit dem Scope `mcp:dangerous` haben sichtbare oder unumkehrbare Folgen. Prüfe vor dem Aufruf genau, was die Aktion auslöst. *** ### 1. Flow & Agent Builder Diese Kategorie umfasst 23 Tools für Chat-Flows, Actions, Topics, Ordner, Vorlagen und die Konfiguration des AI Agent. | Tool | Scope | Beschreibung | | ---------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `melibo_find_flows` | `read` | Sucht und listet Chat-Flows und Actions. Ohne `id` gefiltert, mit `id` ein Flow inkl. aller Schritte. `engine`: `chat` · `action` · `automation` · `rule` · `all` | | `melibo_save_flow` | `write` | Erstellt oder überschreibt einen Flow vollständig. Flache `steps`-Liste (Array-Index als Referenz) statt interner `flowSteps`/`position`-Struktur. `engine`: `chat` · `action` · `automation` · `rule` | | `melibo_set_flow_status` | `dangerous` | Aktiviert oder deaktiviert einen Flow (nur `id` + `active`), ohne dessen Inhalt neu zu senden | | `melibo_delete_flow` | `dangerous` | Löscht einen Chat-Flow oder eine Action endgültig. `id` (erforderlich) | | `melibo_create_topic` | `write` | Erstellt ein neues Topic: Der AI Agent durchsucht bei einer Anfrage zuerst alle Knowledge Pieces und antwortet bei einem Treffer direkt. Ohne Treffer beantwortet er die Anfrage anhand der Guidelines des Topics | | `melibo_get_topic` | `read` | Zeigt Titel, Beschreibung und Guidelines eines Topics | | `melibo_find_topics` | `read` | Listet Topics über die Knowledge-Hub-Ordnerstruktur (Ersatz, da es kein direktes `GET /topics` gibt) | | `melibo_update_topic` | `write` | Aktualisiert ein Topic. `title` und `guideline` immer beide mitschicken, sonst werden die Guidelines stillschweigend gelöscht | | `melibo_delete_topic` | `dangerous` | Löscht ein oder mehrere Topics (Bulk). `ids` (String-Array, erforderlich) | | `melibo_find_actions` | `read` | Listet die im Flow-Builder verfügbaren Actions (agentische Werkzeuge) | | `melibo_run_action` | `write` | Führt eine einzelne Action zu Testzwecken aus, ohne den Live-Chatbot zu bemühen. Das `arguments`-Objekt wird an die Flow-Variablen durchgereicht | | `melibo_run_agentic_workflow` | `write` | Sendet eine Eingabe an den AI Agent eines Chatbots und liefert die End-to-End-Antwort | | `melibo_validate_triggers` | `read` | Prüft Trigger-Formulierungen vor dem Speichern auf Gültigkeit und Kollisionen | | `melibo_list_folders` | `read` | Listet die Ordnerstruktur. `domain`: `knowledge_hub` · `flows` | | `melibo_create_folder` | `write` | Legt einen neuen Ordner an (Knowledge Hub oder Flows) | | `melibo_delete_folder` | `dangerous` | Löscht einen Ordner endgültig | | `melibo_list_template_categories` | `read` | Listet die Vorlagen-Kategorien inkl. IDs – Voraussetzung für `melibo_list_flow_templates` | | `melibo_list_flow_templates` | `read` | Listet verfügbare Flow-Vorlagen einer Kategorie. `category_id` stammt aus `melibo_list_template_categories` | | `melibo_create_flow_from_template` | `write` | Legt einen oder mehrere Flows anhand von Vorlagen an. Bei ungültiger `template_id` kommt eine klare Fehlermeldung | | `melibo_get_ai_agent_config` | `read` | Zeigt Tonfall, Guidelines und Signatur des AI Agent | | `melibo_update_ai_agent_config` | `write` | Ändert die Konfiguration des AI Agent. Voll-Ersatz – vorher lesen, alle Felder erneut mitschicken | | `melibo_get_global_guidelines` | `read` | Zeigt die globalen Verhaltensregeln des AI Agent über alle Chatbots hinweg | | `melibo_update_global_guidelines` | `write` | Ersetzt die globalen Guidelines vollständig | > **🚫 Wichtig:** `melibo_save_flow`, `melibo_update_topic`, `melibo_update_ai_agent_config` und `melibo_update_global_guidelines` arbeiten als Voll-Ersatz. Lies den aktuellen Stand, bevor du speicherst, und schicke alle Felder erneut mit – sonst gehen nicht mitgesendete Inhalte verloren. *** ### 2. Knowledge Hub Diese Kategorie umfasst sechs Tools für Wissensinhalte und deren Quellen. | Tool | Scope | Beschreibung | | ------------------------------- | ----------- | ------------------------------------------------------------------------------------ | | `melibo_find_knowledge_pieces` | `read` | Sucht und listet Knowledge Pieces. Mit `id` ein einzelner Eintrag | | `melibo_create_knowledge_piece` | `write` | Fügt neuen Inhalt hinzu. `type`: `text` · `website` · `product` | | `melibo_update_knowledge_piece` | `write` | Ändert ein Text Piece (Teil-Update) | | `melibo_delete_knowledge_piece` | `dangerous` | Entfernt ein Knowledge Piece endgültig | | `melibo_toggle_knowledge_piece` | `write` | Schaltet ein Knowledge Piece ein oder aus (reiner Toggle, kippt bei jedem Aufruf) | | `melibo_list_knowledge_sources` | `read` | Listet angebundene Knowledge Sources (Website-Crawl, Product Feed, Zendesk, Shopify) | > **ℹ️ Hinweis:** `melibo_toggle_knowledge_piece` kennt kein Ziel-Zustand. Jeder Aufruf kippt den aktuellen Status – prüfe den Zustand, bevor du das Tool erneut aufrufst. *** ### 3. Inbox & CRM Diese Kategorie umfasst zwölf Tools für Support-Konversationen und Kontakte. | Tool | Scope | Beschreibung | | ---------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `melibo_find_conversations` | `read` | Sucht und listet Support-Konversationen. Mit `id` inkl. Nachrichten | | `melibo_reply_to_conversation` | `dangerous` | Sendet eine E-Mail-Antwort an den Kunden – echte, sichtbare Aktion | | `melibo_add_conversation_note` | `write` | Fügt eine interne, für den Kunden unsichtbare Notiz hinzu | | `melibo_assign_conversation` | `write` | Weist eine Konversation einem User oder Team zu oder entfernt die Zuweisung | | `melibo_get_conversation_summary` | `read` | Liefert die automatisch erstellte AI-Zusammenfassung | | `melibo_set_conversation_category` | `write` | Ordnet eine Konversation einer Kategorie zu | | `melibo_get_inbox_overview` | `read` | Statistik-Übersicht über offene und zugewiesene Konversationen | | `melibo_find_contacts` | `read` | Sucht und listet Kontakte. Mit `id` ein einzelner Kontakt | | `melibo_create_contact` | `write` | Erstellt einen Kontakt (mindestens eine E-Mail-Adresse nötig) | | `melibo_update_contact` | `write` | Aktualisiert einen Kontakt. `email` und `phone` ersetzen die komplette Liste, andere Felder sind Teil-Updates | | `melibo_delete_contact` | `dangerous` | Entfernt einen Kontakt endgültig | | `melibo_get_workspace_config` | `read` | Listet Postfächer, Domains, Organisationen, Automatisierungsregeln, Pipeline-Stufen und Team-Zuweisungsregeln. `resource`: `mailboxes` · `domains` · `organizations` · `rules` · `pipeline_stages` · `team_assignment_rules` | > **⚠️ Achtung:** `melibo_reply_to_conversation` sendet eine echte E-Mail an den Kunden. Die Antwort ist sofort sichtbar und lässt sich nicht zurückholen. > **ℹ️ Hinweis:** `melibo_get_workspace_config` bleibt der schnelle Read-only-Überblick über Automatisierungs- und Team-Zuweisungsregeln. Zum Anlegen, Ändern oder Löschen dieser Regeln sowie der geteilten Inbox-Ansichten nutze die Tools in den Abschnitten 4 bis 6. *** ### 4. Automatisierungsregeln Diese Kategorie umfasst fünf Tools, um Inbox-Automatisierungsregeln vollständig zu verwalten – bisher waren sie nur über `melibo_get_workspace_config` lesbar. | Tool | Scope | Beschreibung | | ---------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `melibo_find_rules` | `read` | Listet alle Automatisierungsregeln, mit `id` eine einzelne. Ausführlicher als `melibo_get_workspace_config` – inkl. Status, verknüpftem Flow und Typ (`custom`/`system`) | | `melibo_create_rule` | `write` | Legt eine neue Regel an. `name` (erforderlich), `description` optional | | `melibo_update_rule` | `write` | Ändert eine Regel (Teil-Update). Felder: `name`, `description`, `status` (`active`/`inactive`) | | `melibo_delete_rule` | `dangerous` | Löscht eine Regel endgültig. `id` (erforderlich) | | `melibo_reorder_rules` | `write` | Setzt die Ausführungsreihenfolge neu. `rule_ids` als komplette Liste in gewünschter Reihenfolge | *** ### 5. Team-Zuweisungsregeln Diese Kategorie umfasst sechs Tools für Regeln, die eingehende Konversationen automatisch einem Team zuweisen. | Tool | Scope | Beschreibung | | ---------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `melibo_find_team_assignment_rules` | `read` | Listet alle Team-Zuweisungsregeln inkl. Bedingungen und Verknüpfungslogik. Kein Einzelabruf – die API bietet das nicht | | `melibo_find_team_assignment_rule_condition_options` | `read` | Schlägt gültige Werte für ein Bedingungsfeld vor (z. B. vorhandene E-Mail-Domains), bevor du eine Regel baust. `source`: `person` · `organization` · `mailbox`, dazu `field` | | `melibo_create_team_assignment_rule` | `write` | Legt eine neue Regel an. `name`, `team_id`, `combinator` (`AND`/`OR`) und `conditions` (alle erforderlich). `conditions` ist eine flache Liste aus einzelnen Bedingungen und/oder Gruppen – Gruppen dürfen keine weiteren Gruppen enthalten | | `melibo_update_team_assignment_rule` | `write` | Ändert eine Regel (Teil-Update). Nur `id` erforderlich | | `melibo_delete_team_assignment_rule` | `dangerous` | Löscht eine Regel endgültig. `id` (erforderlich) | | `melibo_reorder_team_assignment_rules` | `write` | Setzt die Auswertungsreihenfolge neu. `rule_ids` als komplette Liste in gewünschter Reihenfolge | *** ### 6. Geteilte Inbox-Ansichten Diese Kategorie umfasst sechs Tools für team-geteilte Inbox-Ansichten (gespeicherte Filter-Presets). | Tool | Scope | Beschreibung | | ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `melibo_find_inbox_views` | `read` | Listet die Ansichten eines Teams inkl. aktueller Ticket-Zahlen. `team_id` (erforderlich) | | `melibo_get_inbox_view_counts` | `read` | Liefert die Ticket-Zahlen der Ansichten aller Teams, auf die du Zugriff hast | | `melibo_create_inbox_view` | `write` | Legt eine neue geteilte Ansicht an. `name`, `team_id`, `filters` (erforderlich), `group_by`: `priority` · `topic` · `none` (Standard: `priority`) | | `melibo_update_inbox_view` | `write` | Ändert Name, Filter oder Gruppierung einer Ansicht (Teil-Update). Nur `id` erforderlich | | `melibo_delete_inbox_view` | `dangerous` | Löscht eine geteilte Ansicht endgültig. `id` (erforderlich) | | `melibo_reorder_inbox_view` | `write` | Verschiebt eine einzelne Ansicht an eine neue Position (`position`, 0-basiert). Anders als bei den anderen Reorder-Tools wird nicht die komplette Liste neu sortiert | *** ### 7. Analytics & Testing Diese Kategorie umfasst sechs Tools für Insights, Ziele, Feedback und Testsessions. | Tool | Scope | Beschreibung | | --------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `melibo_get_metric_total` | `read` | Kennzahl als Gesamtwert. `metric`: `automation_rate` · `ai_handle_rate` · `conversations` · `ratings` · `not_understood_messages` · `recognition_rate` · `unique_users` · `human_handover_rate` | | `melibo_get_metric_chart` | `read` | Kennzahl als Zeitreihe. `metric`: `automation_rate` · `conversations` | | `melibo_get_goals` | `read` | Listet Conversion-Ziele inkl. Tags. Erforderlich: `start_date`, `end_date` (ISO-Datum). `with_chart` optional für den Zeitverlauf | | `melibo_get_feedback` | `read` | Listet das Feedback der Endnutzer. Erforderlich: `start_date`, `end_date` (ISO-Datum) | | `melibo_export_insights` | `read` | Stößt den Export der Insights-Daten eines Zeitraums an. Liefert keine Nutzdaten inline – der Versand erfolgt vermutlich asynchron (z. B. per E-Mail) | | `melibo_find_test_sessions` | `read` | Sucht Testsessions nach Zeitraum, Topic oder Bewertung. Ohne `start_date`/`end_date` werden automatisch die letzten 30 Tage verwendet. Mit `id` der volle Nachrichtenverlauf | > **⚠️ Achtung:** `melibo_get_goals` und `melibo_get_feedback` verlangen jetzt zwingend `start_date` und `end_date` (ISO-Datum). Aufrufe ohne Zeitraum schlagen fehl. *** ### Nächste Schritte Jetzt, wo du die Tools des MCP-Servers kennst, kannst du: * Deinen MCP-Client mit einem passenden Scope verbinden und die Read-Tools testen * Vor jedem Voll-Ersatz-Tool den aktuellen Stand mit dem passenden `get`- oder `find`-Tool auslesen * Verbinde hier: *** *Zuletzt aktualisiert: September 2026* --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.melibo.de/mcp-server/funktionsubersicht.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.