Update hivegrid-cloud reference to latest main

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
davidandClaude Fable 5 committed 2026-07-08 16:15:37 +02:00
1 parent e98d38e716
commit 7b21524c86
3781 files changed
+373484 -225607

No files matched your search

@@ -12,18 +12,31 @@
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:**
- **API-Key-Flow:** generieren → **einmalig** anzeigen → rotieren → widerrufen; **Scope-Auswahl** (read/write je
Domäne: Leads/Kontakte/Projekte/Pipeline/Aufgaben)
- **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 + Key für Claude Desktop/Cursor (Copy-Buttons), Klartext-Schritte
- **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
- [ ] API-Key-Flow (Generieren → einmalig anzeigen → Rotieren → Widerrufen) + Scope-Auswahl
- [ ] 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