Subagent MCP

Unabhängige Umgebungen. Ein Codex-Orchestrator.

Wenn ein Modell eine Änderung plant, implementiert und überprüft, teilt der Prüfer den Kontext und die blinden Flecken des Autors. Es kann am Ende seinen eigenen Plan bestätigen, statt ihn zu testen.

Subagent MCP behält Codex als Hauptagenten und endgültigen Entscheidungsträger bei, während es begrenzte Arbeit an externe Agenten-Laufzeiten delegiert. Jede Laufzeit ist ein Modell, gepaart mit seiner nativen Umgebung, sodass Codex Implementierung oder Überprüfung von einem unabhängigen Modell mit anderem Kontext und anderen Annahmen erhalten kann.

Das erweitert den effektiven Sub-Agenten-Pool von Codex und kann Provider-Kontingente nutzen, die Sie bereits haben. Subagent MCP aktiviert, kauft, lädt nie automatisch nach oder entscheidet sich stillschweigend für Nutzungsguthaben oder bezahlte Überschreitungen.

Adapter übersetzen jede native Umgebung in denselben Lebenszyklus: delegieren, beobachten, steuern und schließen. Der Kern kodiert keine Provider-Rolle oder Modellnamen fest.

Stabil: 1.0.14 zielt auf Windows. Das MCP, das Paket, die localhost-UI und die nativen Umgebungs-Integrationen für Claude Code und DeepSeek sind bereit.

Laufzeitstatus

• Claude Code — Bereit. Verwendet die native Claude-Code-Umgebung, providernative Modell- und Reasoning-Einstellungen, die OAuth-Identität des Abonnements und Live-Nachweise ohne Überschreitung, bevor die Ausgabe akzeptiert wird.

• DeepSeek Harness — Bereit. Verwendet seinen nativen ACP-Transport und den von der Umgebung veröffentlichten Modellkatalog für begrenzte Aufgaben. Fortsetzen nach einem MCP-Neustart, exakte Provider-Kontingentnachweise, interaktive Eingabe und deklariertes MCP bleiben explizite Fähigkeitslücken.

Keine andere Laufzeit wird derzeit unterstützt. Zukünftige Laufzeiten verwenden Adapter statt providerspezifischer Verzweigungen im Kern.

Related MCP server: AI Knowledge Center MCP

Schnellstart

1. Installieren

Installieren Sie uv, falls nötig, und registrieren Sie dann die exakte isolierte Version und starten Sie ihre Hintergrund-UI:

winget install --id=astral-sh.uv -e
codex mcp add subagent-mcp -- uvx --isolated --from subagent-harness-mcp==1.0.14 subagent-harness-mcp serve
uvx --isolated --from subagent-harness-mcp==1.0.14 subagent-harness-mcp ui --background

Starten Sie nach der Registrierung eine neue Codex-Aufgabe.

2. Laufzeiten konfigurieren

Öffnen Sie http://127.0.0.1:8765 in einem Browser. Wenn die Hintergrund-UI gestoppt wurde, starten Sie dieselbe exakte Version erneut:

uvx --isolated --from subagent-harness-mcp==1.0.14 subagent-harness-mcp ui --background

Die Einstellungen und die schreibgeschützte Aktivitäts-UI bleiben auf dem festen Loopback-Port und hängen nicht von einer aktiven MCP-Verbindung ab.

Aktuelle und vergangene Aktivitäten werden nach externem Agenten aufgelistet. Wählen Sie eine Zeile aus, um Modell, native Umgebung, Arbeitsbereich, Berechtigungen, Schreibsatz, aktuelle Phase, Lebenszyklus, verstrichene Zeit und redigiertes Terminalergebnis zu prüfen. Prompts, Transkripte, verborgenes Denken und rohe Provider-Ereignisse werden nie angezeigt.

3. Delegieren

Fragen Sie Codex in einfacher Sprache:

Verwenden Sie Subagent MCP, um einen externen Agenten zu bitten, diese Änderung zu überprüfen, und bewerten Sie dann seine Ergebnisse unabhängig.

Codex wählt aus, was delegiert wird, beobachtet das Ergebnis und behält das endgültige Urteil. Lebenszyklus-Antworten sind standardmäßig kompakt; vollständige redigierte Berichte bleiben im lokalen Produktzustand und können später per Hash-gebundener Referenz gelesen oder weitergeleitet werden.

Modelle und Fallback-Reihenfolge

Jede native Umgebung veröffentlicht ihre eigenen Modelloptionen. Die UI zeigt Anzeigenamen und einen geordneten Prioritätsstapel; exakte Provider-IDs bleiben für erweiterte Routen verfügbar.

Wenn ein Provider explizit erschöpftes Kontingent oder Guthaben meldet (QUOTA_PAUSED), verschiebt Subagent MCP dieses exakte Modell für zukünftige Aufgaben ans Ende. Es versucht die fehlgeschlagene Aufgabe nicht erneut. Mehrdeutige Fehler, Abstürze und Zeitüberschreitungen ordnen Modelle nicht neu und lösen keine weitere bezahlte Anfrage aus.

Diese fehlgeschlagene Aufgabe bleibt endgültig, aber die nächste explizite Delegierung prüft den Provider erneut live; keine zwischengespeicherte Reset-Uhr oder ein Warten-bis-Checkpoint ersetzt diese Prüfung. Wenn die native Umgebung keinen sicheren Pre-Request-Kontingent-Endpunkt bereitstellt, bleibt der Status unbekannt, statt als erschöpft abgeleitet zu werden.

Die operative Wiederherstellung ist auf drei Aktionen begrenzt. Nur lokale Zustandsarbeit oder ein explizit wiederholbarer Pre-Provider-Fehler darf erneut versucht werden; eine Provider-Aufgabe, die bereits fehlgeschlagen ist, wird nie automatisch erneut gesendet.

DeepSeek-Routen können ein bestehendes Abonnement, ein unbegrenztes Angebot oder ein finanziertes Guthaben verwenden, das der Benutzer autorisiert. Subagent MCP kauft, lädt nie nach oder erhöht dieses Guthaben.

Gleichzeitige Schreiber

Eine Schreibaufgabe kann bis zu 32 repository-relative Datei- oder Verzeichniswurzeln in write_set deklarieren. Externe Schreiber können gleichzeitig ausgeführt werden, wenn ihre kanonischen absoluten Sätze disjunkt sind. Gleiche Pfade und Eltern-/Kind-Pfade kollidieren; Aufgaben- und Spurnamen beeinflussen die Sperrung nicht.

Das Weglassen von write_set gibt der Ausführung den gesamten Arbeitsbereich aus Gründen der Abwärtskompatibilität. Jeder Adapter erzwingt auch die normalisierten Pfade an seiner nativen Umgebungsgrenze. Die aktuelle native DeepSeek-Harness-Sitzung akzeptiert eine beschreibbare Wurzel; eine Multi-Root-Aufgabe wird vom Controller in mehrere disjunkte Schreiberaufrufe zerlegt, statt erweitert zu werden. Echte Einzelsitzungs-Multi-Root bleibt einer zukünftigen Umgebung vorbehalten, die offizielle ACP additionalDirectories bewirbt und nativ durchsetzt. Diese Leases koordinieren Subagent-MCP-Ausführungen; sie sind keine Betriebssystem-Sandbox für unabhängige lokale Prozesse.

Wie es zusammenpasst

flowchart LR
    C["Codex<br/>Main agent & orchestrator"]
    M["Subagent MCP<br/>Gateway"]
    UI["Localhost UI<br/>Settings & activity"]

    C -->|"delegate · steer · observe"| M
    UI --> M

    subgraph E["External agent runtimes — adapter-driven"]
        R1["Model<br/>+<br/>native harness"]
        R2["Model<br/>+<br/>native harness"]
        RN["Future runtimes<br/>via adapters"]
    end

    M -->|"normalized lifecycle"| R1
    M -->|"normalized lifecycle"| R2
    M -->|"normalized lifecycle"| RN

