MCP-Server mit Ihrem Bot verbinden #

Mit MCP-Servern kann Ihr KI-Bot während Live-Unterhaltungen Tools aus anderen Systemen nutzen – ohne dass Sie jedes Tool von Hand erstellen müssen. Sie verweisen den Bot einmal auf einen MCP-Server, und jedes Tool, das dieser Server anbietet, steht dem Bot automatisch zur Verfügung.

Wenn Sie bereits benutzerdefinierte Funktionen (Custom Functions) verwendet haben, ist dies das gleiche Prinzip, nur einen Schritt weiter gedacht: Eine benutzerdefinierte Funktion ist ein einzelnes Tool, das Sie selbst einrichten, während ein MCP-Server ein fertiges Bündel von Tools ist, die der Bot selbstständig entdecken und aufrufen kann.

Was ist ein MCP-Server? #

MCP (Model Context Protocol) ist ein offener Standard, um KI-Assistenten Zugriff auf externe Tools zu geben. Viele moderne Apps und Dienste veröffentlichen mittlerweile einen „MCP-Server“ – eine einzelne Webadresse, die eine Reihe von Tools bereitstellt, die die KI aufrufen kann: etwas nachschlagen, einen Datensatz abrufen, eine Abfrage ausführen, ein Element erstellen.

Anstatt jedes Tool einzeln für den Bot zu beschreiben, geben Sie Your AI Connector die Serveradresse und einen Zugriffsschlüssel. Your AI Connector fragt den Server „Was kannst du tun?“, erhält die Liste der Tools zurück und stellt sie Ihrem Bot zur Verfügung. Wenn der Server ein neues Tool hinzufügt, kann Ihr Bot es ohne zusätzlichen Einrichtungsaufwand Ihrerseits verwenden.

Benutzerdefinierte Funktionen vs. MCP-Server – was sollten Sie verwenden:

Sie können beide gleichzeitig für denselben Agenten verwenden.

Funktionsweise (Die einfache Version) #

1. Sie registrieren einen MCP-Server auf der Seite MCP-Server – mit seiner Webadresse und einem Autorisierungs-Header (normalerweise ein API-Schlüssel).
2. Your AI Connector verbindet sich, erkennt die Tools des Servers und speichert die Liste.
3. Sie aktivieren den Server für einen Agenten.
4. Wenn der Kunde während eines Gesprächs nach etwas fragt, das ein Tool beantworten kann, ruft der Bot das Tool auf, liest das Ergebnis und antwortet auf natürliche Weise.

Der Kunde sieht nie die technischen Hintergründe – er erhält einfach eine Antwort, die auf echten, aktuellen Informationen basiert.

Was ein MCP-Tool-Aufruf kostet #

Ein Tool-Aufruf von einem MCP-Server wird exakt wie ein benutzerdefinierter Funktionsaufruf gemäß der KI-Qualitätsstufe Ihres Agenten abgerechnet:

Hinzufügen eines MCP-Servers (Schritt für Schritt) #

Klicken Sie in der Hauptseitenleiste unter AI Studio auf MCP-Server. Klicken Sie dann auf + Server hinzufügen.

Füllen Sie das Formular aus:

Wahl der Anmeldemethode: API-Schlüssel oder OAuth #

Your AI Connector unterstützt zwei Möglichkeiten zur Authentifizierung bei einem Server. Wählen Sie diejenige, die in der Dokumentation des Servers empfohlen wird, indem Sie die Option Authentifizierung oben im Formular verwenden:

• API-Schlüssel / Header: die oben beschriebene ursprüngliche Methode. Sie fügen einen festen Anmeldeinformation (einen API-Schlüssel oder Token) in das Feld Auth-Header-Wert ein, und Your AI Connector sendet diesen bei jeder Anfrage. Am besten geeignet für Server, die Ihnen einen langlebigen Schlüssel zur Verfügung stellen.
• OAuth (Anmelden): für Server, bei denen Sie sich anmelden müssen, anstatt einen Schlüssel einzufügen. Bei OAuth gibt es keinen Schlüssel zum Kopieren – Sie genehmigen den Zugriff durch die Anmeldung, genau wie bei „Mit Google anmelden“ auf anderen Websites.

