AthausDoku

MCP-Werkzeuge: wie sie gebaut sind

Wie die Werkzeuge der zwei MCP-Server gebaut sind. Die Listen selbst stehen je Server.

Zuletzt aktualisiert:

Jeder Server hat eine eigene Liste, geordnet nach dem Recht, das ein Werkzeug verlangt.

Die Namen

Englisch, snake_case, das Verb vorn; was ein Mensch liest (Titel, Beschreibung, Ergebnis), ist deutsch. search_ sucht mit Freitext und Filtern, list_ liest kleine Mengen deines Kontos, get_ holt ein Ding mit seinem Zusammenhang, save_ legt ohne Kennung an und ändert mit Kennung, update_ ändert nur. draft_, send_ und decide_ können etwas hinausgehen lassen: sie bereiten vor, dein Klick führt aus.

Derselbe Name kann an beiden Servern Verschiedenes heißen: get_inquiry ist bei Athaus für Anbieter eine Anfrage an dein Büro, bei der Suche deine Anfrage an ein Inserat. Werte in Eingaben sind englisch (buy, rent).

Was ein Werkzeug zurückgibt

Eingaben und Rückgaben beschreibt der Server in tools/list. Ein Ergebnis hat einen Text, der für sich vollständig ist (zeigt ein Assistent eine Oberfläche, sieht sein Modell nur ihn), dieselben Daten als structuredContent und, was auf einen Klick wartet, unter confirmation. Ein Fehler kommt als Ergebnis mit isError, einem Satz mit dem nächsten Schritt und dem Fehlercode in _meta["athaus/code"]; fehlt eine Angabe, stellt es genau eine Frage.

Hinweise für Modelle

Der Server liefert die Hinweise des Protokolls mit: readOnlyHint bei Werkzeugen, die nur lesen, destructiveHint, wo ein Aufruf etwas ersetzt, löscht, verwirft, widerruft oder unwiderruflich schickt (nur Neues anlegen nicht), openWorldHint, wo ein Werkzeug fremde Dienste fragt oder selbst etwas hinausgehen lässt. Was hinausgeht, führt der Klick eines Menschen aus (Rechte).

Weiter lesen

Auf dieser Seite