Aktionen

Legen Sie fest, was Ihr KI‑Agent während eines Gesprächs tun kann: von Antworten mit Echtzeit‑API‑Daten über Lead‑Erfassung bis hin zu individuellen Aufgaben.

Übergabe an einen Menschen (Human Handoff)

Die Funktion Human Handoff sorgt dafür, dass Gespräche, die menschliche Aufmerksamkeit benötigen, nahtlos an einen menschlichen Agenten übergeben werden.

Sie ist besonders hilfreich bei Fragen außerhalb der Wissensdatenbank oder wenn Nutzer ausdrücklich mit einer Person sprechen möchten. Während der Übergabe pausiert der KI‑Assistent und der menschliche Agent übernimmt die Unterhaltung im Posteingang (Inbox).

So sieht es für Nutzer aus:

1. Der Nutzer interagiert mit dem KI‑Assistenten.
2. Liegt die Anfrage außerhalb der Möglichkeiten der KI oder wünscht der Nutzer einen Menschen, informiert die KI über die Übergabe.
3. Das Gespräch wird vom KI‑Agenten gelöst und einem menschlichen Agenten zugewiesen.
4. Der menschliche Agent löst das Anliegen oder weist zurück an die KI.

Und so in der Quickchat‑Oberfläche:

1. Das nicht zugewiesene Gespräch erscheint im Posteingang.
2. Ihr Teammitglied liest die KI‑Zusammenfassung.
3. Es übernimmt und bearbeitet die Anfrage.
4. Danach wird abgeschlossen oder zurückübergeben.

Human Handoff aktivieren

Navigieren Sie zu Capabilities > Human Handoff und schalten Sie den Regler auf „on“.

Konfigurierbare Optionen:

Verfügbarkeit menschlicher Agenten

Stellen Sie sicher, dass Übergaben nur während der Geschäftszeiten erfolgen.

• Arbeitszeiten: Start/Ende und Wochentage
• Zeitzone: passende Zone wählen
• Außerhalb‑der‑Zeiten‑Nachricht

Frage

Definieren Sie die Frage, die die KI vor der Übergabe stellt.

Beispiel: Möchten Sie, dass ich Sie mit unserem Support‑Team verbinde?

Bestätigung

Legen Sie die Bestätigungsnachricht fest, wenn die Übergabe gestartet wird.

Beispiel: Verstanden. Ich verbinde Sie mit unserem Support‑Team. Einen Moment bitte.

KI‑Zusammenfassung

Aktivieren Sie KI‑Zusammenfassungen, um automatisch eine kurze Zusammenfassung des bisherigen Gesprächs zu erstellen.

Übergaberegeln

Beschreiben Sie die Situationen, in denen Human Handoff ausgelöst werden soll. Jede Regel hat einen Regelnamen, eine verständliche Beschreibung und einen Zustand-Schalter. Damit können Sie Regeln aktivieren oder deaktivieren, ohne sie zu löschen.

Quickchat AI enthält standardmäßig Regeln für die häufigsten Auslöser einer Übergabe:

• Mediennachricht: Der Nutzer hat ein Bild, eine Datei oder ein anderes Medium gesendet, das die KI nicht verarbeiten kann.
• Frustration des Nutzers: Der Nutzer ist ausdrücklich verärgert, frustriert oder unzufrieden.
• Vorschlag, den Kundensupport zu kontaktieren: Der AI Agent hat dem Nutzer empfohlen, als nächsten Schritt den Kundensupport zu kontaktieren, oder die KI-basierte Unterstützung eindeutig beendet.
• Fehlendes Wissen: Der AI Agent hat bestätigt, dass ihm die erforderlichen Informationen fehlen.
• Unpassender Rat: Der AI Agent hat wiederholt versucht zu helfen, aber der Nutzer ist weiterhin nicht zufrieden.

Sie können jede dieser Regeln aktivieren oder deaktivieren und eigene Regeln mit einem individuellen Regelnamen und einer Beschreibung hinzufügen, die der KI erklärt, wann die Übergabe ausgelöst werden soll.

Tipp

Formulieren Sie Regelbeschreibungen als Anweisungen an die KI. „Der Nutzer hat ausdrücklich eine Rückerstattung von mehr als $100 verlangt“ ist überprüfbar; „VIPs eskalieren“ ist es nicht (die KI kann nur wissen, wer ein VIP ist, wenn diese Information in den Unterhaltungsmetadaten steht).