So verbinden Sie sich mit OAuth:

1. Wählen Sie OAuth als Authentifizierungsmethode. Die Felder für den Auth-Header verschwinden und werden durch eine Verbinden-Karte ersetzt – Sie benötigen keinen Schlüssel.

2. Geben Sie den Namen und die Server-URL ein und klicken Sie dann auf Speichern. Der Server wird Ihrer Liste hinzugefügt, wird aber vorerst als nicht verbunden angezeigt.
3. Klicken Sie auf Verbinden beim Server. Ein sicheres Anmeldefenster öffnet sich, in dem Sie den Zugriff genehmigen.
4. Bestätigen Sie, und das Fenster schließt sich von selbst. Der Server wird nun als verbunden angezeigt und Your AI Connector lädt seine Tools.

Das ist alles. Your AI Connector hält die Verbindung automatisch im Hintergrund aufrecht, sodass Sie sich normalerweise nie wieder darum kümmern müssen. Sollte ein Server die Verbindung jemals trennen (zum Beispiel, wenn die Anmeldung abläuft oder jemand sie auf der Serverseite widerruft), wird er als getrennt angezeigt – klicken Sie einfach auf Erneut verbinden und melden Sie sich wieder an.

Wenn der Server beim Klicken auf „Verbinden“ nicht automatisch eingerichtet werden kann, werden Sie aufgefordert, einige Details (eine Anmeldeadresse und eine Client-ID) einzufügen, die in der Dokumentation des Servers angegeben sind. Danach wird der Anmeldevorgang abgeschlossen.

Verbindung testen #

Klicken Sie vor dem Speichern auf Verbindung testen. Your AI Connector kontaktiert den Server und zeigt Ihnen die Liste der angebotenen Tools an. Dies ist der schnellste Weg, um zu bestätigen, dass Ihre URL und Ihr Schlüssel korrekt sind – falls die Verbindung fehlschlägt, sehen Sie die Fehlermeldung direkt dort, anstatt dies erst mitten im Gespräch herauszufinden.

Wenn der Test erfolgreich ist, klicken Sie auf Speichern. Ihr Server erscheint in der Liste mit einem grünen Statuspunkt und der Anzahl der angebotenen Tools.

Die Serverliste lesen #

Jeder Server in der Liste zeigt:

• Einen Statuspunkt – grün, wenn die letzte Verbindung funktioniert hat, rot, wenn der letzte Versuch fehlgeschlagen ist (fahren Sie mit der Maus darüber, um den Fehler zu sehen), grau vor der ersten erfolgreichen Verbindung.
• Die Adresse des Servers und wie viele Tools er aktuell anbietet.
• Einen Ein-/Ausschalter, um den gesamten Server schnell zu aktivieren oder zu deaktivieren, ohne ihn zu löschen. Your AI Connector aktualisiert die Tool-Liste jedes Servers im Hintergrund etwa einmal täglich, sodass neue Tools automatisch erscheinen. Ein langsamer oder vorübergehend nicht erreichbarer Server hält niemals ein Gespräch auf – der Bot verwendet einfach die zuletzt bekannte Tool-Liste und greift elegant darauf zurück, falls ein Aufruf nicht durchkommt.

Auswahl der vom Bot nutzbaren Tools #

Ein Server bietet oft mehr Tools an, als der Bot verwenden soll. Sie können einzelne Tools ein- oder ausschalten, ohne die Verbindung zum gesamten Server zu trennen.

1. Klicken Sie auf das Stift-Symbol (Bearbeiten) beim entsprechenden Server in der Liste.
2. Scrollen Sie zum Abschnitt Tools – jedes vom Server angebotene Tool ist dort mit einem eigenen Ein-/Ausschalter aufgelistet.
3. Schalten Sie alle Tools aus, die der Bot nicht aufrufen soll, oder verwenden Sie Alle aktivieren / Alle deaktivieren, um die Einstellungen auf einmal vorzunehmen.
4. Klicken Sie auf Änderungen speichern.

Nur die Tools, die Sie eingeschaltet lassen, werden dem Bot angeboten. Ein ausgeschaltetes Tool ist für den Bot völlig unsichtbar – er kann es nicht aufrufen und es zählt nicht zum Limit von 40 Tools.

Zwei Dinge, die Sie wissen sollten:

• Neue Tools bleiben deaktiviert, bis Sie sie einschalten. Sobald Sie die Tools eines Servers kuratiert haben, werden alle Tools, die der Server später hinzufügt, standardmäßig deaktiviert. Nichts Neues wird für den Bot verfügbar, bis Sie sich entscheiden, es zu aktivieren. (Server, die Sie noch nie kuratiert haben, behalten alle ihre Tools aktiviert, genau wie zuvor.)
• Dies ist unabhängig von der unten stehenden Agentenwahl. Hier entscheiden Sie, welche Tools eines Servers überhaupt existieren (kontoweit); beim Agenten entscheiden Sie, welche Server dieser Agent erreichen kann – und, falls gewünscht, schränken Sie die Tools für diesen speziellen Agenten weiter ein.

Ausführungslimits pro Tool festlegen #

Neben dem Ein-/Ausschalter jedes Tools finden Sie ein Limits-Steuerelement. Es öffnet dieselben Ausführungslimits, die Sie auch für eine benutzerdefinierte Funktion festlegen können, angewendet nur auf dieses eine Tool – nützlich, wenn ein Tool eines Servers einen kostenpflichtigen Drittanbieterdienst aufruft oder wenn ein Tool pro Konversation nur ein einziges Mal ausgeführt werden soll. Alles hier ist optional; lassen Sie es leer, und das Tool verhält sich genau wie zuvor.

• Schreibgeschützt. Einige Server deklarieren für jedes Tool, ob es nur Daten liest. Automatisch (Server-Einstellung) vertraut dieser Deklaration; Sie können sie in beide Richtungen überschreiben – markieren Sie ein Tool als Schreibgeschützt, wenn Sie wissen, dass es niemals etwas erstellt oder ändert (dies ermöglicht es der KI, eine unterbrochene Antwort sicher erneut zu versuchen, anstatt den Kunden ohne Antwort zu lassen), oder als Nicht schreibgeschützt, wenn Sie der Behauptung des Servers nicht vertrauen.
• Zwischengespeichertes Ergebnis bei wiederholten Aufrufen bereitstellen. Wenn die KI das Tool erneut mit denselben Eingaben aufruft, wird das vorherige Ergebnis wiederverwendet (für bis zu 24 Stunden), anstatt den Server erneut aufzurufen.
• Maximale Ausführungen pro Konversation und Maximale Ausführungen pro Zeitfenster funktionieren genau wie bei benutzerdefinierten Funktionen: nur erfolgreiche Ausführungen zählen, und wenn ein Limit greift, wird die KI darüber informiert, warum, und antwortet mit den Informationen, die sie bereits hat – der Kunde wird nie im Stich gelassen. Testkonversationen sind ausgenommen.

Ein ehrlicher Hinweis zum Vertrauen: Limits steuern, ob und wie oft wir den Server aufrufen – sie können nicht ändern, was der Server intern tut, sobald er aufgerufen wurde. Und ein Drittanbieter-Tool als Schreibgeschützt zu markieren, ist eine stärkere Behauptung als bei Ihrer eigenen benutzerdefinierten Funktion, da es sich um den Code eines anderen handelt; tun Sie dies nur für Tools, die Sie verstehen.

Aktivieren eines Servers für einen Agenten #

Durch das Registrieren eines Servers wird dieser verfügbar; Sie wählen jedoch weiterhin aus, welche Agenten ihn verwenden können.

1. Öffnen Sie den Agenten und gehen Sie auf den Tab KI-Fähigkeiten. (Bei einer Kampagne, die ihre eigenen KI-Einstellungen direkt und nicht über einen separaten Agenten verwaltet, erscheint dieselbe Liste stattdessen im Schritt KI-Fähigkeiten der Kampagne selbst.)
2. Suchen Sie den Bereich MCP-Server.
3. Aktivieren Sie jeden Server, den der Bot dieses Agenten verwenden soll.
4. Klicken Sie auf Änderungen speichern – die Auswahl wird erst nach dem Speichern wirksam.

Sie können bis zu 5 Server pro Agent aktivieren. Nur die Server, die Sie aktivieren, sind für den Bot dieses Agenten verfügbar, was den Bot auf die relevanten Tools konzentriert.

Auswahl der Tools, die ein Agent verwenden darf #

Sobald ein Server für einen Agenten aktiviert ist, können Sie auch einschränken, welche seiner Tools dieser spezielle Agent aufrufen darf – praktisch, wenn ein Agent nur Daten lesen soll, während ein anderer auch Datensätze erstellen darf.

1. Klicken Sie auf dem Tab KI-Fähigkeiten unter dem aktivierten Server auf die Zeile “… für diesen Agenten aktivierte Tools”, um die Tool-Liste zu erweitern.
2. Deaktivieren Sie alle Tools, die dieser Agent nicht verwenden sollte, und klicken Sie dann auf Änderungen speichern.

Zwei Regeln sorgen dafür, dass dies vorhersehbar bleibt:

• Ein Agent kann nur einschränken, niemals erweitern. Tools, die Sie kontoweit deaktiviert haben (auf der Seite MCP-Server), erscheinen hier nicht und können nicht für einen einzelnen Agenten wieder aktiviert werden.
• Agenten erben standardmäßig. Ein Agent, bei dem Sie die Tool-Liste nicht bearbeitet haben, folgt einfach der kontoweiten Auswahl – einschließlich Tools, die Sie dort später aktivieren. Sobald Sie die Liste eines Agenten einschränken, bleiben neue Tools für diesen Agenten deaktiviert, bis Sie sie explizit aktivieren.

Vorgefertigtes Beispiel: Einen Shopify-Shop verbinden #

Jeder Shopify-Shop verfügt über einen integrierten MCP-Server – es muss keine App installiert und kein Schlüssel erstellt werden. Shopify hostet ihn unter der eigenen Webadresse des Shops mit angehängtem /api/mcp.

Was der Bot daraus erhält:

• Produktsuche – Produkte finden durch Beschreibung dessen, was der Kunde möchte („eine warme Laufjacke unter 100 $“), inklusive aktueller Preise, Varianten und Lagerbestand.
• Produktdetails – Vollständige Informationen zu einem bestimmten Produkt, einschließlich Optionen und Verfügbarkeit.
• Shop-Richtlinien und FAQs – Fragen zu Versand, Rücksendungen, Erstattungen und Datenschutz, beantwortet direkt von den eigenen Seiten des Shops.
• Warenkorb – Erstellen Sie einen Warenkorb für den Kunden und stellen Sie ihm einen Checkout-Link bereit.

Um einen Shop zu verbinden, fügen Sie einen Server mit folgenden Angaben hinzu:

Speichern Sie, klicken Sie auf Verbindung testen und aktivieren Sie den Server für Ihren Agenten – das ist die gesamte Einrichtung.

Zwei Dinge, die Sie wissen sollten:

• Bestellungen sind auf diesem Server nicht verfügbar. Shopify hält Bestelldaten bewusst von diesem öffentlichen Endpunkt fern. Für Fragen wie „Wo ist meine Bestellung?“ kombinieren Sie diesen Server mit einer benutzerdefinierten Funktion – siehe das Beispiel zum Shopify-Bestellstatus.
• Es funktioniert für jeden Shopify-Shop – einschließlich des Shops eines Kunden, falls Sie Konten für andere verwalten. Alles, was Sie benötigen, ist die Webadresse des Shops.

Sicherheit – Verbinden Sie nur Server, denen Sie vertrauen #

Ein MCP-Server, den Sie verbinden, kann von Ihrem Bot aufgerufen werden und Text zurückgeben, den der Bot liest und auf den er reagiert. Behandeln Sie ihn wie jede andere Integration, die einen Schlüssel zu Ihren Systemen besitzt:

