meinKontextDocs
Navigation & Suche

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.

  1. Einen Org-API-Key mit dem create_api_key-Tool aus einer verbundenen Session erzeugen und in der Shell exportieren (z. B. MEINKONTEXT_TOKEN).
  2. Den Block unten in ~/.codex/config.toml eintragen (oder in ein projekt-lokales .codex/config.toml), dann Codex starten.
toml
# ~/.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_var enthä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: recall und search funktionieren, remember und forget brauchen OAuth.
  • instructions kommen 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_client ein. 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 Entfernen action: "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, danach codex mcp login meinkontext-personal. Ihr Setup-Verbindungsname ist meinkontext-personal. Siehe Codex MCP-Authentifizierung.
Variante: von der Kommandozeile hinzufügen
  • codex mcp add kann dieselbe Konfiguration mit dem Namen der Umgebungsvariable schreiben. Ältere CLI-Versionen benötigen gegebenenfalls die Dateikonfiguration oben.
bash
codex mcp add meinkontext --url https://meinkontext.de/mcp --bearer-token-env-var MEINKONTEXT_TOKEN