Zusätzlich zu den Regeln können Sie Stichwörter angeben, die unabhängig vom Kontext immer einen Human Handoff erzwingen. Das ist nützlich für Compliance-Begriffe wie „Klage“, „DSGVO“ oder „Rückbuchung“, die die KI nie bearbeiten soll.

Themenbasiertes Routing

Wenn Human Handoff ausgelöst wird, leitet Themenbasiertes Routing die Unterhaltung an den Human Agent weiter, der für dieses Thema am besten geeignet ist. So bleibt sie nicht ohne Zuweisung in einer gemeinsamen Warteschlange.

Konfigurieren Sie das Routing, indem Sie jedes Thema (definiert unter Insights → Themen verwalten) einem oder mehreren Teammitgliedern zuordnen. Wenn eine Übergabe ausgelöst wird, liest Quickchat das erkannte Thema der Unterhaltung und leitet sie an einen der diesem Thema zugewiesenen Agents weiter. Wenn keine Regel passt, bleibt die Unterhaltung ohne Zuweisung, sodass sie jedes Teammitglied im Posteingang übernehmen kann.

E‑Mail‑Benachrichtigungen

Hinterlegen Sie E‑Mail‑Adressen, die benachrichtigt werden, wenn eine Übergabe erforderlich ist.

---

Intelligente Datenerfassung / Lead‑Generierung

Die intelligente Datenerfassung ermöglicht es Ihrem KI‑Agenten, Nutzerdaten nahtlos im Gespräch zu sammeln (z. B. Name, E‑Mail, Telefon). Diese Daten können an Ihr CRM oder andere Systeme übertragen werden.

Funktionsweise

Die Erfassung geschieht natürlich im Gesprächsfluss.

Wenn ein Nutzer interagiert, dann:

1. erkennt die KI Erfassungsgelegenheiten (z. B. geäußertes Interesse),
2. stellt gezielte Fragen, etwa:
   • „Wie ist Ihr Name, damit ich Sie besser unterstützen kann?“
   • „Unter welcher E‑Mail erreichen wir Sie am besten?“
3. speichert die Antworten zur Einsicht oder CRM‑Übergabe.

Einrichtung

Intelligente Datenerfassung aktivieren

• Gehen Sie zu Actions & MCPs
• Öffnen Sie Smart Data Gathering
• Schalten Sie die Funktion ein

Zu erfassende Daten

Wählen Sie zu erfassende Kontaktdaten aus.

• E‑Mail‑Adresse
• Vorname
• Telefonnummer

Wann fragen

Legen Sie fest, wann die KI nach Kontaktdaten fragt.

• Nach einigen Nachrichten
• Direkt nach geäußertem Interesse

Wie fragen

Passen Sie die Fragestellung an.

• Subtil: natürlich in den Dialog eingebettet
• Direkt: explizite und klare Anfrage

Die smarte Lead‑Generierung sammelt effizient Kontaktdaten und sorgt für eine reibungslose Experience.

Erfasste Daten exportieren

So exportieren Sie die Daten:

1. Öffnen Sie die Inbox
2. Klicken Sie auf das Export‑Symbol
3. Wählen Sie Export Gathered Data
4. Legen Sie Datumsbereich fest
5. Wählen Sie Format (CSV, XLSX)
6. Klicken Sie Download

---

Individuelle Aktionen

Mit individuellen Aktionen kann Ihre KI externe APIs während des Gesprächs aufrufen. Nutzen Sie sie, um interne Tools zu durchsuchen, Tickets zu erstellen, Alerts auszulösen oder frische Daten zu holen, die nicht in der Wissensdatenbank stehen. Sie finden sie unter Actions & MCPs → Custom Actions.

So funktionieren individuelle Aktionen

1. Wählen Sie einen Aktionstyp: API-Aktion, MCP, HubSpot-Aktion, Discord-Aktion, Google Sheets oder Shopify MCP. Konfigurieren Sie die Verbindung und die Anweisungen, die die AI benötigt.
2. Während eines Chats entscheidet die KI anhand der Aktionsbeschreibung und der verfügbaren Tool- oder Parameterdetails, wann sie die Aktion ausführt.
3. Quickchat führt den Aufruf aus und gibt das Ergebnis an die KI zurück. Die KI liest die Antwort und antwortet dem Nutzer in natürlicher Sprache.
4. Testen oder verbinden Sie die Aktion in ihrem Editor, bevor Sie sie in Gesprächen verwenden.

