# Formeltrainer – mit einer KI verbinden

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

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

    https://formeln.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 Formeltrainer-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=Formeltrainer&connectorUrl=https%3A%2F%2Fformeln.hydrocode.cloud%2Fmcp

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

1. Führe aus:

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

2. Bitte die Person, in Claude Code `/mcp` einzugeben und „formeltrainer“ zu wählen, dann „Authenticate“.
3. Im Browser öffnet sich der Formeltrainer. 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=Formeltrainer&connectorUrl=https%3A%2F%2Fformeln.hydrocode.cloud%2Fmcp

Danach beim Connector „Verbinden“ tippen, im Fenster des Formeltrainers 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: Formeltrainer.
4. URL: https://formeln.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 Formeltrainers anmelden und „Erlauben“ tippen.
8. In einem Chat über das Werkzeug-Menü (+ oder Schieberegler) den Formeltrainer 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: Formeltrainer.
3. MCP-Server-URL: https://formeln.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 Formeltrainers anmelden und „Erlauben“ tippen.
7. Im Chat den Formeltrainer 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://formeln.hydrocode.cloud/.well-known/oauth-protected-resource und https://formeln.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.
- Ansehen: `get_formulas` zeigt die Fächer mit Termin der nächsten Arbeit, die Formeln und den Lernstand je Formel und Aufgabenart.
- Fach anlegen oder Termin setzen: `save_subject`.
- Formeln eintragen: `save_formulas`. Eine Formel ist Datenmaterial (drei Größen, wie sie zusammenhängen, Wertebereiche, Textvorlagen); jede Aufgabe erzeugt die App daraus neu mit anderen Zahlen. Das Format steht in der Werkzeugbeschreibung. Vorher mit `preview_tasks` ansehen, welche Aufgaben daraus entstehen.
- Auswerten: `get_learning_report` liefert den Lernstand, die falschen Antworten und die Nutzung (Sitzungen, Runden, Pausen, Zeit je Aufgabenart, angesehene Formeln). `get_activity` zeigt einzelne Tage Schritt für Schritt.
- Den Zugang widerrufen: In der App unter Einstellungen → KI-Zugang auf „Widerrufen“ tippen.