Zum Hauptinhalt springen
Logo des Model Context Protocol

MCP-Server

Verbinden Sie einmal einen beliebigen MCP-kompatiblen Server — Ihre Sprachagenten erhalten seine Tools zu Beginn eines Anrufs und rufen sie mitten im Gespräch auf.

Bezahlte TarifeEigener Server

MCP — das Model Context Protocol — ist ein offener Standard, der es KI-Assistenten ermöglicht, externe Tools zu entdecken und aufzurufen. Wenn Sie einen MCP-kompatiblen Server betreiben (einen eigenen oder einen der zahlreichen Community-Server), können Sie ihn an Hanc.AI anbinden, und Ihre Agenten erhalten die Tools des Servers in dem Moment, in dem ein Anruf beginnt.

Einmal verbunden, kann der Agent diese Tools mitten im Gespräch aufrufen — Live-Daten abrufen, Berechnungen ausführen, Backend-Workflows anstoßen — genauso wie die eingebauten Integrationen für Calendar, HubSpot oder das API Tool.

Bezahlte Tarife

MCP-Server sind in jedem bezahlten Tarif ab Starter verfügbar — nicht in der kostenlosen Testphase und nicht im Free-Tarif; dort zeigt die MCP-Karte „Eigene MCP-Server sind in den kostenpflichtigen Tarifen verfügbar“. Es fallen keine Gebühren pro Server an — Sie zahlen nur für die Anrufminuten, in denen Ihr Agent die Tools tatsächlich verwendet.


Was Ihr Agent kann​

  • Ihre Tools mitten im Gespräch aufrufen — Live-Daten abrufen, Berechnungen ausführen, Backend-Workflows anstoßen, genau wie die integrierten Integrationen.
  • Bei jedem Anruf den aktuellen Tool-Satz erhalten — Tools werden zu Beginn des Anrufs ermittelt, Änderungen auf Ihrem Server gelten also ab dem nächsten Anruf.
  • Mehrere Server ohne Konflikte nutzen — jedem Tool-Namen wird das Label seiner Verbindung vorangestellt.

Wann Sie MCP verwenden sollten​

SzenarioWarum sich MCP eignet
Sie betreiben bereits einen internen Tool-ServerEine einzige Verbindung, alle Ihre Tools für jeden Agenten verfügbar
Sie möchten Tools über mehrere Agenten hinweg teilenEinmal verbinden, an beliebig vielen Agenten anhängen
Sie nutzen Community-MCP-ServerBeliebte Open-Source-MCP-Server einbinden, ohne eigenen Code zu schreiben
Ihr Tool-Bestand ändert sich häufigDer Agent entdeckt die Tools bei jedem Anruf neu — Tools serverseitig hinzufügen oder entfernen, ohne im Dashboard etwas anpassen zu müssen

Wenn Sie einen einzelnen, isolierten Endpunkt haben, ist das API Tool einfacher. Haben Sie hingegen eine Gruppe zusammengehöriger Tools oder pflegen Sie ohnehin bereits einen MCP-Server, ist dies die richtige Integration.


