OAuth 2.0-Authentifizierung

Übersicht

OAuth 2.0 ist eine Alternative zur API-Schlüssel-Authentifizierung, die allen Benutzern des axe MCP Servers zur Verfügung steht. Es verwendet den Authorization Code Flow mit PKCE und speichert Tokens sicher in Ihrem OS-Schlüsselbund, sodass Sie sich einmal authentifizieren und das CLI die Token-Aktualisierung automatisch verwaltet.

Die Authentifizierung wird verwaltet durch @deque/axe-auth, ein eigenständiges CLI, das Sie separat auf Ihrem Host-Rechner installieren.

Voraussetzungen

• Node.js 22 LTS oder neuer
• Docker installiert und läuft

Schritt 1: Authentifizieren

Führen Sie den Login-Befehl aus:

npx @deque/axe-auth login

Das CLI wird:

1. Ihren Standardbrowser zur Login-Seite öffnen
2. Sie auffordern, sich mit Ihren axe Account-Anmeldeinformationen anzumelden
3. Die resultierenden Tokens sicher in Ihrem System-Schlüsselbund speichern

Wenn fertig, bestätigt das Terminal:

✓ Authenticated.

Sie müssen nur login einmal pro Rechner ausführen. Bei späteren Aufrufen npx @deque/axe-auth token aktualisiert Ihr Zugriffstoken leise mithilfe des gespeicherten Auffrischungstokens.

Private Cloud, Nicht-US-Regionen oder vor Ort Installationen

Wenn Ihre Organisation eine Private Cloud oder eine lokale axe-Instanz verwendet, geben Sie Ihre Instanz-URL mit --server (oder setzen Sie AXE_SERVER_URL Umgebungsvariable):

npx @deque/axe-auth login --server https://your-axe-instance.example.com

Schritt 2: Konfigurieren Sie Ihre IDE

Verwenden Sie @deque/axe-auth token in Ihrer MCP-Client-Konfiguration, um bei jedem Start des Servers ein gültiges Zugriffstoken in den Docker-Container einzufügen. Umwickeln Sie den Docker-Befehl mit sh -c , damit die Shell das Token ersetzen kann — MCP-Konfigurationsdateien sind JSON und expandieren $(...) nicht direkt:

Wählen Sie Ihre IDE für spezifische Anweisungen zur Einrichtung:

• Einrichtung in VS Code mit Copilot
• Einrichtung in Cursor
• Einrichtung in Claude Code

Jede Einrichtungsseite enthält einen OAuth-Konfigurationsabschnitt neben den API-Schlüssel-Anweisungen.

Sitzungen verwalten

Token-Lebensdauer

OAuth-Zugriffstokens sind kurzlebig. Wenn eine Sitzung länger dauert als die Lebensdauer des Tokens, gibt der Server Authentifizierungsfehler zurück.

Lösung: Starten Sie die MCP-Serververbindung in Ihrer IDE neu. Die Konfiguration wird bei jedem Serverstart neu ausgeführt, was automatisch ein frisches Token holt. @deque/axe-auth token .

Abmelden

Um Ihre Tokens serverseitig zu widerrufen und sie aus dem System-Schlüsselbund zu löschen:

npx @deque/axe-auth logout

Wenn das serverseitige Widerrufen fehlschlägt (zum Beispiel aufgrund eines Netzwerkfehlers), werden lokale Tokens dennoch gelöscht und eine Warnung wird ausgegeben.

Erneut authentifizieren

Wenn Ihr Auffrischungstoken abgelaufen oder widerrufen wurde, @deque/axe-auth token beendet mit Code 1 und fordert Sie auf, sich erneut anzumelden. Führen Sie npx @deque/axe-auth login erneut aus. Übergeben Sie --force um die Bestätigungsaufforderung zur erneuten Authentifizierung zu überspringen:

npx @deque/axe-auth login --force

Befehlsreferenz

login

Öffnet einen Browser, führt den OAuth 2.0 Authorization Code + PKCE Flow aus und speichert Tokens im OS-Schlüsselbund.

npx @deque/axe-auth login [options]

token

Gibt ein derzeit gültiges Zugriffstoken an stdout aus. Aktualisiert es stillschweigend, wenn das gespeicherte Token abgelaufen ist. Beendet sich mit dem Code 1 , wenn nicht authentifiziert.

npx @deque/axe-auth token

logout

Widerruft das gespeicherte Aktualisierungstoken serverseitig und löscht den lokalen Schlüsselbund-Eintrag.

npx @deque/axe-auth logout

--help

Zeigt Hilfeinformationen für @deque/axe-auth und dessen Befehle an.

npx @deque/axe-auth --help
npx @deque/axe-auth <command> --help

Plattformunterstützung

System keychain load failed: <details>. On Linux this usually means no D-Bus Secret Service is running (e.g. GNOME Keyring or KWallet).

Fehlerbehebung

Browser wird nicht automatisch geöffnet

Wenn login keinen Browser öffnen kann, druckt es die Autorisierungs-URL auf das Terminal. Kopieren Sie die URL und öffnen Sie sie manuell, um die Authentifizierung abzuschließen.

Token-Ablauf bei langen Sitzungen

Siehe Token-Lebensdauer oben. Starten Sie die MCP-Serververbindung in Ihrer IDE neu, um ein frisches Token zu erhalten.

„Nicht authentifiziert“-Fehler von token

Ihre Sitzung ist abgelaufen oder Tokens wurden gelöscht. Führen Sie npx @deque/axe-auth login erneut aus, um sich erneut zu authentifizieren.

MCP-Server-Authentifizierungsfehler

• Bestätigen Sie nur, dass AXE_ACCESS_TOKEN gesetzt ist (nicht AXE_API_KEY).
• Bestätigen Sie, dass AXE_SERVER_URL mit Ihrer Axe-Instanz-URL übereinstimmt — dies sollte die gleiche URL sein, die bei --server während der Anmeldung verwendet wurde (oder https://axe.deque.com wenn Sie die Standardeinstellungen verwendet haben).
• Führen Sie npx @deque/axe-auth token direkt in Ihrem Terminal aus, um zu bestätigen, dass Sie ein gültiges Token haben.
• Wenn er mit dem Code 1beendet wird, authentifizieren Sie sich erneut mit npx @deque/axe-auth login

Linux-Schlüsselbund nicht verfügbar

Siehe den Plattform-Support -Hinweis oben.