Tipp

Schreiben Sie die Beschreibung als Anweisung an die KI: wann nutzen, was kommt zurück, welche Leitplanken gelten.

API‑Aktion erstellen

1. Gehen Sie zu Actions & MCPs.
2. Klicken Sie bei Custom Actions auf + und wählen API Action.
3. Füllen Sie Details:
   • Name: klar und prägnant
   • Description: wann nutzen, was in Parameter
4. Konfigurieren Sie Connection:
   • Action Type: GET oder POST
   • Action endpoint URL: vollständige API‑URL
   • Headers: erforderliche Headers (Authorization, content-type: application/json, …)
5. Definieren Sie Parameters: je Parameter name, location (query, body oder header) und description mit Hinweisen zur Wertbildung für die KI. Pfadwerte sind keine Parameter‑Location; fügen Sie sie direkt per {{platzhalter}}‑Templating in die Endpoint‑URL ein.
6. Test request, Antwort prüfen, Done.

Tipp

Jedes Wertefeld (URL, Header, Body oder Query) akzeptiert dynamische Platzhalter über die Schaltfläche + Add AI Data. Sie können Ihre KI‑Parameter, eingebaute Konversationsvariablen ({{scenario_id}}, {{language}}, {{country}}, …) und Konversations‑Metadaten ({{metadata_*}}) einfügen. Die vollständige Referenz finden Sie unter KI‑Aktions‑Variablen.

Über die Anfrage selbst hinaus hat eine API‑Aktion drei optionale Einstellungen, die man kennen sollte: Save to memory, Run only when und Response filter.

Discord-Aktionen

Discord-Aktion öffnet eine Galerie mit vorausgefüllten, bearbeitbaren API-Actions:

• Support & Tickets: Bei Support-Ticket öffnen wählen Sie einen Server und einen Text-Channel aus. Optional können Sie eine mentionable Support-Rolle auswählen. Das Template erstellt drei Actions, die einen privaten Thread öffnen, den aktuellen Anfragenden hinzufügen und eine Zusammenfassung mit der optionalen Erwähnung der Rolle posten.
• Moderation: Mitglied timeouten, Mitglied kicken, Mitglied bannen, Bann aufheben, Rolle zuweisen, Slowmode festlegen und Ankündigung senden. Jedes Template wird mit einem Klick installiert und verwendet den Server, das Mitglied, die Rolle oder den Channel aus der aktuellen Discord-Anfrage.

Quickchat erstellt HTTP-Methode, URL, Header, Body, Parameter, Beschreibung, Response-Einstellungen und die Bedingungen unter Nur ausführen, wenn im Backend. Die resultierenden Karten sind gewöhnliche HTTP-Request-Actions. Sie können jedes Feld einsehen und bearbeiten.

Alle sieben Moderationstemplates enthalten unter Nur ausführen, wenn die Bedingung author_is_admin is true. Discord berechnet die Administrator-Berechtigung des aktuellen Absenders, das Discord-Gateway liefert diesen Wert und Quickchat prüft ihn vor dem Senden des Requests. Metadaten aus dem öffentlichen Chat oder der API können diesen Key nicht setzen. Testen Sie Moderationsaktionen in Discord sowohl mit einem Administrator- als auch mit einem Nicht-Administrator-Konto. AI Preview stellt keinen autorisierten Discord-Absender bereit.

Achtung

Die Moderationsaktionen sind bearbeitbar. Wenn Sie die Bedingung author_is_admin is true entfernen oder abschwächen, entfällt die mitgelieferte Autorisierungsgrenze. Kick und Bann verlangen vor der Ausführung keine Bestätigung.

Der Bot selbst benötigt weiterhin die für jeden Request erforderliche Discord-Berechtigung:

Aktion	Bot-Berechtigung oder Zugriff
Mitglied timeouten	Moderate Members
Mitglied kicken	Kick Members
Mitglied bannen, Bann aufheben	Ban Members
Rolle zuweisen	Manage Roles
Slowmode festlegen	Manage Channels
Ankündigung senden	View Channels und Send Messages