Einen MCP Server verbinden​

  1. Seite Integrationen öffnen

    Gehen Sie in der Seitenleiste des Dashboards zu Integrationen und öffnen Sie den Tab Entwickler: Der Abschnitt MCP-Server steht ganz oben.

    Der Tab Entwickler der Seite Integrationen: MCP-Server und API-Keys
  2. Auf MCP-Server verbinden klicken

    Das Panel MCP-Server listet Ihre Verbindungen auf. Klicken Sie auf MCP-Server verbinden.

    Das Panel MCP-Server: die Liste der Verbindungen mit Bezeichnung, URL, Authentifizierung und Status sowie der Button MCP-Server verbinden

    Es öffnet sich ein Fenster. Füllen Sie aus:

    FeldBeschreibung
    BezeichnungEin kurzer Name für diese Verbindung (z. B. Sales Tools, Internal CRM). Er erscheint in der Verbindungsliste und in der Liste der MCP-Server beim Agenten und wird den Tool-Namen vorangestellt, die die KI sieht — halten Sie ihn kurz und aussagekräftig.
    Server-URLDie HTTPS-Adresse des Streamable-HTTP-Endpunkts Ihres MCP Servers inklusive Pfad (meist /mcp). http:// sowie private oder interne Adressen werden abgelehnt.
    AuthentifizierungKeine, wenn Ihr Server offen ist, oder Bearer-Token, wenn er einen Authorization: Bearer …-Header erwartet.
    Bearer-Token(Nur bei Bearer) Ihr Token, gesendet als Authorization: Bearer …. Wird verschlüsselt gespeichert; Hanc.AI entschlüsselt es nur, um sich in Ihrem Auftrag mit Ihrem Server zu verbinden. Lassen Sie das Feld beim Bearbeiten leer, um das aktuelle Token zu behalten.
    Der Dialog MCP-Server verbinden: Bezeichnung, Server-URL und Authentifizierung

    Klicken Sie auf Verbinden. Hanc.AI akzeptiert nur https://-Adressen und lehnt private und interne Hosts ab. Ob Ihr MCP Server unter dieser Adresse antwortet, wird nicht geprüft: Ein falscher Pfad oder ein ausgefallener Server zeigt sich erst daran, dass der Agent die Tools nicht sieht.

    Die Verbindung steht nun jedem Agenten in Ihrem Workspace zur Verfügung.

Labels sind wichtig

Tool-Namen aus jedem MCP-Server werden mit dem Verbindungs-Label präfixiert. So erscheint ein Tool lookup_order auf einem als "Shop API" verbundenen MCP Server für den Agenten als Shop_API_lookup_order. Dies verhindert Namenskollisionen, wenn Sie mehrere MCP-Server verbinden, die zufällig ähnlich benannte Tools enthalten.

Bearbeiten oder löschen​

Die Liste MCP-Server zeigt für jede Verbindung Bezeichnung, URL, Authentifizierung und Status (aktiv / inaktiv). Die Schaltflächen in jeder Zeile:

  • Bearbeiten — Bezeichnung, URL, Authentifizierung oder Token ändern, dann auf Speichern klicken
  • Löschen — die Verbindung vollständig entfernen

Wird eine Verbindung entfernt, ist sie für jeden Agenten deaktiviert, an dem sie angehängt war — diese Agenten verlieren beim nächsten Anruf einfach den Zugriff auf ihre Tools.


MCP-Tools an einen Agenten anhängen​

Eine Verbindung in Ihrem Workspace steht Ihren Agenten zur Verfügung — jeder Agent entscheidet jedoch individuell, welche Ihrer Verbindungen er nutzen soll. So können Sie etwa separate Sales- und Support-Agenten haben, die auf unterschiedliche MCP-Server zugreifen.

  1. Tab Aktionen des Agenten öffnen

    Wählen Sie den Agenten, öffnen Sie den Tab Folgeaktionen und klicken Sie auf Tool anlegen.

  2. MCP-Server wählen

    Das Menü ordnet die Einträge nach Phase: Pre fetch, Live call, Post call. MCP-Server finden Sie in der Spalte Live call unter CRM & Dienste — der Agent ruft MCP-Tools während des Gesprächs auf, nicht davor oder danach.

  3. Tool ausfüllen
    FeldBeschreibung
    Tool-NameEin Name für diesen Eintrag im Tab „Folgeaktionen" des Agenten (z. B. Externe MCP-Tools). Pflichtfeld.
    Wann zu verwendenEine kurze Anweisung, anhand derer der Agent entscheidet, wann er im Gespräch zu diesen Tools greift. Pflichtfeld.
    MCP-ServerAlle MCP-Verbindungen Ihres Workspace, jeweils mit einem Schalter. Schalten Sie die ein, die dieser Agent nutzen soll — alle Tools dieser Server werden aufrufbar. Eine nicht aktive Verbindung ist mit inaktiv markiert.
    Der Dialog MCP-Server-Tool hinzufügen: Name, wann zu verwenden und ein Schalter pro MCP-Verbindung

    Klicken Sie auf Speichern. Der Agent hat nun Zugriff auf die Tools jeder aktivierten MCP-Verbindung.

