Erste Schritte
App verbinden
Einrichtung für deinen Client, mit konkreten Schritten und Befehlen.
Client-Einrichtung
Wähle deine App und folge den Einrichtungsschritten. Die Anleitung erklärt die verfügbaren Anmeldewege und Einschränkungen.
Org-API-Key über bearer_token_env_var — Codex setzt den Authorization-Header selbst.
- Einen Org-API-Key mit dem
create_api_key-Tool aus einer verbundenen Session erzeugen und in der Shell exportieren (z. B.MEINKONTEXT_TOKEN). - Den Block unten in
~/.codex/config.tomleintragen (oder in ein projekt-lokales.codex/config.toml), dann Codex starten.
# ~/.codex/config.toml
[mcp_servers.meinkontext]
url = "https://meinkontext.de/mcp"
# The NAME of the env var, not the key — Codex reads it at start and
# sends Authorization: Bearer itself, so the token stays out of the file.
bearer_token_env_var = "MEINKONTEXT_TOKEN"-
bearer_token_env_varenthält nur den Variablennamen. Den Schlüssel selbst aus Konfigurationsdateien heraushalten und seine Umgebung oder den Secret Store schützen. Siehe offizielle MCP-Anleitung. - Org-scoped Service-Principal — für Objekte read-only (Authoring-Tools sind versteckt), ebenso für Erinnerungen:
recallundsearchfunktionieren,rememberundforgetbrauchen OAuth. -
instructionskommen nur beim Connect — nach einer Tool-Surface-Änderung Codex neu starten, sonst behält die Session den alten Digest. - Mit einer persönlichen OAuth-Verbindung kannst du beauftragen: „Richte meinKontext für dieses Projekt mit
setup_clientein. Bevorzuge passende Skills, Erinnerungen und Wissen ohne erneute Aufforderung.“ Nenne dabei den im Client konfigurierten Verbindungsnamen. Agentenprofile und Org-API-Keys können dieses persönliche Setup nicht ausführen. - Das Tool liefert ein Rezept; dein Agent prüft die wirksame Instruction-Datei und ergänzt ausschließlich seinen markierten Regelblock. Bestehende Regeln bleiben erhalten. Es kopiert keinen Kontext und schaltet kein natives Gedächtnis ab, weist deinen Agenten aber an, dauerhafte Fakten nur in meinKontext zu speichern. Auf ausdrücklichen Wunsch kann es einen lokalen Hook samt Rücknahme-Rezept liefern; der Client muss ihn installieren und freigeben. Unterstützte lokale Versionen erhalten ein Projekt- oder Nutzerrezept; unbekannte Versionen und Browser-/Cloud-Clients Sitzungsanweisungen. Starte danach eine neue Sitzung.
- Zum Prüfen nutzt der Agent
action: "check", zum Entfernenaction: "remove". Ein passender Block-Hash bestätigt nur die vom Client gemeldete Struktur. Eine passende Aufgabe in einer neuen Sitzung zeigt, ob der Agent tatsächlich Skill oder Erinnerung abruft. Bewahre die lokale Installationsquittung auf: Damit lässt sich der unveränderte Block auch ohne Server entfernen. Geänderte oder doppelte Blöcke müssen erst abgeglichen werden. - Für das persönliche Setup nutze statt der obigen Org-API-Key-Konfiguration eine eigene OAuth-Verbindung:
codex mcp add meinkontext-personal --url https://meinkontext.de/mcp, danachcodex mcp login meinkontext-personal. Ihr Setup-Verbindungsname istmeinkontext-personal. Siehe Codex MCP-Authentifizierung.
Variante: von der Kommandozeile hinzufügen
codex mcp addkann dieselbe Konfiguration mit dem Namen der Umgebungsvariable schreiben. Ältere CLI-Versionen benötigen gegebenenfalls die Dateikonfiguration oben.
codex mcp add meinkontext --url https://meinkontext.de/mcp --bearer-token-env-var MEINKONTEXT_TOKEN