Skip to main content

​
Überblick

Das Model Context Protocol (MCP) ist ein standardisierter Weg, um externe Tools für eine KI bereitzustellen. Mit der Eigener-MCP-Server-Integration verbinden Sie Ihren eigenen MCP-Server (über HTTP bzw. Streamable-Transport) und machen die Tools, die dieser Server bereitstellt, als Tools für Ihren Voice Agent verfügbar. Anders als bei den festen Kalender-Integrationen (z. B. Outlook oder Calendly) gibt es hier keine feste Tool-Liste: Welche Tools zur Verfügung stehen, hängt vollständig vom verbundenen Server ab. Sie geben die Server-Adresse an, lassen die verfügbaren Tools automatisch erkennen und wählen daraus die gewünschten aus.
Beta — Ausführung während des Anrufs: Das Verbinden eines Servers, das Erkennen der Tools und das Hinzufügen zur Tool-Liste funktionieren bereits. Das Ausführen dieser Tools während eines laufenden Anrufs ist derzeit noch in Vorbereitung und in Kürze verfügbar. Sie können die Integration also schon einrichten; das tatsächliche Aufrufen durch den Voice Agent im Gespräch folgt.
Sicherheit: Die eingegebenen Zugangsdaten werden verschlüsselt auf dem Server gespeichert und sind nur für Ihren Account zugänglich. Geben Sie die Server-Adresse und ein etwaiges Token nur ein, wenn Sie dem Server vertrauen.

​
Integration einrichten

  1. Öffnen Sie die Tools-Seite in der Sidebar
  2. Klicken Sie auf Create tool (Tool erstellen) und wählen Sie MCP Server
  3. Verbindungs-Schritt (Schritt 1 von 3): Füllen Sie die Verbindungsangaben aus:
    • Name — frei wählbar. Dient nur der Wiedererkennung und erscheint später als Kennzeichnung an den Tools in der Tool-Liste
    • Server-URL — die Adresse Ihres MCP-Servers
    • Authentifizierung — Keine, Bearer-Token oder Eigener Header. Bei Bearer-Token geben Sie zusätzlich das Token ein; bei Eigener Header einen Header-Namen und einen Header-Wert
    MCP-Server verbinden -- Name, Server-URL und Authentifizierung
Wichtig — vollständige Endpunkt-URL angeben: Tragen Sie die vollständige MCP-Endpunkt-URL inklusive Pfad ein (z. B. https://ihr-server.de/v1/mcp/core). Die reine Basis-URL (z. B. https://ihr-server.de) funktioniert in der Regel nicht und führt zu „keine Tools gefunden”. Der genaue Pfad ist je nach Server unterschiedlich — entnehmen Sie ihn der Dokumentation Ihres MCP-Servers.
  1. Klicken Sie auf Tools entdecken. Der Server wird abgefragt (tools/list) und die verfügbaren Tools werden geladen
  2. Auswahl-Schritt (Schritt 2 von 3): Wählen Sie aus der Liste der gefundenen Tools die gewünschten aus. Mehrfachauswahl ist möglich, mit Alle auswählen wählen Sie die gesamte (gefilterte) Liste. Über das Suchfeld können Sie die Liste einschränken; über den Pfeil an jedem Tool blenden Sie dessen Parameter ein. Klicken Sie anschließend auf Weiter MCP-Tools auswählen -- Trefferliste, Suchfeld und „Alle auswählen"
  3. Überprüfen-Schritt (Schritt 3 von 3): Prüfen Sie die getroffene Auswahl noch einmal und bestätigen Sie mit N Tools hinzufügen
  4. Die ausgewählten Tools erscheinen anschließend in der Tool-Liste — gekennzeichnet mit einem MCP-Symbol und einem Badge mit dem vergebenen Namen des Servers. Von dort stehen sie wie alle Tools global zur Verfügung und können einem Voice Agent zugewiesen werden
  5. Öffnen Sie den gewünschten Voice Agent und wechseln Sie in den Tools-Tab. Aktivieren Sie dort das gewünschte MCP-Tool für diesen Agent
Gemeinsame Tools: Wie alle Tools stehen auch die MCP-Tools nach dem Erstellen global zur Verfügung. Sie müssen sie pro Voice Agent nur noch im Tools-Tab aktivieren. Mehr dazu unter Tools.
Bereits vorhandene Tools: Tools, deren Name bereits als Tool in Ihrem Account existiert, werden beim Hinzufügen übersprungen. In der Trefferliste sind sie als hinzugefügt gekennzeichnet und nicht erneut auswählbar.

​
Verfügbare Tools

Anders als bei Outlook mit seinen zwei festen Tools werden die MCP-Tools dynamisch vom Server erkannt. Die verfügbaren Tools sind daher serverspezifisch — es gibt keine feste Liste, die für alle gilt. Jedes gefundene Tool zeigt einen Namen und eine Beschreibung aus dem Server; über die Parameter-Ansicht sehen Sie zusätzlich die einzelnen Eingabefelder (Name, Typ und ob sie erforderlich sind). Wählen Sie nur die Tools aus, die Ihr Agent tatsächlich benötigt.

​
Beispiel

Der folgende Auszug ist nur beispielhaft und stammt von einem einfachen CRM (Kundenverwaltung) — eine typische Anbindung, etwa um Anrufer anhand ihrer Telefonnummer zu erkennen und eine Gesprächsnotiz zu hinterlegen. Welche Tools Ihr Server bereitstellt, sehen Sie erst nach dem Klick auf Tools entdecken.

​
Hinweise für den Prompt / Sicherheit

​
Nur benötigte Tools auswählen

Wählen Sie bewusst nur die Tools aus, die der Agent wirklich braucht.
Verändernde und löschende Tools: Manche MCP-Tools verändern oder löschen Daten — erkennbar oft an Namen wie delete_…, update_… oder create_…. Fügen Sie ein solches Tool hinzu, kann der Agent diese Aktion grundsätzlich auslösen. Gehen Sie hier vorsichtig vor und bevorzugen Sie — wo möglich — nur lesende Tools (z. B. list_…, get_…).

​
Eignung für das Telefongespräch

Nicht jedes Tool eignet sich für einen Sprachanruf:
  • Tools, die IDs oder Codes erwarten, die der Anrufer diktieren müsste, funktionieren am Telefon schlecht.
  • Tools, die große Datenmengen zurückgeben, lassen sich kaum sinnvoll vorlesen.
  • Bevorzugen Sie einfache Abfragen und Aktionen mit wenigen, klaren Parametern.

​
Authentifizierung

  • Bearer-Token: Es wird der Header Authorization: Bearer <Token> gesendet.
  • Eigener Header: Der eingegebene Wert wird unter dem von Ihnen angegebenen Header-Namen gesendet (z. B. X-API-Key: <Wert>).
  • Keine: Es werden keine Zugangsdaten mitgesendet.

​
Fehlerbehebung