Discord erzwingt außerdem die Rollenhierarchie. Platzieren Sie die Rolle des Bots über den Mitgliedern und Rollen, die er verwalten soll. Das Template führt keine zusätzliche Hierarchieprüfung oder Prüfung einzelner Berechtigungen für den anfragenden Administrator durch.

Slowmode festlegen und Ankündigung senden akzeptieren eine Channel-ID als Parameter. Ohne ein zusätzliches festes Ziel prüft das Template nicht, ob der Channel zu dem Server gehört, auf dem der Administrator den Request gesendet hat. Wenn derselbe Bot mehreren Servern angehört, bearbeiten Sie diese Actions so, dass sie eine feste Channel-ID verwenden, oder trennen Sie die Server durch unterschiedliche Agents und Bot-Zugangsdaten.

Die Support-Ticket-Installation verwendet vorhandene Action-Funktionen zur Datenübergabe:

1. open_support_ticket erstellt einen privaten Thread im ausgewählten Channel, erfasst $.id und speichert den Wert im Konversations-Memory als discord_ticket_thread_id. Die Action erfordert die sichtbare Bedingung discord_message is true, läuft nur im ausgewählten Server und nur, solange dieser Memory-Key nicht vorhanden ist.
2. add_ticket_requester liest {{metadata_discord_ticket_thread_id}} und die von Discord bereitgestellte Variable {{metadata_discord_author_id}}. Die Action erfordert die sichtbare Bedingung discord_message is true und läuft nur im ausgewählten Server, nachdem die Thread-ID vorhanden ist.
3. post_in_ticket liest dieselbe gespeicherte Thread-ID, postet die vom Agenten erstellte einzeilige Zusammenfassung des Problems und erwähnt den Anfragenden. Wenn Sie eine Support-Rolle ausgewählt haben, wird auch diese Rolle erwähnt. Für die Action gelten dieselben sichtbaren Bedingungen für Discord-Nachricht, Server und gespeicherten Thread. Der Discord-Body allowed_mentions ist auf den Anfragenden und, sofern konfiguriert, diese Rolle begrenzt.

Die Beschreibungen und Ihr Agent-Prompt sollten den Agenten anweisen, diese Actions in dieser Reihenfolge auszuführen. Es gibt keine separate Ebene für Workflow-Status, Sperren, Bestätigungen, Wiederholungen, Wiederherstellung, Abgleich oder Replay-Schutz. Wenn ein Ergebnis unklar ist, prüfen Sie Discord und das Action-Log vor einem erneuten Versuch, da Discord den Request möglicherweise bereits ausgeführt hat.

discord_ticket_thread_id wird nicht automatisch gelöscht. Die Vorlage unterstützt daher ein Ticket pro Quickchat-Konversation. Starten Sie für ein weiteres Ticket eine neue Discord-Konversation oder einen neuen Thread, oder bearbeiten Sie die Actions und ergänzen Sie den benötigten Memory-Lebenszyklus.

Gewähren Sie dem Bot für Support-Tickets im ausgewählten Ticket-Channel View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads und Manage Threads. Lassen Sie Rolle benachrichtigen (optional) auf Keine Rolle benachrichtigen, wenn keine Rolle erwähnt werden soll. Wenn Sie eine Rolle auswählen, muss sie mentionable sein und ihre Mitglieder benötigen Zugriff auf die privaten Threads. Wenn Sie keine Rolle auswählen oder keine mentionable Rollen verfügbar sind, werden Tickets dennoch normal geöffnet, ohne eine Rolle zu benachrichtigen. Die Galerie listet Text-Channels und mentionable Rollen auf, prüft aber nicht alle Berechtigungsüberschreibungen des Channels.

Achtung

Discord-Aktionen benötigen den Token aus Ihrer eigenen Discord-App unter Externe Apps → Discord → Erweitertes Setup. Der gemeinsame One-Click-Bot allein kann diesen Token nicht bereitstellen. Siehe Discord.

Die Galerie ist eine Abkürzung für die Einrichtung und keine zusätzliche Policy-Ebene. Wenn Sie eine generierte Action bearbeiten oder eine individuelle Discord API Action erstellen, prüfen Sie vor der Aktivierung ihre Zugangsdaten, Ziele, Parameter, Response-Offenlegung und Bedingungen unter Nur ausführen, wenn.

Save to memory