• Registrieren Sie nur Server, die Sie kontrollieren oder denen Sie voll vertrauen. Die Beschreibung eines Tools wird von der Person verfasst, die den Server betreibt, und der Bot liest diese Beschreibungen, um zu entscheiden, wann ein Tool verwendet werden soll.
• Verwenden Sie einen dedizierten, eingeschränkten API-Schlüssel, keine Administrator-Anmeldedaten. Ihr Schlüssel wird sicher gespeichert und niemals in Datenexporten angezeigt. Dasselbe gilt für OAuth-Anmeldungen – die Zugriffstoken werden sicher gespeichert und aus allen Exporten entfernt.
• Die URL muss eine öffentliche https://-Adresse sein. Interne Adressen, localhost-Adressen und Adressen in privaten Netzwerken werden aus Sicherheitsgründen abgelehnt.
• Deaktivieren Sie einen Server sofort, wenn Sie ihm nicht mehr vertrauen – schalten Sie ihn aus oder löschen Sie ihn, dann ist er sofort von jedem Agenten entfernt.

Fehlerbehebung #

• Roter Statuspunkt / Verbindung fehlgeschlagen: Öffnen Sie den Server erneut und klicken Sie auf Verbindung testen, um den genauen Fehler zu sehen. Die häufigsten Ursachen sind ein falscher oder abgelaufener Schlüssel, ein Tippfehler in der URL oder der Server erfordert einen anderen Header-Namen als Authorization.
• Ein OAuth-Server funktioniert nicht mehr / fordert Sie zum erneuten Verbinden auf: OAuth-Anmeldungen können serverseitig widerrufen werden oder ablaufen. Öffnen Sie den Server und klicken Sie erneut auf Verbinden, um sich wieder anzumelden. Beachten Sie, dass OAuth-Anmeldungen niemals zwischen Konten kopiert werden. Daher müssen die Server eines kopierten Agenten oder einer kopierten Kampagne in dem Konto, in das Sie sie kopiert haben, erneut verbunden werden.
• Der Bot verwendet ein Tool nicht: Prüfen Sie zuerst, ob das Tool im Bereich Tools des Servers eingeschaltet ist (bearbeiten Sie den Server, um die Liste zu sehen) – ein ausgeschaltetes Tool ist für den Bot unsichtbar. Stellen Sie dann sicher, dass der Server für diesen spezifischen Agenten aktiviert ist und dass die Anfrage des Kunden klar mit der Funktion des Tools übereinstimmt. Wie bei benutzerdefinierten Funktionen helfen klare Tool-Namen und Beschreibungen auf der Serverseite dem Bot, die richtige Wahl zu treffen.
• Ein vom Server angebotenes Tool wird für den Bot nicht angezeigt: Wenn Sie die Tools dieses Servers kuratiert haben, denken Sie daran, dass jedes Tool, das nach der Kuratierung hinzugefügt wurde, standardmäßig ausgeschaltet ist. Bearbeiten Sie den Server, öffnen Sie den Bereich Tools und schalten Sie es ein.
• Unterstützt der Connector MCP-HTTP-Sitzungen? Ja. Wenn Ihr Server beim Verbindungsaufbau einen mcp-session-id-Header ausgibt, speichern wir diesen und senden ihn bei jeder nachfolgenden Anfrage zusammen mit dem MCP-Protocol-Version-Header zurück. Zustandsbehaftete Server funktionieren ohne zusätzliche Konfiguration Ihrerseits.
• Ein Tool wurde übersprungen: Ein Agent kann gleichzeitig maximal 5 Server und 40 MCP-Tools verwenden. Wenn ein Server eine sehr große Anzahl an Tools anbietet, werden möglicherweise nicht alle geladen – schalten Sie die Tools, die Sie nicht benötigen, im Bereich Tools des Servers aus oder beschränken Sie jeden Server auf die Tools, die Sie tatsächlich verwenden.

Plan-Anforderungen #

MCP-Server sind Teil des Entwickler-Toolsets, zusammen mit benutzerdefinierten Funktionen. Wenn Sie MCP-Server nicht im Bereich AI Studio der Seitenleiste sehen, ist dies in Ihrem aktuellen Plan nicht enthalten – führen Sie ein Upgrade auf einen Plan mit Entwickler-Tools durch, um diese Funktion zu aktivieren.

Nächste Schritte #

• Benutzerdefinierte Funktionen — binden Sie ein einzelnes Tool manuell ein, anstatt einen ganzen Server zu verbinden.
• KI-Agenten — hier werden MCP-Server für einen Bot aktiviert.
• KI-Agenten — die Hauptseite der KI-Studio-Gruppe, in der sich die MCP-Server befinden.