> ## Documentation Index
> Fetch the complete documentation index at: https://aipro.placetel.de/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Eigener MCP-Server
> Eigenen MCP-Server verbinden -- die dort bereitgestellten Tools erkennen und Ihrem Voice Agent als Tools hinzufügen.
## Überblick
Das **[Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro)** 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**
**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.
4. Klicken Sie auf **Tools entdecken**. Der Server wird abgefragt (`tools/list`) und die verfügbaren Tools werden geladen
5. **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**
6. **Überprüfen-Schritt (Schritt 3 von 3):** Prüfen Sie die getroffene Auswahl noch einmal und bestätigen Sie mit **N Tools hinzufügen**
7. 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
8. Ö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](/docs/de/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**.
| Tool (Beispiel) | Beschreibung (Beispiel) |
| ---------------- | ---------------------------------------------------------- |
| `find_contact` | Findet einen Kontakt anhand der Telefonnummer (nur lesend) |
| `get_contact` | Ruft einen einzelnen Kontakt ab (nur lesend) |
| `list_deals` | Listet die offenen Deals eines Kontakts auf (nur lesend) |
| `create_note` | Fügt der Kontakt-Chronik eine Notiz hinzu (verändernd) |
| `update_contact` | Ändert die Kontaktdaten (verändernd) |
| `delete_contact` | Löscht einen Kontakt (löschend) |
## 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 ` gesendet.
* **Eigener Header:** Der eingegebene Wert wird unter dem von Ihnen angegebenen Header-Namen gesendet (z. B. `X-API-Key: `).
* **Keine:** Es werden keine Zugangsdaten mitgesendet.
### Fehlerbehebung
| Problem | Mögliche Ursache & Lösung |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **„keine Tools gefunden"** | Falsche oder unvollständige Server-URL (der **Pfad fehlt**) oder falsche Authentifizierung. Vollständige Endpunkt-URL inkl. Pfad und die Zugangsdaten prüfen |
| **404 vom Server** | Der angegebene Endpunktpfad existiert nicht. Pfad gemäß der Dokumentation Ihres MCP-Servers korrigieren |
| **Verbindung fehlgeschlagen** | Server nicht erreichbar oder Zugangsdaten ungültig. URL, Erreichbarkeit und Authentifizierung prüfen |