Erfassen Sie einen Wert aus der API‑Antwort und speichern Sie ihn im Gedächtnis der Konversation unter einem von Ihnen gewählten Schlüssel. Spätere Aktionen können ihn als {{metadata_<key>}} wiederverwenden, und er erscheint in den Konversationsdetails (Posteingang, API und Exporte).

Greifen Sie dazu, wenn eine Aktion etwas erzeugt, das eine spätere Aktion benötigt. Eine Lookup‑Aktion kann eine customer_id aus ihrer Antwort speichern; eine nachfolgende Aktion sendet dann {{metadata_customer_id}}, ohne dass die KI den Wert übertragen muss.

Geben Sie im Abschnitt Save to memory des API‑Aktions‑Editors dem erfassten Wert einen memory key und verweisen Sie auf den Teil der Antwort, den Sie behalten möchten. Von da an ist es eine Metadaten‑Variable wie jede andere.

Tipp

Verwenden Sie snake_case‑Schlüssel (Buchstaben, Ziffern, Unterstriche). Ein Schlüssel wie customer_id ist als {{metadata_customer_id}} referenzierbar; Schlüssel mit Leerzeichen oder anderer Interpunktion können nicht in Platzhaltern verwendet werden. Wie Metadaten‑Variablen funktionieren, erfahren Sie unter Konversations‑Metadaten.

Run only when

Beschränken Sie eine Aktion so, dass sie nur ausgeführt wird, wenn Bedingungen auf den Konversations‑Metadaten erfüllt sind. Die Bedingungen werden auf unserer Seite, zum Aufrufzeitpunkt geprüft, nachdem die KI entschieden hat, die Aktion aufzurufen, aber bevor eine Anfrage gesendet wird. Sie lassen sich daher nicht aus dem Chat heraus umgehen.

Dies ist das richtige Werkzeug für privilegierte oder unumkehrbare Aktionen (ein Mitglied sperren, eine Rückerstattung ausstellen, einen Datensatz löschen). Eine Zeile in Ihrem Prompt, die besagt „nur Admins dürfen das”, ist eine hilfreiche Anweisung, aber keine Sicherheitsgrenze: Ein entschlossener Nutzer kann mit dem Modell argumentieren oder eine Prompt‑Injection versuchen. Eine Ausführungsbedingung ist deterministisch und lebt außerhalb des Prompts, also gilt sie unabhängig davon, was im Gespräch gesagt wird.

• Die Ausführungsbedingung ist die Grenze. Sie wird serverseitig ausgewertet und ist nicht Teil des Prompts, den das Modell liest. Genau das verhindert tatsächlich die Ausführung der Aktion.
• Die Prompt‑Regel ist die Nutzererfahrung. Behalten Sie trotzdem eine Zeile in Ihrem Prompt, damit die KI höflich ablehnt und den Grund erklärt, statt einfach zu verstummen.

Fügen Sie Bedingungen im Abschnitt Run only when des Aktions‑Editors hinzu. Klicken Sie auf Add condition, wählen Sie einen Metadaten‑Schlüssel (zum Beispiel telegram_sender_is_admin) und legen Sie fest, wie verglichen werden soll:

Bedingung	Erfüllt, wenn der Metadaten‑Wert…
is true	wahrheitswertig (truthy) ist
is false	falschwertig (falsy) ist
exists	in der Konversation vorhanden ist
does not exist	fehlt
equals	einem von Ihnen angegebenen Wert entspricht
does not equal	von einem von Ihnen angegebenen Wert abweicht

Die Aktion wird nur ausgeführt, wenn jede Bedingung erfüllt ist. Eine Bedingung auf einen Schlüssel, der in der Konversation nicht gesetzt ist, ist nicht erfüllt.

Wenn eine Bedingung nicht erfüllt ist, wird keine Anfrage gesendet und die KI teilt dem Nutzer mit, dass sie das nicht tun kann. Unten wird dieselbe Sperranfrage für einen Nicht‑Admin blockiert und für einen Admin zugelassen, wobei sich nichts ändert außer der Person, die fragt:

Achtung

Knüpfen Sie Bedingungen nur an Metadaten, die Quickchat setzt (etwa ein kanalverifiziertes telegram_sender_is_admin‑Flag), nicht an Werte, die der Besucher beeinflussen kann. Woher jeder Schlüssel stammt, erfahren Sie unter Konversations‑Metadaten.

