MCP v0 Editor-Identify (Org-Key)
Was
Bei geteiltem Organisations-Org-Key (sk_agencyos_…, accessScope: organization) in v0 weiß das Cockpit sonst nicht, welche Person gerade schreibt. Editor-Binding ordnet einen v0-Chat (externalChatId) einem Cockpit-Nutzer zu — mit sliding Idle-Timeout (Default 25 Minuten, Env MCP_EDITOR_BINDING_IDLE_MINUTES).
Warum
Journal, Audit und Statistik sollen den echten Redakteur zeigen — nicht nur den Key-Ersteller.
Wer ist betroffen
- Redaktion mit v0 + Org-Key
- MCP-Agenten / v0-Automation
- Betrieb (Env-Secret für Identify-Codes)
Ablauf
Schnellweg (Plattform-Admins): Header neben Center-Switcher → Schlüssel-Icon → „Für v0 anmelden“ (Code erzeugen, Nachricht kopieren, v0-Tab öffnen) → in v0 einfügen.
Alternativ: Frontend-Kanäle oder Mein Konto → MCP — gleicher „Für v0 anmelden“-Button.
Danach in v0:
- Zu Beginn jedes Chats:
cockpit_whoami— prüfteditorBinding.workingAs - Nutzer postet 6-stellige Zahl (allein oder im Satz) → v0 ruft
cockpit_identify_editorauf - Vor Schreiben: kurz „Arbeite als {Name}“
- Nach ~25 Minuten ohne Cockpit-Schreibaktion (Idle): erneut identifizieren
Technik
| Element | Detail |
|---|---|
| Chat-ID | Header X-Cockpit-External-Chat-Id oder MCP-Arg _externalChatId (Remote MCP strippt wie Actor-Token) |
| Identify-API | POST /api/agencyos/v1/mcp/editor/identify — Body { code, centerId? } |
| Code minten | POST /api/account/mcp-identify-code (Dashboard-Session) |
| whoami | GET /api/agencyos/v1/me — Feld editorBinding mit boundUser, expiresAt, workingAs |
| Fehlercode | ERR_EDITOR_NOT_IDENTIFIED (403) |
| Alternative | Actor-Token (X-Cockpit-Actor-Token / _cockpitActorToken) — weiter unterstützt |
v0-Anweisung (Copy-Paste für Redaktion)
Redaktion: Der Text steht in Instruction Teil D (Slot Cockpit Workflow) auf der Seite v0 + Cockpit (So geht’s) — Schritt 0 unter PROJEKT-START. Repo-Kurzreferenz: packages/mcp-cockpit-os/V0_CUSTOM_INSTRUCTIONS.md.
Entwickler — Soft Layer (falls kein Teil D):
Zu Beginn jedes Chats (vor allem anderen):
1. cockpit_whoami aufrufen
2. Wenn editorBinding.required und nicht identified: Nutzer bitten, im Cockpit Code zu holen (60 s — Chat→Code→sofort einfügen), dann cockpit_identify_editor
3. workingAs im Antworttext kurz bestätigen: „Arbeite als {name}“
4. Vor jedem Schreib-Call erneut whoami; bei ERR_EDITOR_NOT_IDENTIFIED → Schritt 2 (~25 min Idle ohne Schreiben)
5. Nur Layout/CSS ohne MCP-Schreiben: keine Journal-Zuordnung — wer sichtbar bleiben will, Schritt 1–3 zu Chatbeginn
Env (Betrieb)
| Variable | Default | Bedeutung |
|---|---|---|
MCP_IDENTIFY_CODE_SECRET | Fallback COCKPIT_ACTOR_TOKEN_SECRET | HMAC für Code-Hash |
MCP_EDITOR_BINDING_IDLE_MINUTES | 25 | Sliding Timeout |
MCP_IDENTIFY_CODE_TTL_SECONDS | 60 | Code-Gültigkeit |
MCP_EDITOR_BINDING_REQUIRED | an | 0/false deaktiviert Enforcement (nur Org-Keys) |
So testen
- Org-Key in MCP-Env,
X-Cockpit-External-Chat-Id: test-chat-1setzen - Schreib-Call ohne Identify → 403
ERR_EDITOR_NOT_IDENTIFIED - Code im Dashboard erzeugen,
cockpit_identify_editor→ Erfolg cockpit_whoami→editorBinding.workingAs= dein Name- Nach 25 min Idle (oder Timeout verkürzen) → erneut 403
Siehe auch
- v0 + Cockpit — Instruction Teil D (Copy-Paste)
- v0-Website A–Z (Redaktion)
- AgencyOS-Integration
- MCP Tool-Referenz —
cockpit_identify_editor,cockpit_whoami
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /developer-guide/mcp-v0-editor-identify