Diese Seite ist eine Übersetzung der englischen Dokumentation. Befehle, Bezeichner und Beispiele bleiben unverändert. Runtime 7.24.4 · SDK 2.6.7. Englische Fassung

Eine laufende TUI über MCP teilen

Status: Experimentell Geltungsbereich: öffentlich, aktueller Stand Zuletzt geprüft: 2026-10-04 Verantwortlich: Betreuende von AX Code

TUIMCP ist ein experimenteller, zuschaltbarer MCP-Adapter für die TUI von AX Code unter macOS und Linux. Ein externer Agent kann damit einen begrenzten Zustand der Oberfläche lesen und dieselbe TUI führen, die Sie gerade nutzen. Windows wird in dieser Version nicht unterstützt.

Starten Sie eine TUI mit ausdrücklichem Teilen:

ax-code --tui-mcp
# Or attach to an existing local backend:
ax-code attach http://localhost:4096 --tui-mcp

Die Leiste von TUIMCP zeigt den absoluten privaten Pfad endpoint.json. Richten Sie Ihren MCP-Client für diesen Start ein:

{
  "mcpServers": {
    "ax-code-tui": {
      "command": "ax-code",
      "args": ["mcp", "tui", "--endpoint", "/absolute/path/from/the/TUI/endpoint.json"]
    }
  }
}

Nutzen Sie den Pfad, den Ihre laufende TUI anzeigt. Jede TUI hat ihren eigenen Endpunkt; eine automatische Erkennung oder eine Wahl des Ziels gibt es nicht. Der Client muss als derselbe Benutzer des Betriebssystems laufen. Behandeln Sie die Datei des Endpunkts als Zugangsrecht: sie enthält ein geheimes Token. Übernehmen Sie sie nicht in ein Commit, kopieren Sie sie nicht in Prompts und geben Sie ihren Inhalt nicht weiter. Zugangsdaten des Backends gehen nie an den Adapter.

Werkzeuge

• get_view_context: liefert Instanz und Generation, Revision, Route, eine optionale Sitzungs-ID, die Bereitschaft und ob die Navigation blockiert ist. Transkripte, Entwürfe, Titel der Sitzung, Pfade des Arbeitsbereichs und Zugangsdaten gibt die Antwort nicht zurück.
• select_session: verlangt die Identität und die Revision aus einem frischen Kontext, eine Sitzungs-ID des Projekts und eine eindeutige UUID requestId. Die Sitzung wird über die bestehende authentifizierte Verbindung der TUI zum Backend geprüft. Eine erfolgreiche Antwort bestätigt den Routenzustand der Anwendung; Darstellung und Laden der Sitzung können noch laufen. Sitzungs-IDs lassen sich getrennt über die gewöhnlichen Schnittstellen für Sitzungen von AX Code beziehen.

Navigation wird abgelehnt, solange ein Entwurf oder ein Anhang vorliegt, ein Modal oder eine Genehmigung aussteht, Sitzungen beschäftigt sind, das Backend getrennt ist, Overlays für Start oder Ende aktiv sind oder Sie in den letzten 1.5 Sekunden interagiert haben. Ein geänderter Zustand der Oberfläche oder des Arbeitsbereichs macht alte Revisionen ungültig. Diese Werkzeuge können keine Prompts einreichen, keine Befehle der Shell ausführen, keine Berechtigungen genehmigen und keine Arbeit des Agenten starten.

Ein wiederholtes, identisches requestId liefert seinen ursprünglichen Beleg einschließlich des ursprünglichen Kontexts. Die Wiederverwendung mit anderen Argumenten ist ein Fehler. Nach 128 Navigationsanfragen werden neue Anfragen für diesen Prozess der TUI abgelehnt; der Lesezugriff und vorhandene Belege bleiben verfügbar. Starten Sie mit ausdrücklichem Teilen neu, um diese Grenze zurückzusetzen. Belege werden nicht in eine unsichere erneute Wiedergabe verdrängt.

deadline_exceeded bedeutet, dass die Prüfung vor der Navigation abgebrochen wurde. timeout_unknown oder outcome_unknown bedeutet, dass die aufrufende Seite kein endgültiges Ergebnis erhielt; die Operation kann dennoch angewandt worden sein. Lesen Sie den aktuellen Kontext, um den Stand abzugleichen. Der Adapter versucht es nie von selbst erneut. Erfolg der Verbindung oder des Transports allein bedeutet keinen Erfolg der Navigation; prüfen Sie isError und das strukturierte Ergebnis.

Widerruf und Lebenszyklus

Klicken Sie in der Leiste von TUIMCP auf [Widerrufen] oder führen Sie /tui-mcp-revoke aus. Der Widerruf sperrt ausstehende Navigation sofort ab und schließt den Socket. Auch das Beenden schließt den Endpunkt; ein Neustart erzeugt eine neue Identität und ein neues Token. Ein abgestürzter Prozess kann ein untätiges privates temporäres Verzeichnis hinterlassen; alte Clients erreichen darüber keine neue TUI.

Das Teilen ist standardmäßig aus und wird nicht gespeichert. Lokale Prüfungen von Eigentümer und Modus schützen vor anderen Benutzern des Betriebssystems. TUIMCP ist keine Sandbox gegen Code, der bereits als Ihr Benutzer läuft. Meldet der Start, dass der Pfad des Sockets zu lang ist, nutzen Sie über TMPDIR eine kürzere private temporäre Wurzel und starten Sie eine neue TUI.