Erste Schritte
Agenten ohne Browser verbinden
Persönlicher MCP-Zugriff per Gerätecode, ohne SSH-Tunnel.
Ein Agent auf einem Raspberry Pi oder Server kann sich per OAuth-Gerätecode anmelden. Wähle dein bestehendes Konto, wenn er mit deinem Kontext arbeiten soll, oder ein separates Konto für unabhängig eigenen Kontext. Ein Gerätecode erzeugt keine eigene verwaltete Agenten-Identität. Konten und Agenten unterscheiden. Die CLI braucht keinen lokalen Browser und keinen Callback-Port. Du bestätigst den Zugriff auf einem anderen Gerät.
Hermes
Trage zuerst die Streamable-HTTP-URL https://meinkontext.de/mcp als MCP-Server mit dem Namen context in Hermes ein. Starte dann:
hermes mcp login context --flow device- Öffne die angezeigte Verifikations-URL auf deinem Rechner oder Smartphone.
- Melde dich mit dem Konto des Agenten an, wenn er eigenen Kontext verwalten soll. Prüfe die angezeigte Konto-Adresse vor der Freigabe.
- Vergleiche den Gerätecode und prüfe Client, Ziel und Rechte. Bestätige nur die Anmeldung, die du selbst gestartet hast.
- Kehre zur CLI zurück. Sie erhält den persönlichen OAuth-Zugriff und speichert ihn in ihrem eigenen Credential Store.
Für ein zweites Konto öffnest du den Link in einem privaten Browserfenster und meldest dich dort mit diesem Konto an. Ein anderer Link wechselt nicht automatisch das angemeldete Konto.
Der Code gilt zwei Stunden. Bei Ablauf startest du den CLI-Befehl erneut. Ein abgelehnter Code kann nicht nachträglich freigegeben werden.
Bei „Zu viele Anfragen“ oder HTTP 429 muss der Client die angegebene Wartezeit beachten und danach mit demselben Code fortfahren, solange er gültig ist. Mehrere Anmeldungen aus demselben Netzwerk teilen sich ein Abfragelimit. Starte die Anmeldung nicht wiederholt neu; ein Client ohne diese Wartefunktion muss zuerst aktualisiert werden.
Zugriff und Grenzen
Der Agent erhält die vorhandenen Rechte seines Kontos. Er kann eigenen Kontext verwalten und freigegebene Inhalte nach den geltenden Regeln nutzen. Plugins und ihre Rechte bleiben separat steuerbar. Der Gerätecode gewährt keine zusätzlichen Organisations- oder Sharing-Rechte.
Org-API-Keys ersetzen diese persönliche Anmeldung nicht: Sie liefern einen Service-Principal und können keine Kontext-Objekte veröffentlichen. Für dauerhaft nutzbare Sitzungen muss der Client den Scope offline_access anfragen und Refresh-Tokens unterstützen.
Andere Clients
Der Client muss RFC 8628 unterstützen. Discovery: OAuth-Metadaten. Registriere ihn für urn:ietf:params:oauth:grant-type:device_code und bei Bedarf refresh_token. Das Ziel ist https://meinkontext.de/mcp. Vorhandene Clients, die nur Authorization Code registriert haben, müssen eine neue passende Registrierung anlegen.
Eine normale Browser-Anmeldung mit PKCE bleibt verfügbar. Unterstützung auf dem Server bedeutet nicht, dass jeder MCP-Client bereits Gerätecodes anbietet.