Skip to main content

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:

  1. Zu Beginn jedes Chats: cockpit_whoami — prüft editorBinding.workingAs
  2. Nutzer postet 6-stellige Zahl (allein oder im Satz) → v0 ruft cockpit_identify_editor auf
  3. Vor Schreiben: kurz „Arbeite als {Name}“
  4. Nach ~25 Minuten ohne Cockpit-Schreibaktion (Idle): erneut identifizieren

Technik​

ElementDetail
Chat-IDHeader X-Cockpit-External-Chat-Id oder MCP-Arg _externalChatId (Remote MCP strippt wie Actor-Token)
Identify-APIPOST /api/agencyos/v1/mcp/editor/identify — Body { code, centerId? }
Code mintenPOST /api/account/mcp-identify-code (Dashboard-Session)
whoamiGET /api/agencyos/v1/me — Feld editorBinding mit boundUser, expiresAt, workingAs
FehlercodeERR_EDITOR_NOT_IDENTIFIED (403)
AlternativeActor-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)​

VariableDefaultBedeutung
MCP_IDENTIFY_CODE_SECRETFallback COCKPIT_ACTOR_TOKEN_SECRETHMAC für Code-Hash
MCP_EDITOR_BINDING_IDLE_MINUTES25Sliding Timeout
MCP_IDENTIFY_CODE_TTL_SECONDS60Code-Gültigkeit
MCP_EDITOR_BINDING_REQUIREDan0/false deaktiviert Enforcement (nur Org-Keys)

So testen​

  1. Org-Key in MCP-Env, X-Cockpit-External-Chat-Id: test-chat-1 setzen
  2. Schreib-Call ohne Identify → 403 ERR_EDITOR_NOT_IDENTIFIED
  3. Code im Dashboard erzeugen, cockpit_identify_editor → Erfolg
  4. cockpit_whoami → editorBinding.workingAs = dein Name
  5. Nach 25 min Idle (oder Timeout verkürzen) → erneut 403

Siehe auch​

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/developer-guide/mcp-v0-editor-identify