Eigener MCP-Server
Eigene Systeme über das Model Context Protocol anbinden, damit der Agent am Telefon darin nachschauen oder etwas erfassen kann.
Über einen MCP-Server binden Sie ein eigenes System an – ein Lager, einen Shop, eine interne Datenbank. Der Agent kann dessen Werkzeuge am Telefon benutzen: nachschauen, was ein Anrufer wissen will, oder etwas im System erfassen. Sie entscheiden je Werkzeug, ob er es darf.
Empfänger von Anruferdaten
Was ein Anrufer fragt, geht an den Server, den Sie anbinden. Binden Sie nur Dienste an, denen Sie Kundendaten anvertrauen. Ein angebundener Server ist ein Empfänger, den Sie selbst wählen – mehr dazu unter Datenschutz.
Voraussetzungen
- Der Server spricht MCP über Streamable HTTP.
- Er ist über https erreichbar. Andere Adressen lehnt Tanevo ab, sonst ginge ein Token unverschlüsselt durchs Netz.
- Er ist aus dem Internet erreichbar. Adressen in privaten oder lokalen
Netzen (z. B.
localhost,192.168.…,….local) sind gesperrt, auch wenn ein öffentlicher Name dorthin zeigt. - Anmeldung, falls nötig, mit einem Token in einem Kopf (Header) Ihrer
Wahl, z. B.
Authorization. Zugangsdaten in der Adresse selbst (https://name:passwort@…) werden abgelehnt.
Server anbinden
Kachel öffnen
Im Dashboard unter Konnektoren die Kachel MCP-Server anklicken. Das Seitenpanel öffnet sich rechts.
Angaben eintragen
Unter «Server hinzufügen»:
| Feld | Inhalt |
|---|---|
| Name | Damit Sie Ihre Server auseinanderhalten, z. B. «Lager». |
| Adresse | Die https-Adresse des Servers, z. B. https://…/mcp. |
| Anmeldung | «Keine Anmeldung» oder «Token». |
| Kopfname | Nur bei Token. Vorgabe Authorization; erlaubt sind Buchstaben, Ziffern und Bindestriche (z. B. X-Api-Key). |
| Token | Nur bei Token, z. B. Bearer …. |
Prüfen und verbinden
Klicken Sie auf Prüfen und verbinden. Tanevo verbindet sich mit dem
Server und fragt dessen Werkzeuge ab (tools/list), bevor etwas
gespeichert wird. Schlägt das fehl, steht der Grund im Panel, gefolgt von
«Nichts gespeichert.».
Werkzeuge freischalten
Nach dem Verbinden listet das Panel alle Werkzeuge des Servers, jedes mit eigenem Schalter. Freischaltungen gelten ab dem nächsten Anruf.
Welche Werkzeuge eingeschaltet sind
Beim Anbinden schaltet Tanevo nur die Werkzeuge ein, die der Server
ausdrücklich als nur lesend meldet (MCP-Annotation readOnlyHint: true).
Sie tragen im Panel das Tag liest. Alle anderen tragen nicht als
lesend gemeldet und bleiben aus, bis Sie sie selbst einschalten.
«Nicht als lesend gemeldet» heisst nicht, dass das Werkzeug etwas ändert – nur, dass der Server es nicht anders sagt. Viele Server melden gar keine Hinweise. Tanevo behandelt solche Werkzeuge vorsichtshalber wie ändernde.
Noch nicht möglich
Ein Werkzeug ohne readOnlyHint selbst als «ändert nichts» markieren, damit
der Agent es ohne Rückfrage aufruft. Die Einstellung ist gebaut, aber noch
nicht freigeschaltet. Bis dahin entscheidet allein der Hinweis des Servers.
Was am Telefon passiert
Lesende Werkzeuge. Der Agent ruft das Werkzeug auf und spricht nur einen Satz, der aus dessen Ergebnis formuliert und gegen das Ergebnis geprüft wurde: Zahlen, Zeiten, Beträge und Namen müssen dort stehen. Fällt der Satz durch, sagt der Agent nichts Unbelegtes; die Frage wird beim Auflegen eine Aufgabe für Sie.
Ändernde Werkzeuge (alles ohne readOnlyHint) führt der Agent erst aus,
nachdem er dem Anrufer die Angaben vorgelesen und ein Ja gehört hat. Ohne
diese Bestätigung lehnt Tanevo den Aufruf ab. Gelingt er, sagt der Agent:
«Das ist erledigt, ich habe es so im System erfasst.» Meldet der Server einen
Fehler, gilt nichts als erledigt, und es entsteht eine Aufgabe.
Ausfall. Ist der Server nicht erreichbar oder zu langsam, sagt der Agent ehrlich: «Das kann ich gerade nicht im System nachschauen. Ich notiere Ihr Anliegen, und jemand aus dem Betrieb meldet sich bei Ihnen.» (bei ändernden Werkzeugen: «… nicht im System erfassen …»). Das Anliegen landet als Aufgabe im Dashboard.
Nur, was freigeschaltet ist. Der Agent sieht ausschliesslich freigeschaltete Werkzeuge von Servern, die nicht ausgeschaltet sind. Welche das sind, liest er zu Beginn jedes Anrufs aus der Datenbank, ohne den Server anzufragen. Nur die Argumente gehen an Ihren Server; die Frage im Wortlaut des Anrufers bleibt bei Tanevo.
Die Beschreibungen, die Ihr Server für seine Werkzeuge mitliefert, gibt Tanevo dem Modell als ungeprüften Fremdtext weiter. Anweisungen darin setzen die Regeln des Agenten nicht ausser Kraft: Policy, Bestätigung und Satzprüfung gelten trotzdem.
Wie schnell ein Werkzeug sein muss
Am Telefon wartet Tanevo höchstens 2,5 Sekunden auf Ihren Server. Was länger braucht, wird abgebrochen und endet für den Anrufer im Ausfallsatz oben. Planen Sie Werkzeuge so, dass sie deutlich darunter antworten – als Faustregel in 1 bis 2 Sekunden.
Das Panel zeigt für jedes Werkzeug, wie schnell es an echten Anrufen war (Median), z. B. «am Telefon 0,8 s (Median, 12 Aufrufe)». Ist es zu oft zu langsam, steht dort rot «am Telefon manchmal zu langsam» bzw. «am Telefon meist zu langsam». Bei weniger als drei Aufrufen steht nur die gemessene Zeit ohne Urteil.
Ergebnisse gehen gekürzt auf 4'000 Zeichen an die Formulierung; Antworten über 512 KB lehnt Tanevo ab.
Token und Sicherheit
Das Token wird verschlüsselt gespeichert (AES-256-GCM) und im Dashboard nie wieder angezeigt. Der Browser bekommt es nicht zu sehen. Im Panel steht nur, in welchem Kopf es mitgeht («Token im Kopf Authorization»).
Wollen Sie das Token wechseln, entfernen Sie den Server und binden ihn neu an.
Server verwalten
Für jeden angebundenen Server zeigt das Panel:
- Zustand – «Verbunden», «Gestört», «Ungeprüft» oder «Ausgeschaltet»; bei einer Störung steht der Grund darunter.
- Werkzeuge – wie viele freigeschaltet sind.
- Adresse, Anmeldung, Zuletzt erfolgreich geprüft und, falls der Server es meldet, unter welchem Namen er sich meldet.
Neu prüfen fragt die Werkzeuge erneut ab und gleicht die Liste ab. Schlägt das fehl, bleiben die Werkzeuge, wie sie waren.
Entfernen fragt einmal nach. Danach benutzt der Agent die Werkzeuge dieses Servers ab dem nächsten Anruf nicht mehr.
Denselben Server (dieselbe Adresse) können Sie nicht zweimal anbinden.
Grenzen
Noch nicht möglich
- MCP-Werkzeuge im Pop-up-Agenten – sie stehen nur am Telefon zur Verfügung.
- Anmeldung per OAuth oder anderen Verfahren als einem festen Token.
- Ein Token ändern, ohne den Server neu anzubinden.
Pop-up-Agent
Der Agent als sprechende Kugel unten rechts auf Ihrer Website – einbinden, freischalten, und was er dort sieht und tut.
Eigene Nummer
Eine Schweizer Tanevo-Nummer auf den Namen Ihres Betriebs – welche Angaben und Unterlagen die Prüfung braucht, wie lange sie dauert und was danach mit Ihren Dokumenten geschieht.