50 lines
2.8 KiB
Markdown
50 lines
2.8 KiB
Markdown
# 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)
|