# Lernplan – mit einer KI verbinden

> Anleitung für KI-Assistenten (Claude, ChatGPT und andere). Wenn dich jemand bittet, dich mit lernplan.hydrocode.cloud zu verbinden, findest du hier alles dafür. Antworte der Person auf Deutsch, Schritt für Schritt und ohne Fachbegriffe.

Der Lernplan bietet einen MCP-Server (Streamable HTTP) mit Anmeldung über OAuth:

    https://lernplan.hydrocode.cloud/mcp

So läuft die Verbindung ab:
- Es gibt keinen Schlüssel, der abgetippt werden muss. Die KI-Anwendung registriert sich selbst (Dynamic Client Registration).
- Die Person meldet sich dann im Browser mit ihrem Lernplan-Konto an und tippt auf „Erlauben“.
- Erlauben dürfen nur Owner einer Familie.
- Den Login kannst du der Person nicht abnehmen. Frag sie niemals nach ihrem Passwort.

**Wichtig:** Außer in Claude Code kannst du die Verbindung nicht selbst anlegen, auch nicht durch Aufrufen dieser Seite oder der MCP-Adresse. Versuch es nicht. Such stattdessen unten den Abschnitt für die Anwendung, in der du gerade läufst, und gib der Person den Link bzw. die Schritte von dort. Nenne ihr die MCP-Adresse wörtlich, damit sie sie kopieren kann.

Am einfachsten ist Claude. Dieser Link öffnet das passende Fenster in claude.ai mit Name und Adresse schon ausgefüllt:

    https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Lernplan&connectorUrl=https%3A%2F%2Flernplan.hydrocode.cloud%2Fmcp

## Claude Code (du kannst Befehle ausführen)

1. Führe aus:

       claude mcp add --transport http lernplan https://lernplan.hydrocode.cloud/mcp

2. Bitte die Person, in Claude Code `/mcp` einzugeben und „lernplan“ zu wählen, dann „Authenticate“.
3. Im Browser öffnet sich der Lernplan. Dort anmelden und „Erlauben“ tippen.
4. Die Werkzeuge stehen danach in einer neuen Sitzung zur Verfügung.

## claude.ai, Claude Desktop und die Claude-App

Connectors kannst du dort nicht selbst anlegen. Am schnellsten geht es mit diesem Link (Name und Adresse sind schon ausgefüllt, die Person bestätigt nur noch):

    https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Lernplan&connectorUrl=https%3A%2F%2Flernplan.hydrocode.cloud%2Fmcp

Danach beim Connector „Verbinden“ tippen, im Fenster des Lernplans anmelden und „Erlauben“ tippen.

Ohne Link führst du die Person durch diese Schritte:

1. Links unten auf den Namen tippen, dann Einstellungen → Connectors.
2. „Benutzerdefinierten Connector hinzufügen“ wählen (englisch „Add custom connector“).
3. Name: Lernplan.
4. URL: https://lernplan.hydrocode.cloud/mcp
5. Die erweiterten Einstellungen (OAuth Client ID und Secret) leer lassen.
6. „Hinzufügen“, danach beim Connector „Verbinden“.
7. Im Fenster des Lernplans anmelden und „Erlauben“ tippen.
8. In einem Chat über das Werkzeug-Menü (+ oder Schieberegler) den Lernplan einschalten.

Hinweise:
- In Team- und Enterprise-Organisationen darf nur ein Admin Connectors hinzufügen.
- Ein in claude.ai angelegter Connector steht auch in Claude Desktop und der Claude-App zur Verfügung.

## ChatGPT

Connectors kannst du dort nicht selbst anlegen, und es gibt keinen Link, der das Fenster vorausfüllt. Sag der Person vorab ehrlich:
- Eigene MCP-Server gehen nicht in jedem Abo. Im kostenlosen Abo fehlen sie, bei Plus und Pro hängt es vom Stand der Einführung ab.
- Anlegen geht nur auf chatgpt.com im Browser am Computer, nicht in der Handy-App.
- Die Menüs heißen je nach Version etwas anders.

Führe die Person dann durch diese Schritte:

1. https://chatgpt.com/plugins öffnen, dort auf „+“ und „Add custom MCP server“ (bzw. „Eigenen MCP-Server hinzufügen“).
   Ältere Versionen: Einstellungen → Apps und Connectors → Erweitert → „Entwicklermodus“ einschalten, dann „Erstellen“.
2. Name: Lernplan.
3. MCP-Server-URL: https://lernplan.hydrocode.cloud/mcp
4. Authentifizierung: OAuth. Client ID und Secret leer lassen.
5. Den Hinweis zu eigenen Servern bestätigen und anlegen.
6. Im Fenster des Lernplans anmelden und „Erlauben“ tippen.
7. Im Chat den Lernplan mit @ oder über + auswählen.

Klappt es nicht, weil das Abo es nicht hergibt: Empfiehl Claude (siehe oben), dort reicht der Link.

## Gemini

Sag der Person ehrlich: In der Gemini-App lassen sich eigene MCP-Server derzeit nur in den USA, auf Englisch und mit privaten Konten hinzufügen. Aus Deutschland geht es praktisch nicht. Empfiehl stattdessen Claude (siehe oben).

## Andere MCP-Clients

- Remote-MCP über HTTP mit OAuth 2.1, PKCE (S256) und Dynamic Client Registration.
- Metadaten: https://lernplan.hydrocode.cloud/.well-known/oauth-protected-resource und https://lernplan.hydrocode.cloud/.well-known/oauth-authorization-server
- Ohne OAuth: Ein Owner legt in der App unter Einstellungen → KI-Zugang einen Schlüssel an. Er wird als `Authorization: Bearer <Schlüssel>` mitgeschickt.

## Nach dem Verbinden

- Rufe zuerst `list_profiles` auf. Gib danach bei jedem Werkzeug die `profileId` an. Wenn unklar ist, für wen etwas gedacht ist, frag nach.
- Plan ansehen: `get_plan` zeigt Arbeiten (Gantt) und alle Einheiten mit Stand (offen, begonnen, fertig).
- Plan anlegen oder ändern: `save_plan` mit allen Arbeiten (Fach, Termin, Lernzeitraum, Anzahl 20-Minuten-Einheiten, intensiv/standard).
- Einheiten planen und schreiben: `save_units`. Ohne `content` nur Tagesplan (Titel, Tag); mit `content` der Lernzettel mit Einstieg, Aufgaben, Tipps und Links. Das Format steht in der Werkzeugbeschreibung.
- Inhalt einer Einheit lesen, um ihn zu ändern: `get_unit`.
- Auswerten: `get_unit_report` liefert pro Einheit jeden Prüfversuch, wann Tipp und Lösung geöffnet wurden und welche Links. `get_progress` fasst den Plan zusammen.
- Den Zugang widerrufen: In der App unter Einstellungen → KI-Zugang auf „Widerrufen“ tippen.