4.9 KiB
VD-MCP · Screens MCP-Server (Verbindungen/Settings)
| Typ | Screen (Design) |
| Owner | David |
| Phase | v2-P4 — MCP (bedient VR-MCP, AD-26) |
| Cycle/Fenster | v2-W1 — Public-API/Postfach/Abo/KI-Start · Start 16.–20.07. · fällig 2026-07-20 |
| Status | geplant (NEU — KI→MCP-Pivot) |
Entscheidung / Kontext (AD-26)
KI→MCP-Pivot: keine HiveMind/RAG-UI. HiveGrid wird MCP-Server, an den externe KI-Clients andocken. Dieses Screen-Ticket liefert die Verwaltungs-UI dafür. Ersetzt VD-P25 (zurückgestellt).
Host-/Connector-Contract
- Connector-URL in der UI ist
https://mcp.hivegrid.de(staging:https://staging-mcp.hivegrid.de). - MCP ist ein eigener Service/Container
hivegrid-mcp, nicht Teil vonapp.hivegrid.deoderapi.hivegrid.de. - OAuth-/Scope-Verwaltung nutzt die Public-API-Key-/Scope-Mechanik aus
VR-P22bals Backend-Grundlage, aber der primäre Nutzerflow ist OAuth Connect statt API-Key-Copy. Die UI muss klar zwischen API-Verbindungen (api.hivegrid.de) und MCP-Verbindungen (mcp.hivegrid.de) unterscheiden.
Benötigte Screens (A6 Settings-Archetyp)
- MCP-Verbindungen / Settings:
- OAuth-Connect-Flow: Client auswählen (Claude/ChatGPT/Cursor/VS Code/manuell) → Berechtigungen wählen → HiveGrid-Consent → erfolgreich verbunden; API-Key-Copy nur als Advanced-/Fallback-Modus
- Scope-Auswahl: Presets „Nur lesen", „Lesen + schreiben", „Erweitert" (read/write je Domäne: Leads/Kontakte/Projekte/Pipeline/Aktivitäten/Aufgaben)
- Aktive Verbindungen: Liste (Client/Bezeichnung, vergebene Scopes, letzte Nutzung), einzeln trennbar
- Setup-Anleitung: Connector-URL
https://mcp.hivegrid.de, OAuth-fähige Client-Schritte, Copy-Buttons nur für Clients ohne automatische Discovery/Connect-Unterstützung - MCP-Audit: Verlauf der Tool-Aufrufe (wer/welcher Client, welches Tool, wann, Read/Write) — Lesezugriff auf den M001-Audit-Trail, gefiltert auf MCP-Actor
- Hinweis zur Reihenfolge: Screens finalisieren erst nach funktionalem OAuth-Proof aus VR-MCP; bis dahin ist dieser Screen-Scope ein Design-Zielbild.
Backend-Vertrag seit 2026-07-12: 15 Tools; neue granulare Scopes sind mcp:activity:read, mcp:task:read und
mcp:task:write. mcp:read/mcp:write bleiben die Preset-Bündel. Die erweiterte Auswahl muss diese Scopes benennen,
ohne die technischen Scope-Strings als primäre UX-Texte zu zeigen.
Definition of Done
- Connection-Settings-Screen (Subframe-Pflicht, A6) — Sidebar-Eintrag + Permission-Gate
- OAuth-Connect-Flow (Client-Auswahl → Consent → Success/Error) + Scope-Auswahl; API-Key-Fallback als Advanced-Modus
- Aktive-Verbindungen-Liste + MCP-Audit-Ansicht
- Setup-Anleitung + Empty-State/Loading-State mit Klartext; i18n-Keys für alle Texte
Abhängigkeiten
- blocked-by:
D-D0a(App-Shell),D-D0b(Archetyp A6 Settings) - bedient (Dev): VR-MCP
- Ersetzt: VD-P25 (zurückgestellt)
Quellen
Umsetzungs-Notiz
2026-07-28 — Topbar-Einstieg „Connect MCP" + Setup-Dialog (Interim-UI nach AD-28, ticketunabhängig gebaut). Nicht der volle A6-Settings-Screen, sondern der Einstiegspunkt davor: eine Box links neben der globalen Suche (Claude-, ChatGPT- und Copilot-Marke + Label), die einen Dialog nach dem Vorbild von Subframes „Connect to code" öffnet. Inhalt: Connector-URL mit Copy-Button, acht aufklappbare Anleitungen (Claude Code, Claude Desktop/claude.ai, ChatGPT, GitHub Copilot, Codex CLI, Gemini CLI, Cursor/Editoren, manuell) und die eigenen aktiven Verbindungen mit Trennen-Aktion.
- Erledigt aus der DoD: Setup-Anleitung, Empty-/Loading-/Error-State mit Klartext, i18n-Keys (de+en),
Aktive-Verbindungen-Liste inkl. Widerruf, Permission-/Entitlement-Gate (
featureKeys.mcp, sonst kein Eintrag). - Offen: eigener Settings-Screen mit Sidebar-Eintrag, Scope-Auswahl-Presets, MCP-Audit-Ansicht. → 2/4 DoD-Punkte = ~50 % done.
- Connector-URL und alle Befehle werden aus
MCP_RESOURCE_URLabgeleitet, der Servername im Client-Befehl aus dem Produktnamen; Staging zeigt damit automatischstaging-mcp.…. - Backend-Nachzug in VR-MCP:
resolveAuthorizeTenantnimmt jetzt den aktiven Mandanten (User.defaultTenantId) statt der ersten Mitgliedschaft — Clients senden nie einentenant-Parameter. - Vor dem Prod-Release beachten: der MCP-Prod-Promote auf
mcp.hivegrid.desteht laut VR-MCP noch aus.featureKeys.mcpist blueprint-default aktiv, der Einstieg wäre auf Prod also sichtbar, bevor der Host antwortet. Entweder Promote zuerst oder Launcher hinter einen M006-Feature-Flag hängen (nicht gebaut). - Proof:
pnpm typecheck,pnpm lint,pnpm testgrün;verify:i18n,verify:source-healthgrün; Interim-Baseline als Playwright-Component-Testtests/component/vd-mcp-connect-interim.ct.tsx.