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

50 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)