Subagent MCP besitzt Lebenszyklus-Normalisierung, Status, Redaktion, Leases und Schaltkreise. Jeder Adapter übersetzt diesen Vertrag in seine native Umgebung. Siehe Architektur für den vollständigen Vertrag.

Aktualisieren oder Zurücksetzen unter Windows

Wechseln Sie Versionen, ohne eine Umgebung neu zu installieren, die möglicherweise noch läuft. Der erste Befehl verwendet die Quellversion; die Add-/Start-Befehle verwenden die Zielversion. Dieses Beispiel aktualisiert 1.0.13 auf 1.0.14:

uvx --isolated --from subagent-harness-mcp==1.0.12 subagent-harness-mcp ui --stop
codex mcp remove subagent-mcp
codex mcp add subagent-mcp -- uvx --isolated --from subagent-harness-mcp==1.0.14 subagent-harness-mcp serve
uvx --isolated --from subagent-harness-mcp==1.0.14 subagent-harness-mcp ui --background

Starten Sie nach dem Ändern des Eintrags eine frische Codex-Aufgabe. Bestehende Aufgaben behalten ihre alte Laufzeit, bis sie enden. Verwenden Sie dieselbe Sequenz mit den exakten Versionen umgekehrt, um zurückzusetzen.

Ein bereits laufendes MCP, das UPDATE_QUARANTINED meldet, kann den Ersatz nicht sicher heiß laden. Versuchen Sie diesen Residenten nicht erneut; beenden Sie mit nativem Fallback und verwenden Sie die neue exakte Registrierung aus einer frischen Aufgabe.

Für eine einmalige Migration von einem direkten subagent-harness-mcp serve-Eintrag ersetzen Sie zuerst die Registrierung und lassen Sie die alte Aufgabe natürlich enden. Nach dem Ersetzen schließen Sie jedes Codex-Fenster einmal, bevor Sie optional das jetzt ungenutzte persistente Tool entfernen. Es installiert zu lassen ist sicher, weil jeder neue Befehl oben uvx --isolated verwendet.

Subagent MCP bearbeitet keine Codex-Konfiguration, beendet keine Codex-/Provider-Prozesse oder leert uv-Caches von sich aus.

Sicherheit und Abrechnung

• Subagent MCP aktiviert nie Nutzungsguthaben oder ändert Abrechnungseinstellungen.

• Claude-Aufgaben können enthaltenes Abonnementkontingent verbrauchen. Jede Aufgabe validiert die gebundene CLI, Abonnement-Authentifizierung, Anmeldedaten-Priorität und Steuerverbindung und verlangt dann sichere Raten-Nachweise aus derselben Antwort, bevor sie ihre Ausgabe akzeptiert.

• Provider Refresh sendet keinen Modell-Prompt. Wenn die native Umgebung keine exakten Raten-Nachweise vor einer Antwort bereitstellen kann, bleibt der Status unbekannt, statt ein Kontingentergebnis zu erfinden oder eine Reset-Uhr zu verwenden.

• Fallback erfolgt nur nach expliziter Kontingenterschöpfung. Unsichere oder mehrdeutige Nachweise lösen nie eine weitere bezahlte Anfrage aus.

• Native Transkripte bleiben Eigentum der nativen Umgebung. Produktzustand bleibt in expliziten lokalen Wurzeln, und Agentenausgabe muss als nicht vertrauenswürdiger Rat behandelt werden.

Lesen Sie Sicherheit und das Bedrohungsmodell, bevor Sie Schreibzugriff aktivieren.

Projekt

• Architektur

• Adapter-Autoren

• Beitragen

• Änderungsprotokoll

• MIT-Lizenz