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 ServerMCP — 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.
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
| Szenario | Warum sich MCP eignet |
|---|---|
| Sie betreiben bereits einen internen Tool-Server | Eine einzige Verbindung, alle Ihre Tools für jeden Agenten verfügbar |
| Sie möchten Tools über mehrere Agenten hinweg teilen | Einmal verbinden, an beliebig vielen Agenten anhängen |
| Sie nutzen Community-MCP-Server | Beliebte Open-Source-MCP-Server einbinden, ohne eigenen Code zu schreiben |
| Ihr Tool-Bestand ändert sich häufig | Der 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
- 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.

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

Es öffnet sich ein Fenster. Füllen Sie aus:
Feld Beschreibung Bezeichnung Ein 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-URL Die HTTPS-Adresse des Streamable-HTTP-Endpunkts Ihres MCP Servers inklusive Pfad (meist /mcp).http://sowie private oder interne Adressen werden abgelehnt.Authentifizierung Keine, 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.
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.
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.
- Tab Aktionen des Agenten öffnen
Wählen Sie den Agenten, öffnen Sie den Tab Folgeaktionen und klicken Sie auf Tool anlegen.
- 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.
- Tool ausfüllen
Feld Beschreibung Tool-Name Ein Name für diesen Eintrag im Tab „Folgeaktionen" des Agenten (z. B. Externe MCP-Tools). Pflichtfeld.Wann zu verwenden Eine kurze Anweisung, anhand derer der Agent entscheidet, wann er im Gespräch zu diesen Tools greift. Pflichtfeld. MCP-Server Alle 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. 
Klicken Sie auf Speichern. Der Agent hat nun Zugriff auf die Tools jeder aktivierten MCP-Verbindung.
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"+ Toolsearch_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:
| Anforderung | Detail |
|---|---|
| HTTPS | Reines http:// wird nicht akzeptiert. Verwenden Sie ein echtes TLS-Zertifikat. |
| Öffentliche URL | Die URL muss auf eine öffentliche Adresse auflösen — Hanc.AI kann keine Server in einem privaten Netzwerk oder auf localhost erreichen. |
| MCP Streamable HTTP transport | Ihr 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
| Tarif | MCP-Server |
|---|---|
| Kostenlose Testphase, Free | Nicht verfügbar |
| Starter / Pro / Business / Enterprise | Verfü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 mithttp://. - Prüfen Sie die Adresse auf Tippfehler; private und interne Hosts werden abgelehnt.
- Der Host ist öffentlich —
localhost,127.0.0.1und 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.
Verwandte Themen
- Aktionen & Tools — Eingebaute Tools und wie der Tab „Folgeaktionen“ aufgebaut ist
- Integrationen — Alle verfügbaren Integrationen
- API Tool RAG — Einfachere Option für einen einzelnen Endpunkt
Ähnliche Integrationen
monday.com, GoHighLevel, Kommo und CallRail — sie laufen über MCP.
Senden Sie jeden Anruf nach seinem Ende an Ihr eigenes System.
Nutzen Sie die HANC API aus Ihrer eigenen Software.