Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -25,7 +25,7 @@ liefert die **Verwaltungs-UI** dafür. Ersetzt [[VD-P25]] (zurückgestellt).
|
||||
- **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)
|
||||
Leads/Kontakte/Projekte/Pipeline/Aktivitäten/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
|
||||
@@ -34,6 +34,10 @@ liefert die **Verwaltungs-UI** dafür. Ersetzt [[VD-P25]] (zurückgestellt).
|
||||
- **Hinweis zur Reihenfolge:** Screens finalisieren erst nach funktionalem OAuth-Proof aus [[VR-MCP]]; bis dahin ist dieser
|
||||
Screen-Scope ein Design-Zielbild.
|
||||
|
||||
**Backend-Vertrag seit 2026-07-12:** 15 Tools; neue granulare Scopes sind `mcp:activity:read`, `mcp:task:read` und
|
||||
`mcp:task:write`. `mcp:read`/`mcp:write` bleiben die Preset-Bündel. Die erweiterte Auswahl muss diese Scopes benennen,
|
||||
ohne die technischen Scope-Strings als primäre UX-Texte zu zeigen.
|
||||
|
||||
## 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
|
||||
@@ -47,3 +51,26 @@ liefert die **Verwaltungs-UI** dafür. Ersetzt [[VD-P25]] (zurückgestellt).
|
||||
|
||||
## Quellen
|
||||
- [[AD-26]] (KI→MCP-Pivot) · [[VR-MCP]] (Backend-Gegenstück)
|
||||
|
||||
## Umsetzungs-Notiz
|
||||
|
||||
**2026-07-28 — Topbar-Einstieg „Connect MCP" + Setup-Dialog (Interim-UI nach AD-28, ticketunabhängig gebaut).**
|
||||
Nicht der volle A6-Settings-Screen, sondern der Einstiegspunkt davor: eine Box links neben der globalen Suche
|
||||
(Claude-, ChatGPT- und Copilot-Marke + Label), die einen Dialog nach dem Vorbild von Subframes
|
||||
„Connect to code" öffnet. Inhalt: Connector-URL mit Copy-Button, acht aufklappbare Anleitungen
|
||||
(Claude Code, Claude Desktop/claude.ai, ChatGPT, GitHub Copilot, Codex CLI, Gemini CLI, Cursor/Editoren,
|
||||
manuell) und die eigenen aktiven Verbindungen mit Trennen-Aktion.
|
||||
|
||||
- **Erledigt aus der DoD:** Setup-Anleitung, Empty-/Loading-/Error-State mit Klartext, i18n-Keys (de+en),
|
||||
Aktive-Verbindungen-Liste inkl. Widerruf, Permission-/Entitlement-Gate (`featureKeys.mcp`, sonst kein Eintrag).
|
||||
- **Offen:** eigener Settings-Screen mit Sidebar-Eintrag, Scope-Auswahl-Presets, MCP-Audit-Ansicht.
|
||||
→ **2/4 DoD-Punkte = ~50 % done.**
|
||||
- Connector-URL und alle Befehle werden aus `MCP_RESOURCE_URL` abgeleitet, der Servername im Client-Befehl
|
||||
aus dem Produktnamen; Staging zeigt damit automatisch `staging-mcp.…`.
|
||||
- Backend-Nachzug in [[VR-MCP]]: `resolveAuthorizeTenant` nimmt jetzt den aktiven Mandanten
|
||||
(`User.defaultTenantId`) statt der ersten Mitgliedschaft — Clients senden nie einen `tenant`-Parameter.
|
||||
- **Vor dem Prod-Release beachten:** der MCP-Prod-Promote auf `mcp.hivegrid.de` steht laut [[VR-MCP]] noch aus.
|
||||
`featureKeys.mcp` ist blueprint-default aktiv, der Einstieg wäre auf Prod also sichtbar, bevor der Host
|
||||
antwortet. Entweder Promote zuerst oder Launcher hinter einen M006-Feature-Flag hängen (nicht gebaut).
|
||||
- Proof: `pnpm typecheck`, `pnpm lint`, `pnpm test` grün; `verify:i18n`, `verify:source-health` grün;
|
||||
Interim-Baseline als Playwright-Component-Test `tests/component/vd-mcp-connect-interim.ct.tsx`.
|
||||
Reference in new issue
Block a user