Frei kombinieren

Sie können eine MCP-Verbindung an fünf Agenten aktivieren und eine andere nur an einem einzigen — jeder Agent verfügt über sein eigenes MCP-Server-Tool mit eigenen Schaltern.


Beispielszenarien​

Eine Bestellung auf Ihrem eigenen Server nachschlagen Der Anrufer fragt, wo seine Bestellung ist → der Agent ruft das Tool lookup_order Ihres MCP-Servers auf, verbunden als „Shop API“ (Shop_API_lookup_order) → er antwortet mit dem, was Ihr Server zurückgibt.

Unterschiedliche Tools für unterschiedliche Agenten Bei Ihrem Vertriebsagenten ist die Verbindung Sales Tools eingeschaltet, bei Ihrem Support-Agenten die Verbindung Internal CRM → jeder Agent sieht nur die Tools seiner eigenen Verbindungen.

Ein neues Tool, ohne das Dashboard anzufassen Sie fügen auf Ihrem MCP-Server ein Tool hinzu → schon der nächste Anruf erkennt es → der Agent kann es sofort nutzen.


Wie es zur Anrufzeit funktioniert​

Wenn ein Anruf beginnt, verbindet sich der Agent mit jedem seiner aktivierten MCP-Server und fragt: „Welche Tools bietet ihr an?" Was der Server zurückgibt, wird der KI als Tool zur Verfügung gestellt, das sie während des Gesprächs aufrufen kann.

Ein paar Dinge sind dabei zu beachten:

  • Tools werden zu Beginn des Anrufs entdeckt. Wenn Sie auf Ihrem MCP Server Tools hinzufügen oder entfernen, ist die Änderung schon beim nächsten Anruf wirksam — in Hanc.AI muss dazu nichts angepasst werden.
  • Tool-Namen werden präfixiert mit dem Verbindungs-Label (also "Shop API" + Tool search_products → Shop_API_search_products). Eingebaute Agent-Tools und andere MCP-Tools kollidieren so nicht.
  • Tool-Beschreibungen und Parameter-Schemata stammen von Ihrem MCP Server. Schreiben Sie dort gute Beschreibungen — diese verwendet die KI, um zu entscheiden, wann und wie sie das Tool aufruft.
  • Fehler werden an den Agenten zurückgemeldet. Schlägt ein Tool-Aufruf fehl, sieht der Agent die Fehlermeldung und kann entscheiden, ob er es erneut versucht, sich entschuldigt oder auf ein anderes Tool ausweicht.

Anforderungen an Ihren MCP Server​

Damit Ihr Server mit Hanc.AI funktioniert, muss er folgende Voraussetzungen erfüllen:

AnforderungDetail
HTTPSReines http:// wird nicht akzeptiert. Verwenden Sie ein echtes TLS-Zertifikat.
Öffentliche URLDie URL muss auf eine öffentliche Adresse auflösen — Hanc.AI kann keine Server in einem privaten Netzwerk oder auf localhost erreichen.
MCP Streamable HTTP transportIhr Server muss den Streamable-HTTP-Transport über einen einzigen Endpunkt sprechen (meist /mcp). Server, die nur den älteren SSE-Transport anbieten (ein /sse-Endpunkt), und stdio-Server werden nicht unterstützt.
Bearer-Authentifizierung (optional)Erfordert Ihr Server eine Authentifizierung, muss er einen standardmäßigen Authorization: Bearer <token>-Header akzeptieren.

