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.

Persönliches OAuth (empfohlen): Wähle beim Autorisieren dein Konto oder ein Agentenprofil mit ausgewählten Freigaben. Profilwahl und Einrichtung.

  1. Trage den Server wie unten gezeigt auf Nutzerebene in ~/.kimi-code/mcp.json oder auf Projektebene in .kimi-code/mcp.json im Arbeitsverzeichnis ein. Der HTTP-MCP-Endpoint ist https://meinkontext.de/mcp.
  2. Starte eine neue Kimi-Sitzung. Ein durch Bearbeiten von mcp.json hinzugefügter Server wird nicht in einer bereits offenen Sitzung registriert.
  3. Führe /mcp-config login meinkontext aus und autorisiere im Browser dein meinKontext-Konto oder ein Agentenprofil.
  4. Prüfe mit /mcp den Verbindungsstatus von meinkontext.
json
{
  "mcpServers": {
    "meinkontext": {
      "url": "https://meinkontext.de/mcp"
    }
  }
}
  • Die Datei auf Nutzerebene gilt projektübergreifend und erfordert kein Workspace Trust. Die Datei auf Projektebene gilt nur für dieses Repository und erfordert Workspace Trust. Prüfe die Remote-URL in Kimis Trust-Dialog, bevor du dem Ordner vertraust. Siehe die offizielle Kimi-Code-MCP-Dokumentation.
  • Verwende exakt die URL https://meinkontext.de/mcp. Sie ist die kanonische OAuth-Ressource, für die meinKontext Access Tokens ausstellt.
  • Verbinde dich nach serverseitigen Tool- oder Instructions-Änderungen neu oder starte eine neue Sitzung. Eine laufende Sitzung kann die alten Tool-Definitionen und den alten Katalog-Digest behalten.
  • 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.
Optional: Org-API-Key statt persönlichem OAuth
  • Erzeuge einen Org-API-Key mit dem create_api_key-Tool aus einer verbundenen Sitzung und exportiere ihn in deiner Shell, zum Beispiel als MEINKONTEXT_TOKEN. Die Umgebungsvariable muss beim Start von Kimi vorhanden sein.
  • Verwende den folgenden Server-Eintrag. Durch bearerTokenEnvVar sendet Kimi den Bearer Token aus der benannten Umgebungsvariablen.
json
{
  "mcpServers": {
    "meinkontext": {
      "url": "https://meinkontext.de/mcp",
      "bearerTokenEnvVar": "MEINKONTEXT_TOKEN"
    }
  }
}
  • bearerTokenEnvVar enthält nur den Variablennamen, niemals einen literalen Token. Halte den eigentlichen Schlüssel aus Konfigurationsdateien heraus und schütze seine Umgebung oder den Secret Store.
  • 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.