2.8 KiB
2.8 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/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.
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)