Zum Inhalt springen
covey

Ein Agent soll unter einem GitLab-Issue einen Kommentar hinterlassen. Im Kommentar steht der Satz „Das Deployment läuft erst nach dem Merge, das Feld when: 'manual' bleibt gesetzt“. Über die Shell muss das Modell dafür einen curl-Aufruf bauen, dessen JSON-Rumpf in einfachen Anführungszeichen steht.

Das erste einfache Anführungszeichen im Kommentartext beendet diese Zeichenkette vorzeitig. Der Aufruf scheitert dann oder verschickt etwas anderes als gemeint.

Ob ein Agent seine Werkzeuge deshalb über das Model Context Protocol aufrufen sollte, wird seit längerem gestritten. Im März 2025 fragte bschmidt44 auf Hacker News „Why MCP instead of just HTTP?“. Der Einwand dort war, dass Sprachmodelle aus ihren Trainingsdaten weit mehr über fetch wissen als über ein neues Protokoll.

Mario Zechner schrieb im August 2025 von der üblichen Skepsis der Praktiker, weil viele MCP-Server das Kontextfenster fluten oder Dutzende Werkzeuge anbieten. Er selbst ließ seine Agenten lieber Kommandozeilenwerkzeuge aufrufen.

covey beantwortet die Frage an der Stelle, an der ein Agent überhaupt ein Zielsystem erreicht: am lokalen Aktions-Proxy in der Sandbox.

Die Shell-Route verliert Züge an Anführungszeichen

Standardmäßig ruft ein covey-Agent eine Zielaktion als Shell-Befehl auf. Das ist ein curl -s -X POST http://localhost:$COVEY_ACTION_PORT/actions/<system>/<action> -d '<json>' gegen den Aktions-Proxy, dessen Antwort das Modell von der Standardausgabe liest.

Das funktioniert und verlangt vom Modell trotzdem JSON innerhalb einer Shell-Zeichenkette. Jedes Anführungszeichen und jede geschweifte Klammer im Parameter ist dort eine Gelegenheit für einen Fehler. Ein falscher Aufruf kostet einen Zug gegen die Zuggrenze des Laufs, die der Adapter für Claude Code als --max-turns übergibt.

Der Kommentar zum Merge ist genau dieser Fall. Der Fehler steckt in der Verpackung des Inhalts.

Zwei Türen führen in denselben Raum

Derselbe Proxy nimmt Aktionen deshalb ein zweites Mal entgegen, als MCP-Werkzeugserver unter POST /mcp. Er beantwortet die vier Methoden initialize, ping, tools/list und tools/call. Jede andere Methode bekommt eine Fehlermeldung, die mit „method not found“ beginnt.

Auf diesem Weg übergibt die Laufzeit die Parameter als JSON-Objekt direkt an den Proxy, und zwischen beiden steht keine Shell mehr. Das Anführungszeichen in when: 'manual' ist dort ein gewöhnliches Zeichen in einer JSON-Zeichenkette, da JSON nach RFC 8259 allein das doppelte Anführungszeichen, den umgekehrten Schrägstrich und Steuerzeichen maskiert.

Dahinter liegt für beide Türen eine einzige Funktion. Bei einer Aktion auf einem Zielsystem entscheidet sie gegen die Guard Rails, führt die Aktion mit vermittelten Zugangsdaten aus und schreibt sie in die Aufzeichnung des Laufs.

Platzhalter der Form {{secret:<key>}} löst der Proxy erst nach der Entscheidung der Guard Rails auf, bevor das Plugin die Parameter sieht. Das gilt für beide Türen gleich. Eine verweigerte Aktion kommt auf der MCP-Route als status: denied im Ergebnis zurück. So liest die Laufzeit sie als Antwort und behandelt das Werkzeug weiter als intakt.

Ein Werkzeug je Zielsystem statt eines je Aktion

Die Werkzeugliste enthält ein Werkzeug für jedes Zielsystem, das die Organisation aktiviert und die ACCESS.md des Agenten freigibt.

Dazu kommt das Werkzeug covey für die Aktionen der Plattform selbst, etwa Notizen, Wiki und Aufgaben.

Jedes Werkzeug nimmt zwei Felder entgegen: den Namen der Aktion als action und ihre Parameter als Objekt params. Als Beschreibung trägt das Werkzeug eines Zielsystems die Dokumentation des Plugins, also denselben Text wie im Systemprompt.

Ein eigenes Schema je Aktion wäre die naheliegende Lösung gewesen. covey verzichtet bewusst darauf, da die Plugins ihre Aktionen in Prosa beschreiben. Ein daneben gepflegtes Schema wäre eine zweite Wahrheit und würde sich mit der Zeit von der ersten entfernen.

Diese Form wählte Zechner auch für sein eigenes Werkzeug, ein einziges Werkzeug statt eines je Kommando. Der Preis dafür: Die Laufzeit prüft die Parameternamen einer Aktion gegen kein Schema, und das Modell entnimmt sie weiterhin der Beschreibung.

Die MCP-Route muss man ausdrücklich einschalten

Eingeschaltet wird die MCP-Route mit COVEY_ACTION_MCP=1 in der .env und einem Neustart. Sie ist eine bewusste Wahl des Betreibers, weil ein gescheiterter Handshake alle Zielaktionen eines Laufs mitnehmen würde. Die Betriebsdokumentation empfiehlt deshalb, danach die Aufzeichnung eines Agenten über einen Lauf zu beobachten. Die Aktionen erscheinen dort als Werkzeugaufrufe mcp__covey statt als Bash.

Die Shell-Route bleibt in jedem Fall offen. Eine Agentenkonfiguration mit dem curl-Aufruf funktioniert also weiter.

Für Claude Code übergibt der Adapter den Proxy mit --mcp-config. Er setzt mcp__covey außerdem in dieselbe Liste --allowedTools. Ohne diesen Eintrag würde ein Lauf ohne Bildschirm bei jeder Aktion um eine Erlaubnis fragen, die allein ein Mensch vor dem Bildschirm geben könnte.

Das MCP-Dokument gibt der Adapter für Claude Code weiter, und ebenso ein Adapter, der Claude Code als Laufzeit mit einer anderen Basisadresse betreibt. Ein weiterer Adapter übergibt das Dokument laut seiner Spezifikation nicht, sodass seine Agenten die Zielsysteme über die Shell erreichen.

Für den Agenten mit dem GitLab-Kommentar bleibt die Wahl zwischen MCP und Shell damit eine Frage der Verpackung. Welche Aktion er ausführen darf, mit welchen Zugangsdaten und mit welchem Eintrag in der Aufzeichnung, entscheidet in beiden Fällen dieselbe Stelle im Proxy.

Zurück zur Übersicht