Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VD-MCP.md
T
2026-07-08 16:15:37 +02:00

2.8 KiB
Raw Blame History

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 von app.hivegrid.de oder api.hivegrid.de.
  • OAuth-/Scope-Verwaltung nutzt die Public-API-Key-/Scope-Mechanik aus VR-P22b als 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)

Quellen

  • AD-26 (KI→MCP-Pivot) · VR-MCP (Backend-Gegenstück)