From 66df1696cc0e614497ea5c7ba36d222ce8413c1e Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Wed, 18 Nov 2026 12:55:17 +0100 Subject: [PATCH] Explain curl and bearer authentication in MCP token management --- docs/mvp-completion-plan.md | 2 +- web/src/mcp-token-management.tsx | 40 ++++++++++++++++++++++++++++++++ 2 files changed, 41 insertions(+), 1 deletion(-) diff --git a/docs/mvp-completion-plan.md b/docs/mvp-completion-plan.md index da7522a..b08a455 100644 --- a/docs/mvp-completion-plan.md +++ b/docs/mvp-completion-plan.md @@ -19,7 +19,7 @@ | Funktion | Im Entwicklungssystem nachgewiesen | Nächster Schritt oder Beleg | | --- | --- | --- | -| Server, WebUI und MCP | Dedizierter ARM64-Server mit TLS, getrenntem Gerätegateway und öffentlicher Verwaltung mit Passwort/TOTP und scoped MCP-Tokens. Die WebUI genehmigte je eine feste Skriptrevision auf Linux und Windows. MCP und WebUI lieferten dieselbe Ausgabe und dieselbe Versuch-ID. | [Ergebnisse beider Geräte](evidence/script-library-acceptance-20261117.json) | +| Server, WebUI und MCP | Dedizierter ARM64-Server mit TLS, getrenntem Gerätegateway und öffentlicher Verwaltung mit Passwort/TOTP und scoped MCP-Tokens. Die WebUI genehmigte je eine feste Skriptrevision auf Linux und Windows. MCP und WebUI lieferten dieselbe Ausgabe und dieselbe Versuch-ID. | Die [curl-Hilfe](../web/src/mcp-token-management.tsx) zur Bearer-Anmeldung ist lokal gebaut und im Browser geprüft. Das angezeigte Beispiel listete Werkzeuge an einem simulierten MCP-Endpunkt. Der öffentliche Endpunkt wies ein ungültiges Token mit HTTP 401 ab. Die öffentliche Bereitstellung der ergänzten WebUI steht aus. [Ergebnisse beider Geräte](evidence/script-library-acceptance-20261117.json) | | Linux- und Windows-Client | Auf beiden Gästen HTTPS-Polling mit mehreren echten Kontakten. Ein Leerlaufkontakt übermittelt Inventar und Heartbeats auch bei leerer Auftragsliste. | [Bereinigung und Geräteabgleich](evidence/dev-cleanup-pull-20261117.json) | | Skriptbibliothek | Versionierte, mandantengebundene Skripte, feste Revision im Plan, WebUI und MCP. Die Windows-Update-Vorlage ist enthalten. | KB890830 v5.147 über den festen SYSTEM-Bibliotheksauftrag installiert. [Installationsbeleg](evidence/windows-update-installation-20261117.json) | | Veröffentlichung und Erstaufnahme | Auf dem dedizierten Server liegen signierte Linux- und Windows-GNU-Releases. Beide öffentlichen Installer wurden mit einem per WebUI erzeugten Einmalcode auf den Testgästen erfolgreich ausgeführt. | Regulärer PowerShell-Auftrag auf dem frisch aufgenommenen Windows-Gerät mit Exitcode 0. | diff --git a/web/src/mcp-token-management.tsx b/web/src/mcp-token-management.tsx index 87f3f61..ea20af8 100644 --- a/web/src/mcp-token-management.tsx +++ b/web/src/mcp-token-management.tsx @@ -93,6 +93,45 @@ function requestFailure(error: unknown, fallback: string): string { return fallback; } +function McpCurlHelp() { + const endpoint = new URL('/mcp', window.location.origin).href; + return
+ MCP mit curl verwenden +

Verwenden Sie den erstellten Token bei jeder Anfrage an {endpoint} im HTTP-Header Authorization: Bearer <MCP-Token>.

+

Führen Sie das Beispiel in Bash aus und fügen Sie den Token bei der verdeckten Eingabe ein. Das Beispiel startet eine Sitzung und listet die MCP-Werkzeuge auf.

+
{String.raw`(
+  set -o pipefail
+  read -rsp 'MCP-Token: ' mcp_token || exit 1
+  printf '\n'
+
+  mcp() {
+    curl --fail --silent --show-error '${endpoint}' \
+      --header @- \
+      --header 'Content-Type: application/json' \
+      --header 'Accept: application/json, text/event-stream' \
+      --header 'MCP-Protocol-Version: 2025-11-25' \
+      "$@" <<< "Authorization: Bearer $mcp_token"
+  }
+
+  session_id=$(mcp --dump-header - --output /dev/null --data '{
+    "jsonrpc":"2.0","id":1,"method":"initialize","params":{
+      "protocolVersion":"2025-11-25","capabilities":{},
+      "clientInfo":{"name":"curl","version":"1.0"}
+    }
+  }' | awk 'tolower($1) == "mcp-session-id:" { sub(/\r$/, "", $2); print $2 }') || exit 1
+  if [ -z "$session_id" ]; then
+    printf '%s\n' 'Der Server hat keine MCP-Sitzungs-ID geliefert.' >&2
+    exit 1
+  fi
+
+  mcp --header "Mcp-Session-Id: $session_id" \
+    --data '{"jsonrpc":"2.0","method":"notifications/initialized"}' || exit 1
+  mcp --header "Mcp-Session-Id: $session_id" \
+    --data '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
+)`}
+
; +} + export function McpTokenManagement({ auth, tenantId }: { auth: Session; tenantId: string }) { if (!canManageMcpTokens(auth, tenantId)) return null; // Reset even an in-flight creation when the actual session, tenant or rights change. @@ -221,6 +260,7 @@ function TokenManagement({ auth, tenantId }: { auth: Session; tenantId: string } {listing.allowed_scopes.length === 0 &&

Ihre Mitgliedschaft bietet keine Rechte für ein MCP-Token.

} +

Ausgestellte Tokens

{!listing.tokens.length ?

Es wurden noch keine Tokens erstellt.

: