KI verbinden – Grundlagen

Alle MCP-Clients sprechen dieselbe Adresse an. Es gibt keine getrennten Endpunkte pro Programm und keine kundenspezifische URL.

https://metisbrain.de/api/mcp

Im Dashboard findest du ihn unter Schnittstellen in der Karte oben, samt Kopierknopf und dem Weg in die Einstellungen des jeweiligen Clients. Der Endpunkt nimmt nur POST an; einen SSE-Stream gibt es nicht.

Am selben Endpunkt gibt es zwei Möglichkeiten, dich auszuweisen. Du musst nur wissen, welche dein Client benutzt.

• Claude (Web und Desktop): OAuth. Endpunkt eintragen, mit dem metisBrain-Konto anmelden, Zugriff bestätigen. Kein Token nötig.
• ChatGPT (Developer Mode): OAuth. Gleicher Ablauf wie bei Claude.
• Cursor: persönliches Token. Der Endpunkt und das Token stehen in einer JSON-Konfiguration.
• Claude Code: persönliches Token, ebenfalls als JSON-Konfiguration.
• VS-Code-Plugin: persönliches Token, aber kein MCP. Das Plugin spricht direkt mit der REST-Schnittstelle.

Bei Claude und ChatGPT trägst du nur die URL ein. Den Rest erledigt der Client:

• Der Client entdeckt automatisch, dass der Endpunkt geschützt ist, und ruft die Anmeldung von metisBrain auf.
• Du landest auf der metisBrain-Seite „Zugriff erlauben?“. Bist du nicht angemeldet, kommt zuerst die Anmeldemaske.
• Du bestätigst mit „Erlauben & verbinden“. Danach ist der Connector aktiv.

Technisch ist das OAuth 2.1 mit PKCE. Der Client bekommt dabei ein Access-Token, das 30 Tage gültig ist. Ein Refresh-Token gibt es nicht: Nach 30 Tagen musst du den Connector einmal neu autorisieren. Das ist der häufigste Grund, warum eine KI plötzlich meldet, sie habe keinen Zugriff mehr.

Cursor und Claude Code bekommen den Endpunkt und dein Token in einer JSON-Konfiguration. Das Token schickt der Client bei jeder Anfrage als Authorization-Header mit.

{
  "mcpServers": {
    "metisBrain": {
      "url": "https://metisbrain.de/api/mcp",
      "headers": { "Authorization": "Bearer mb_DEIN_TOKEN" }
    }
  }
}

Das Token liegt im Dashboard unter Schnittstellen in der Karte „Chats aus Claude Code“. Es beginnt mit mb_ und besteht danach aus Zufallsdaten.

• Token erzeugen: legt dein Token an. Es wird sofort im Klartext angezeigt, kopiere es weg.
• Anzeigen: macht ein bestehendes Token wieder sichtbar, ohne es zu ändern.
• Neu erzeugen: erstellt ein neues Token. Das alte wird im selben Moment ungültig.
• Verbindung trennen: löscht das Token. Deine Chats und Notizen bleiben erhalten.

metisBrain erkennt beim Verbinden, welcher Client sich meldet: Claude, Claude Code, ChatGPT, Cursor oder VS Code. Im Dashboard unter Schnittstellen zeigt die Karte „Verbundene KI-Assistenten“, wer sich zuletzt wann gemeldet hat. Die Anzeige aktualisiert sich von selbst.

Der ehrlichste Test ist trotzdem ein Satz im Chat:

Welche Projekte habe ich in metisBrain?

Kommt eine Liste deiner Projekte zurück, steht die Verbindung. Antwortet die KI stattdessen aus dem Bauch heraus, ist der Connector nicht aktiv.

Ein verbundener Assistent bekommt von metisBrain nicht nur Werkzeuge, sondern auch Verhaltensregeln. Deshalb fragt er zu Beginn einer neuen Unterhaltung genau einmal, ob er diesen Chat speichern soll und zu welchem Projekt er gehört. Sagst du nein, fragt er nicht noch einmal.

Jede Unterhaltung wird eigenständig behandelt. Die Projektwahl aus einem früheren Chat wird nicht übernommen. Willst du das dauerhaft anders, fixierst du ein Projekt (im Chat mit /projekt setFix, im Dashboard mit Fixieren): Dann läuft alles ohne Rückfrage über dieses eine Projekt.