Wenn Sie Ihren Server hinter einer Firewall betreiben, machen Sie ihn über einen Tunnel oder Reverse Proxy mit einem öffentlichen HTTPS-Endpunkt erreichbar.


Sicherheit und Datenschutz​

Ihre Bearer-Tokens werden verschlüsselt gespeichert. Hanc.AI entschlüsselt ein Token nur, um sich in Ihrem Auftrag mit Ihrem Server zu verbinden.

Tool-Aufrufe fließen Agent → Hanc.AI → Ihr MCP Server → zurück. Zur Fehlersuche protokolliert Hanc.AI die Tool-Argumente und die ersten 2.000 Zeichen jedes Ergebnisses. Ihr Server protokolliert das, was Sie auf Ihrer Seite zu protokollieren wählen.

Wenn Sie Ihr Token ändern oder rotieren, bearbeiten Sie die Verbindung im Dashboard — der neue Wert wird beim nächsten Anruf wirksam.

Damit Ihr Server weiß, welcher angemeldete Nutzer Ihrer Website anruft, lassen Sie Ihren Server für diesen Nutzer ein kurzlebiges Token ausstellen und übergeben es über das Website-Widget. Es kommt bei jeder MCP-Verbindung des Agenten im Header X-Hanc-Support-Token an — siehe Angemeldete Nutzer erkennen.


Tarifverfügbarkeit​

TarifMCP-Server
Kostenlose Testphase, FreeNicht verfügbar
Starter / Pro / Business / EnterpriseVerfügbar

Es fällt keine Gebühr pro Verbindung an — Sie zahlen ausschließlich für die Anrufminuten, in denen der Agent die Tools tatsächlich aufruft.


Fehlerbehebung​

„Verbindung lässt sich nicht speichern"​

Das Dashboard zeigt Verbindung konnte nicht gespeichert werden. Bitte Werte prüfen und erneut versuchen. Prüfen Sie:

  • Die URL beginnt mit https://, nicht mit http://.
  • Prüfen Sie die Adresse auf Tippfehler; private und interne Hosts werden abgelehnt.
  • Der Host ist öffentlich — localhost, 127.0.0.1 und interne Adressen sind bewusst gesperrt.

„Der Agent sieht die Tools nicht"​

  • Prüfen Sie die Adresse: Hanc.AI prüft nicht, ob Ihr MCP Server dort antwortet. Stellen Sie sicher, dass die URL auf den Streamable-HTTP-Endpunkt Ihres Servers zeigt, inklusive Pfad (meist /mcp), und dass der Server läuft.
  • Prüfen Sie, dass im Tool MCP-Server des Agenten mindestens eine Verbindung eingeschaltet ist, die Verbindung aktiv ist und das Tool gespeichert wurde.
  • Stellen Sie sicher, dass Ihr MCP Server eine tools/list-Anfrage ohne interaktive Anmeldung beantwortet.
  • Prüfen Sie das Bearer-Token erneut — zusätzliche Leerzeichen oder Anführungszeichen führen dazu, dass Ihr Server es ablehnt.

„Tool bricht mitten im Gespräch ab"​

  • Der Agent sieht den Fehler, den Ihr Server zurückgibt. Prüfen Sie Ihre Server-Logs.
  • Lang laufende Tools können in ein Timeout laufen — halten Sie die Ausführungszeit von MCP-Tools pro Aufruf unter wenigen Sekunden, damit der Besucher nicht im Stillen wartet.

„Ich habe Tools auf meinem Server geändert, aber der Agent verwendet weiterhin die alten"​

  • Tools werden zu Beginn jedes Anrufs neu entdeckt und nicht über Anrufe hinweg zwischengespeichert. Der nächste neue Anruf sieht den aktualisierten Tool-Bestand. Laufende Anrufe behalten die Tools, die ihnen beim Start zugewiesen wurden.