Told what is closed

When an MCP client connects, the server says which areas are closed or read-only in this installation, and the tools behind them are simply not offered. A model does not spend its turns walking into refusals — it knows from the first message what it may try. Over REST, /openapi.json says the same.

Es sagt, was zu ist

Verbindet sich ein MCP-Client, sagt der Server, welche Bereiche in dieser Installation zu oder nur lesbar sind, und die Werkzeuge dahinter werden gar nicht erst angeboten. Ein Modell verbraucht seine Züge nicht an Absagen — es weiß ab der ersten Nachricht, was es versuchen darf. Über REST sagt /openapi.json dasselbe.

No timing guesswork

The usual fallback is sleep(3) and hope. Instead there is /wait: wait until a form appears, until a control becomes enabled, until it is gone, or until the main thread goes quiet. It answers 200 when the condition held and 408 when it never did — and reports how long it actually took.

Kein Raten über Zeiten

Der übliche Notbehelf ist sleep(3) und Hoffen. Stattdessen gibt es /wait: warten, bis ein Formular erscheint, bis ein Element bedienbar ist, bis es verschwunden ist, oder bis der Hauptthread zur Ruhe kommt. Antwort 200, wenn die Bedingung eintrat, 408, wenn nicht — samt der tatsächlich vergangenen Zeit.

Refusals instead of false positives

Triggering a disabled action returns 409, not a cheerful „done“. A test that asks for something impossible learns that it was impossible — the single most valuable property when nobody is watching the screen.

Absagen statt Scheinerfolge

Eine gesperrte Aktion auslösen ergibt 409, kein fröhliches „erledigt“. Ein Test, der Unmögliches verlangt, erfährt, dass es unmöglich war — die wertvollste Eigenschaft überhaupt, wenn niemand auf den Bildschirm sieht.

Modal dialogs don’t block

An action that opens a modal dialog would never return. With async=1 it is queued and answered immediately with 202 — checked first, so a disabled action is still refused. Message boxes can be answered in advance and are logged with their text, which is often worth more than the click.

Modale Dialoge blockieren nicht

Eine Aktion, die einen modalen Dialog öffnet, käme nie zurück. Mit async=1 wird sie vorgemerkt und sofort mit 202 beantwortet — vorher geprüft, eine gesperrte Aktion wird weiterhin abgelehnt. Meldungsdialoge lassen sich im Voraus beantworten und werden mit ihrem Text protokolliert, was oft mehr wert ist als der Klick.

Write, then read back

Setting a property answers with the value read back from the object, not with a confirmation. Some properties clamp or reformat what you give them, and that is precisely what the caller needs to know.

Schreiben und zurücklesen

Eine Eigenschaft zu setzen liefert den vom Objekt zurückgelesenen Wert, keine Bestätigung. Manche Eigenschaften begrenzen oder formatieren, was man ihnen gibt — und genau das muss der Aufrufer erfahren.

Nothing has to be known in advance

/objects lists every component the application holds — including the ones that never appear on screen: datasets, timers, action lists, whole data modules. Each with the path that addresses it unambiguously, even when two modules use the same name.

class=TDataSet&derived=1 narrows it to every dataset, whatever the application happens to use. Catalogue first, then drive — without ever having seen the source.

Man muss nichts vorher wissen

/objects listet jede Komponente der Anwendung — auch die, die nie auf dem Bildschirm auftauchen: Datenmengen, Timer, Aktionslisten, ganze Datenmodule. Jede mit dem Pfad, der sie eindeutig anspricht, auch wenn zwei Module denselben Namen benutzen.

class=TDataSet&derived=1 engt auf alle Datenmengen ein, gleich welche die Anwendung verwendet. Erst katalogisieren, dann steuern — ohne den Quelltext je gesehen zu haben.

Two endpoints teach you the third

The target of a call is always name. An upper limit for one request is always max. Every list answers with count and truncated. The method says what happens: GET reads, PUT replaces, POST appends, DELETE removes.

Nine rules, and they hold everywhere. Where one of them cannot — four places, all of them because the thing itself is shaped that way — it says so on the spot instead of quietly behaving differently.

Zwei Endpunkte erklären den dritten

Das Ziel eines Aufrufs heißt immer name. Die Obergrenze für eine Anfrage immer max. Jede Liste antwortet mit count und truncated. Die Methode sagt, was passiert: GET liest, PUT ersetzt, POST hängt an, DELETE löscht.

Neun Regeln, und sie gelten überall. Wo eine nicht kann — vier Stellen, alle vier, weil die Sache selbst so gebaut ist — steht es dort, statt sich still anders zu verhalten.

Data that survives the round trip

A dataset row comes back typed: numbers as numbers, booleans as true, dates as 2026-12-24, an empty field as null. Exactly what goes back in when you write it again — no conversion by hand, and no dependence on the Windows locale of whichever machine the test happens to run on.

Daten, die den Rundlauf überstehen

Eine Datensatzzeile kommt typisiert zurück: Zahlen als Zahl, Wahrheitswerte als true, Datumsangaben als 2026-12-24, ein leeres Feld als null. Genau das, was beim Zurückschreiben wieder hineingeht — ohne Umrechnen von Hand und ohne Abhängigkeit von den Ländereinstellungen der Maschine, auf der der Test gerade läuft.

Names, not coordinates

Controls are addressed by name or by path (frmMain.pnlLeft.btnSave). Clicking goes through the control’s own Click method, so it works while the window is covered or in the background — and hits the intended element every time.

Coordinates do come along, and then in all three frames of reference at once: in the parent, in the form, on the screen. Handing out one of them and calling it „left“ is how a caller ends up adding up parent positions by hand — which goes wrong at the first panel with a border and produces numbers that are almost right.

Namen statt Koordinaten

Steuerelemente werden über Namen oder Pfad angesprochen (frmMain.pnlLeft.btnSave). Der Klick geht über die Click-Methode des Elements und wirkt auch bei verdecktem oder im Hintergrund liegendem Fenster — und trifft immer das gemeinte.

Koordinaten kommen trotzdem mit, und zwar gleich in allen drei Bezugssystemen: im Elternelement, im Formular, auf dem Bildschirm. Nur eines davon herauszugeben und es „left“ zu nennen, führt dazu, dass der Aufrufer Elternpositionen von Hand addiert — was beim ersten Panel mit Rahmen schiefgeht und Zahlen liefert, die fast stimmen.

Typing that doesn’t need the window in front

/key?name=edtTotal&text=12,50 sends the keystrokes straight to that element — in the background, covered, whatever. And the answer only goes out once the control has processed them, so reading the value back is not a race.

Even Tab, Return and Escape — the keys a control never sees, because the VCL routes them through the form. They take that same road, so they work covered too. Nothing here goes through the keyboard of the system, and nothing needs the window in front.

Tippen, ohne das Fenster nach vorn zu holen

/key?name=edtTotal&text=12,50 schickt die Eingabe direkt an das Element — im Hintergrund, verdeckt, egal. Und die Antwort geht erst hinaus, wenn das Steuerelement sie verarbeitet hat: Zurücklesen ist damit kein Wettlauf.

Auch Tab, Return und Escape — die Tasten, die ein Element nie zu sehen bekommt, weil die VCL sie durch das Formular schickt. Sie nehmen denselben Weg und wirken deshalb auch bei verdecktem Fenster. Nichts davon läuft über die Tastatur des Systems, nichts braucht das Fenster im Vordergrund.

Screenshots when they help

For the genuinely visual checks — colours, layout, a rendered label — /screenshot has the window draw itself, so the image is right even when the window is covered, minimized or hidden. Nothing in it depends on what is in front. The picture complements the facts; it no longer replaces them.

And it does not have to be a whole window. /screenshot?name=lblTotal returns that label — even a TLabel, which has no window of its own and gets cut out of the one it sits in. A full screen costs an AI something like two thousand tokens of attention; a single control costs a fraction of that. Looking closely is cheaper than looking at everything.

Bildschirmfotos, wo sie helfen

Für wirklich Visuelles — Farben, Layout, ein gerendertes Etikett — lässt /screenshot das Fenster sich selbst zeichnen; das Bild stimmt auch verdeckt, minimiert oder unsichtbar. Nichts daran hängt davon ab, was davor liegt. Es ergänzt die Fakten, statt sie zu ersetzen.

Es muss auch kein ganzes Fenster sein: /screenshot?name=lblSumme liefert dieses eine Etikett — auch ein TLabel, das gar kein eigenes Fenster hat und deshalb aus dem ausgeschnitten wird, in dem es sitzt. Ein ganzer Bildschirm kostet eine KI gut zweitausend Token Aufmerksamkeit, ein einzelnes Element einen Bruchteil davon. Genau hinsehen ist billiger als auf alles zu schauen.

VCL only

It reads the VCL component tree. Application.MessageBox is a plain Win32 window without a VCL form and therefore out of reach; so is anything drawn by a control that keeps its state to itself.

Nur VCL

Gelesen wird der VCL-Komponentenbaum. Application.MessageBox ist ein reines Win32-Fenster ohne VCL-Formular und damit nicht erreichbar — ebenso wenig, was ein Steuerelement nur für sich selbst zeichnet.

Setting is not typing

A property set through the interface does not raise the same events as a real keystroke. Where validation hangs off OnChange, use /key instead — the component documents the difference rather than hiding it.

Setzen ist nicht Tippen

Eine gesetzte Eigenschaft löst nicht dieselben Ereignisse aus wie eine echte Eingabe. Wo die Prüfung an OnChange hängt, führt /key zum Ziel — die Komponente dokumentiert den Unterschied, statt ihn zu verbergen.

It waits with the application

If the main thread is busy, so is the interface. That is deliberate — but it means the component cannot be used to inspect an application that has hung.

Es wartet mit der Anwendung

Ist der Hauptthread beschäftigt, wartet auch die Schnittstelle. Das ist gewollt — heißt aber, dass sich eine hängende Anwendung damit nicht untersuchen lässt.