Explain curl and bearer authentication in MCP token management
Rust development slice / linux (push) Failing after 15s

This commit is contained in:
2026-11-18 12:55:17 +01:00
parent 2aa460e337
commit 66df1696cc
2 changed files with 41 additions and 1 deletions
+1 -1
View File
@@ -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. |
+40
View File
@@ -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 <details>
<summary>MCP mit curl verwenden</summary>
<p>Verwenden Sie den erstellten Token bei jeder Anfrage an <code>{endpoint}</code> im HTTP-Header <code>Authorization: Bearer &lt;MCP-Token&gt;</code>.</p>
<p>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.</p>
<pre><code>{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"}'
)`}</code></pre>
</details>;
}
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 }
</fieldset>
{listing.allowed_scopes.length === 0 && <p>Ihre Mitgliedschaft bietet keine Rechte für ein MCP-Token.</p>}
</form>
<McpCurlHelp/>
<h3>Ausgestellte Tokens</h3>
<button type="button" disabled={busy} onClick={() => { setError(''); setReload(value => value + 1); }}>Tokenliste aktualisieren</button>
{!listing.tokens.length ? <p>Es wurden noch keine Tokens erstellt.</p> : <div className="table"><table>