Zum Hauptinhalt springen
DocumentationAPI ReferenceVideo Tutorials

MCP Servers

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.

In jedem Tarif verfügbar

MCP servers sind in allen Tarifen verfügbar, einschließlich Free. Es fallen keine Gebühren pro Server an — Sie zahlen nur für die Anrufminuten, in denen Ihr Agent die Tools tatsächlich verwendet.

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. Integrationsseite öffnen​

Gehen Sie in der Dashboard-Seitenleiste zu Integration. Scrollen Sie zum Abschnitt MCP servers.

2. Auf „MCP Server verbinden" klicken​

Es öffnet sich ein Modal. Füllen Sie folgende Felder aus:

FeldBeschreibung
LabelEin kurzer Name für diese Verbindung (z. B. "Sales Tools", "Internal CRM"). Das Label erscheint in der Tool-Auswahl des Agenten und wird den Tool-Namen vorangestellt, die der KI präsentiert werden — halten Sie es daher kurz und aussagekräftig.
URLDie HTTPS-URL Ihres MCP Servers. Sie muss öffentlich erreichbar sein — http:// sowie private bzw. interne Adressen werden abgelehnt.
AuthentifizierungNone, wenn Ihr Server offen ist, oder Bearer token, wenn er einen Authorization: Bearer …-Header erwartet.
Token(Nur bei Bearer) Ihr Auth-Token. Wird verschlüsselt gespeichert — nur Ihr Plattformkonto kann ihn zur Verwendung entschlüsseln.

Klicken Sie auf Speichern. Hanc.AI prüft das URL-Format und legt die Verbindung an. 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 servers verbinden, die zufällig ähnlich benannte Tools enthalten.

3. Bearbeiten, deaktivieren oder löschen​

Die Liste der MCP servers zeigt Label, URL, Auth-Typ und Status jeder Verbindung, die Sie hinzugefügt haben. Über die Aktionen pro Zeile können Sie:

  • Bearbeiten — Label, URL, Auth-Typ oder Token ändern
  • 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 servers zugreifen.

1. Actions-Tab des Agenten öffnen​

Wählen Sie den Agenten aus. Öffnen Sie den Actions-Tab. Klicken Sie auf Action hinzufügen.

2. „MCP servers" aus der Gruppe „Live call" auswählen​

Das Dropdown zeigt drei Gruppen: Pre fetch, Live call, Post call. MCP servers finden Sie in der Gruppe Live call, denn der Agent ruft MCP-Tools während des Gesprächs auf — weder davor noch danach.

3. Auswählen, welche Verbindungen aktiviert werden sollen​

Das Modal listet alle MCP-Verbindungen Ihres Workspace auf, jeweils mit einem Ein-/Aus-Schalter. Aktivieren Sie diejenigen, die dieser Agent verwenden soll. Sie können außerdem im Feld „When to use it" eine kurze Anweisung hinterlegen — der Agent liest diese, um zu entscheiden, wann er während eines Gesprächs auf diese Tools zurückgreifen soll.

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-servers-Tool mit eigenen Schaltern.

Wie es zur Anrufzeit funktioniert​

Wenn ein Anruf beginnt, verbindet sich der Agent mit jedem seiner aktivierten MCP servers 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 transportDer aktuelle MCP-HTTP-Transport über einen einzelnen Endpunkt. SSE-only- und stdio-Transporte werden in dieser Integration 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. Nur die Anrufinfrastruktur von Hanc.AI kann sie entschlüsseln, und auch nur in dem Moment, in dem ein Anruf beginnt und der Agent sich mit Ihrem Server verbinden muss.

Tool-Aufrufe fließen Agent → Hanc.AI → Ihr MCP Server → zurück. Wir loggen keine Tool-Aufruf-Payloads. 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.

Tarifverfügbarkeit​

TarifMCP Servers
FreeVerfü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"​

  • Stellen Sie sicher, dass die URL mit https:// und nicht mit http:// beginnt.
  • Stellen Sie sicher, dass der Host öffentlich erreichbar ist — localhost, 127.0.0.1 und interne Adressen werden absichtlich blockiert.
  • Prüfen Sie den Bearer token noch einmal, falls Sie einen gesetzt haben — überzählige Leerzeichen oder Anführungszeichen verhindern das Speichern.

„Der Agent sieht die Tools nicht"​

  • Prüfen Sie, ob im MCP-Server-Eintrag im Actions-Tab des Agenten mindestens eine Verbindung eingeschaltet ist und der Eintrag gespeichert wurde.
  • Stellen Sie sicher, dass Ihr MCP Server auf eine tools/list-Anfrage antwortet und keinen interaktiven Auth-Flow erzwingt.
  • Sehen Sie im Anrufprotokoll des Agenten direkt zu Beginn des Anrufs nach Meldungen der MCP-Verbindung.

„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​