Werkzeuge
Wie die Werkzeuge der zwei MCP-Server gebaut sind. Die Listen selbst stehen je Server.
Jeder Server hat seine eigene Liste, geordnet nach dem Recht, das ein Werkzeug verlangt. Beide Listen sind aus dem Vertrag erzeugt, aus dem auch die Server ihre Werkzeuge führen; ein Test hält beide gleich.
Athaus für Makler
Lagebericht, Bestand, Anfragen, Antworten, Bewertungen, Vorschläge.
Athaus Immobiliensuche
Katalog, Exposé, Anfragen an Anbieter, Suchaufträge, Treffer.
Die Namen
Englisch, in snake_case, das Verb vorn: so benennen die Verzeichnisse von ChatGPT und Claude ihre Werkzeuge, und so findet ein Modell sie am sichersten. Was ein Mensch liest, also Titel, Beschreibung und Ergebnis, ist deutsch.
| Verb | Bedeutung |
|---|---|
search_ | Freitext und Filter, seitenweise |
list_ | kleine Mengen deines Kontos, ohne Freitext |
get_ | ein Ding mit allem Zusammenhang für die nächste Entscheidung |
save_ | ohne Kennung anlegen, mit Kennung ändern |
update_ | ändern, wo es nichts anzulegen gibt |
draft_, send_, decide_ | Taten, die hinausgehen können: sie bereiten vor, dein Klick führt aus |
check_, estimate_, count_, calculate_, show_ | prüfen, rechnen, zeigen |
Derselbe Name kann an beiden Servern stehen und dort Verschiedenes heißen: get_inquiry ist bei Athaus für Makler eine Anfrage an dein Büro, bei der Suche deine eigene Anfrage an ein Inserat. Die Werte in einer Eingabe sind englisch (buy, rent); ein deutsches Wort wie "Wohnung" nimmt der Server auch.
Was ein Werkzeug zurückgibt
Die genauen Eingaben und Rückgaben beschreibt der Server selbst in tools/list, für das Modell geschrieben, mit outputSchema.
- Ein Text, der für sich vollständig ist. Zeigt ein Assistent eine Oberfläche, sieht sein Modell nur ihn.
- Dieselben Daten als
structuredContent, für ein Programm. - Was auf einen Klick wartet, steht dort unter
confirmation. Das Token für den Klick reist nur im_metaan die Karte, nie im Text. - Ein Fehler kommt als Ergebnis mit
isError, mit einem Satz, der den nächsten Schritt nennt, und dem Fehlercode in_meta["athaus/code"]. Fehlt eine Angabe, stellt das Ergebnis genau eine Frage.
Hinweise für Modelle
Zu jedem Werkzeug liefert der Server die vier Hinweise des Protokolls mit, und sie folgen aus seiner Wirkung: readOnlyHint bei Werkzeugen, die nur lesen, destructiveHint und openWorldHint nur dort, wo ein Werkzeug etwas zerstört oder fremde Dienste fragt. Ein Entwurf zählt nicht dazu. So fragt ein Assistent nicht vor jedem Entwurf nach, sondern vor dem, was wirklich etwas tut.
Was hinausgeht, führt der Klick eines Menschen aus, in der Bestätigungskarte oder in der App. Wann es ohne Klick läuft, steht unter Rechte.