Response filter

Standardmäßig sieht die KI die vollständige API‑Antwort. Fügen Sie JSONPath‑Ausdrücke im Abschnitt Response filter hinzu, um die KI auf bestimmte Teile davon zu beschränken.

Zwei häufige Gründe zum Filtern:

• Sensible Felder ausblenden. Halten Sie Kunden‑E‑Mails, Zahlungsdaten oder interne IDs aus dem Kontext des Modells heraus, wenn der Endpoint mehr zurückgibt, als die KI benötigt.
• Den Prompt verkleinern. Gesprächige APIs können große Payloads zurückgeben; das Filtern auf die wenigen relevanten Felder hält die Antwort klein und die KI fokussiert.

Fügen Sie einen oder mehrere JSONPath‑Ausdrücke hinzu, und die KI erhält nur die übereinstimmenden Teile. Beispielsweise behält $.data.items[*].name nur die Artikelnamen aus einer größeren Antwort.

Tipp

Nutzen Sie das Test Response‑Panel, um vor dem Verlassen darauf genau zu sehen, was die KI nach dem Filtern erhält. Siehe Ihre Aktion testen.

Achtung

Ein JSONPath, der nichts findet, lässt die KI mit einer leeren Antwort zurück. Beginnen Sie ohne Filter, bestätigen Sie, dass der Aufruf funktioniert, und verengen Sie ihn dann.

Best Practices

• Explizit beschreiben: wann verwenden, wie Parameter zu befüllen sind.
• Scopes minimal halten: nur benötigte Header/Tokens aufnehmen.
• Vor Rollout testen: Statuscodes und Payloads prüfen.

Tutorials

• Jira‑Tickets in der Unterhaltung suchen
• Slack‑Benachrichtigung mit einer KI‑Aktion senden

MCP-Aktionen

MCP (Model Context Protocol) ist ein offener Standard, mit dem eine KI die Tools eines anderen Dienstes direkt nutzen kann. Statt dass Sie einen Endpoint und seine Parameter von Hand beschreiben, veröffentlicht ein MCP-Server seine eigenen Tools, und Ihr KI-Agent findet und verwendet sie.

Bei den meisten Diensten genügt dafür ein einziger Klick. Gehen Sie zu Aktionen & MCPs, klicken Sie auf + Aktion hinzufügen und wählen Sie MCP.

Aus dem Katalog verbinden

Der MCP-Bildschirm öffnet sich mit einem durchsuchbaren Katalog bekannter Dienste, gruppiert nach Kategorie (Beliebt, Kundensupport, CRM & Vertrieb, Terminplanung, E-Commerce, Zahlungen & Abrechnung, Marketing & E-Mail, Kommunikation, Produktivität, Daten & Analytics, Suche & Web, Reisen & Buchung, Design, Entwickler & Infra).

1. Suchen Sie den gewünschten Dienst, indem Sie den Katalog durchsehen oder das Suchfeld verwenden.
2. Klicken Sie auf die Kachel. Quickchat prüft den Server und ermittelt die Tools, die er anbietet.
3. Wenn Sie sich bei dem Dienst anmelden müssen, erscheint der Bereich Autorisierung erforderlich. Klicken Sie auf Mit <Dienst> verbinden, bestätigen Sie den Zugriff im Popup-Fenster, das sich öffnet, und der Bereich wechselt in den verbundenen Zustand.
4. Die Aktion wird erstellt und aktiviert, ihre Tools werden aufgelistet. Ihr KI-Agent kann sie ab der nächsten Nachricht nutzen.

Hinweis

Wenn Sie das Popup-Fenster schließen, ohne den Zugriff zu bestätigen, wird keine Verbindung gespeichert und die Aktion verworfen.

Tipp

Ihr Browser muss Popups für das Quickchat-Dashboard zulassen, sonst kann sich das Autorisierungsfenster nicht öffnen. Ist es blockiert, erhalten Sie eine Meldung mit der Bitte, Popups zuzulassen und es erneut zu versuchen.

Einen Server verbinden, der nicht im Katalog steht

Klicken Sie unterhalb des Katalogs auf URL manuell eingeben und gehen Sie dann so vor:

1. Fügen Sie die MCP-Server-URL ein (sie muss mit https:// beginnen).
2. Authentifiziert sich der Server über ein statisches Token statt über eine Anmeldung, öffnen Sie Verbindungs-Header (optional) und ergänzen Sie den erwarteten Header, zum Beispiel Authorization: Bearer <your-token>.
3. Klicken Sie auf Verbinden.

Über Katalog durchsuchen kehren Sie zur Kachelansicht zurück. Fehlt ein Dienst, den Sie brauchen, öffnet Fehlt eine Integration? Schlage eine vor eine vorausgefüllte E-Mail an unser Team.

Auswählen, welche Tools die KI nutzen darf

Nach dem Verbinden listet die Aktion jedes Tool auf, das der Server bereitstellt, jeweils mit eigenem Schalter. Schalten Sie alles ab, was die KI nicht aufrufen soll: Bei einem Buchungsserver können die rein lesenden Abfragen aktiv bleiben, während das Tool zum Stornieren ausgeschaltet bleibt.

Standardmäßige Tool-Aktivierung legt fest, was passiert, wenn der Server später ein neues Tool ergänzt: eingeschaltet sind neue Tools sofort verfügbar, ausgeschaltet aktivieren Sie jedes einzeln und bewusst.

Tipp

Füllen Sie MCP-Aktionsname und MCP-Aktionsbeschreibung klar und eindeutig aus. Die Beschreibung sagt der KI, wann sie überhaupt auf diesen Server zurückgreifen soll. Eine spezifische Angabe („für alle Linear-Projektabfragen verwenden“) funktioniert daher besser als eine allgemeine.

Was Besucher sehen

Während ein Tool läuft, zeigt das Chat-Widget eine kurze Statuszeile, die beschreibt, was die KI gerade tut, abgeleitet aus dem Namen des Tools: Ein Tool namens search_flights zeigt „Searching flights…“. So sieht der Besucher während der Wartezeit etwas Sinnvolles statt nur eines Tippindikators. Die Statuszeile wird automatisch erzeugt, Sie müssen nichts konfigurieren.

Erneut verbinden und trennen

• Erneut verbinden: startet die Autorisierung erneut. Nutzen Sie dies, wenn die Verbindung abgelaufen ist, wenn Sie ein anderes Konto autorisieren möchten oder wenn sich die Tool-Liste des Servers geändert hat und Sie die neuen Tools übernehmen wollen.
• Trennen: widerruft die gespeicherte Autorisierung und nimmt die Aktion offline. Die Aktion selbst bleibt in Ihrer Liste, sodass Sie sie später wieder verbinden können, ohne sie neu einzurichten.

Wenn Sie die MCP-Server-URL einer verbundenen Aktion ändern, wird deren Autorisierung gelöscht und die Aktion ausgeschaltet, denn Zugangsdaten eines Servers werden nie bei einem anderen wiederverwendet. Autorisieren Sie erneut, um die Aktion wieder online zu bringen.

Fehlerbehebung

Was Sie sehen	Was es bedeutet
Autorisierung fehlgeschlagen	Die Anmeldung wurde nicht abgeschlossen. Versuchen Sie es mit Erneut verbinden. Wurde das Popup-Fenster zu früh geschlossen, wurde nichts gespeichert.
Verbunden, aber das Laden der Tools ist fehlgeschlagen	Die Autorisierung war erfolgreich, aber die Tool-Liste wurde nicht geladen. Klicken Sie auf Erneut verbinden.
Auf diesem Server wurden keine Tools gefunden. Versuche, die Verbindung neu herzustellen.	Der Server hat die Autorisierung erteilt, aber keine Tools veröffentlicht. Prüfen Sie, ob das freigegebene Konto Zugriff auf die erwarteten Daten hat.
Gib eine gültige URL ein, die mit https:// beginnt	Die URL konnte nicht gelesen werden. Verwenden Sie die vollständige https://-Adresse des Servers. Quickchat verbindet sich immer über https, damit Zugangsdaten nie unverschlüsselt übertragen werden.
Die Aktion hat sich selbst ausgeschaltet	Ihre Autorisierung ist abgelaufen oder wurde beim Anbieter widerrufen. Öffnen Sie die Aktion und klicken Sie auf Erneut verbinden.

Hinweis

MCP-Aktionen zählen wie API-Aktionen auf das Kontingent für individuelle Aktionen Ihres Tarifs.