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.

MCP-Bearer eines eigenen Agentenprofils, gespeichert als GitHub-Agents-Secret. Über Repository-Einstellungen konfigurierte Cloud-Agenten unterstützen kein OAuth für entfernte MCP-Server.

  1. Unter Agenten ein Profil mit den benötigten Lesefreigaben erstellen. Verbindung verwalten wählen, Laufzeit festlegen und ein neues Credential ausstellen. Ein Organisations-API-Key ist nicht grundsätzlich schreibgeschützt. Agenten einrichten.
  2. Als Repository-Administrator Bearer gefolgt vom ausgestellten Credential als Agents-Secret COPILOT_MCP_MEINKONTEXT_AUTHORIZATION speichern. Der vollständige Wert gehört ausschließlich in den Secret Store.
  3. Unter Settings → Copilot → MCP servers im Repository das JSON unten zu vorhandener Konfiguration hinzufügen und speichern. Ältere Oberflächen zeigen dies unter Coding agent. Nur Tools behalten, die das Profil tatsächlich sieht und die deine Aufgabe benötigt.
  4. Eine neue Cloud-Agenten-Aufgabe starten: verfügbare meinKontext-Objekte auflisten, ohne etwas zu ändern. Den Aufruf von list_objects und dessen Ergebnis prüfen. Bei Ablauf das Secret erneuern; bei Zugriffsende das Credential in meinKontext widerrufen.
json
{
  "mcpServers": {
    "meinkontext": {
      "type": "http",
      "url": "https://meinkontext.de/mcp",
      "headers": {
        "Authorization": "$COPILOT_MCP_MEINKONTEXT_AUTHORIZATION"
      },
      "tools": ["list_objects", "get_object", "use_skill", "recall", "search"]
    }
  }
}
  • Der Cloud-Agent kann freigegebene Tools ohne einzelne Rückfrage aufrufen. Seine Repository-MCP-Konfiguration unterstützt Tools, keine Ressourcen oder Prompts. Die Tool-Liste erteilt keine zusätzlichen Rechte auf dem Server. GitHub-Konfigurationsanleitung.
  • Bei HTTP 401 Ablauf, Umgebung, Secret-Name und das Präfix Bearer prüfen. Bei HTTP 403 oder fehlenden Tools die Profilfreigaben prüfen. Authorization-Header niemals in Logs übernehmen.
  • Für die interaktive Browser-Anmeldung gibt es VS Code und Copilot CLI.
  • Am 31. Oktober 2026 anhand offizieller Dokumentation recherchiert; ein Tool-Aufruf eines echten Copilot-Cloud-Agenten gegen meinKontext ist noch nicht verifiziert. Diese Einrichtung belegt keine selbstständige Nutzung von Skills oder Gedächtnis.