Fuxam Student MCP

Nutze Codex, Claude und andere lokale MCP-Clients, um deine Fuxam-Module, Lerneinheiten, deinen Fortschritt, deinen Stundenplan und deine Semesteroptionen zu erkunden.

Der Server läuft auf deinem Computer und kommuniziert direkt mit Fuxam. Er liefert dem Agenten nützliche Fakten aus der Quelle und kombinierbare Werkzeuge, anstatt zu versuchen, ein Semester für dich auszuwählen.

Lass deinen Agenten die Einrichtung übernehmen

Kopiere diesen Prompt in einen neuen Chat mit Codex oder Claude:

Set up Fuxam Student MCP for me using this documentation:
https://codecampus.tools/docs/fuxam-student-mcp

Detect which supported MCP client I am using and follow only its current instructions. Install the latest public release locally and configure it as a stdio MCP server. Complete every step you can directly, and pause only for a client UI or secret-entry action I must perform.

Never ask me to paste my Fuxam `__client` cookie into this chat, and never print or log it. When the credential is required, tell me exactly how to enter it directly into the client's local MCP configuration or secure installer prompt.

After configuration:
1. Verify the MCP entry exists without displaying the credential.
2. Start the server and confirm its tools are available.
3. Tell me if I need to restart the client or open a new chat.
4. Run one read-only check: show the module categories and learning units I can currently choose from.

Do not book or unbook courses, or join or leave waitlists, during setup.

Du installierst lieber selbst? Folge den manuellen Schritten unten.

Voraussetzungen

• Ein Fuxam-Konto der CODE University

• Node.js 26 oder neuer für die Installation über die Befehlszeile

• Codex, Claude Code oder Claude Desktop

Dein Fuxam-Sitzungscookie abrufen

Fuxams kurzlebige Sitzungstokens werden über das Clerk-__client-Cookie erneuert.

1. Melde dich in deinem Browser bei fuxam.app an.

2. Öffne die Entwicklertools des Browsers.

3. Wähle in der Cookie-Ansicht unter Anwendung/Speicher https://clerk.fuxam.app aus.

4. Kopiere den Wert des __client-Cookies.

Behandle diesen Wert wie ein Passwort. Füge ihn nicht in Chats ein, committe ihn nicht und zeige ihn nicht in Screenshots.

Installation

ChatGPT-/Codex-App und Codex-CLI

Die installierte ChatGPT-/Codex-App und die Codex-CLI teilen sich die lokale Codex-MCP-Konfiguration:

codex mcp add fuxam \
  --env FUXAM_CLERK_CLIENT='<your __client cookie>' \
  -- npx -y fuxam-student-mcp

Öffne nach dem Hinzufügen des Servers eine neue Codex-Aufgabe.

Claude Code

claude mcp add --scope user \
  -e FUXAM_CLERK_CLIENT='<your __client cookie>' \
  fuxam -- npx -y fuxam-student-mcp

Claude Desktop

Lade die .mcpb-Datei aus dem passenden GitHub-Release herunter, öffne sie mit Claude Desktop und füge das Clerk-Cookie ein, wenn du dazu aufgefordert wirst. Das Bundle führt dasselbe MCP lokal aus und markiert das Cookie als sensible Konfiguration.

Andere lokale MCP-Clients

Konfiguriere einen stdio-Server mit dieser ausführbaren Datei und dieser Umgebungsvariable:

{
  "command": "npx",
  "args": ["-y", "fuxam-student-mcp"],
  "env": {
    "FUXAM_CLERK_CLIENT": "<your __client cookie>"
  }
}

Der äußere Konfigurationsschlüssel unterscheidet sich je nach Client. Verwende die normalen lokalen stdio-MCP-Einstellungen des Clients.

Ausprobieren

Gute erste Prompts sind zum Beispiel:

• „Zeig mir die Modulkategorien und Lerneinheiten, aus denen ich aktuell wählen kann.“

• „Hilf mir, diese drei Module zu vergleichen, einschließlich Voraussetzungen, Fortschritt, Dozierenden, Terminen und Arbeitsaufwand.“

• „Schau dir meinen Studienplan und meinen aktuellen Fortschritt an und hilf mir dann, ein realistisches Semester zusammenzustellen.“

• „Prüfe, ob dieser vorgeschlagene Satz von Lerneinheiten Terminkonflikte aufweist.“

• „Welche Fristen und Termine habe ich im nächsten Monat?“

Der Agent kann nach Kategorie/Tag oder Text stöbern, Module und Lerneinheiten stapelweise prüfen, das Ergebnis mit deinem Fortschritt vergleichen und einen vorgeschlagenen Kursatz auf Konflikte prüfen.

Funktionen

Planung und Erkundung:

• explore_learning_options

• search_fuxam

• get_study_plan

• list_enrolled_courses

• list_bookable_courses

• get_learning_unit_details

• get_module_details

• get_module_attempts

• get_exam_details

Stundenplan und Arbeitsaufwand:

• list_student_appointments

• list_course_appointments

• list_course_deadlines

• list_applicable_excluded_dates

• list_todos

• list_pinned_courses

• get_layer_path

• check_course_conflicts

Kontoänderungen:

• book_course

• unbook_course

• join_waitlist

• leave_waitlist

Die vier Kontoänderungs-Werkzeuge wirken sich auf dein echtes Fuxam-Konto aus. Sie sind für MCP-Clients als Schreiboperationen markiert, und jede Änderung überprüft den resultierenden Fuxam-Zustand. Die Buchung führt nicht stillschweigend zuerst eine Konfliktprüfung durch.

Wie Agenten es verwenden sollten

Beginne bei offener Planung mit explore_learning_options und list_enrolled_courses. Grenze nach Kategorie oder Suchanfrage ein, prüfe dann die engere Auswahl stapelweise über get_module_details, get_learning_unit_details und get_module_attempts. Prüfe den vollständigen vorgeschlagenen Satz mit check_course_conflicts, bevor du die Abwägungen präsentierst.

Die Bezeichner sind wichtig:

• Die Kurs-id wird für Buchungen, Wartelisten und Konfliktprüfungen verwendet;

• layerId oder layer_id wird für Termine und Fristen verwendet;

• courseModuleId ist die stabile Modul-ID;

• moduleVersionId identifiziert eine Curriculum-Version;

• organizationTermId identifiziert ein akademisches Semester.

Die aus Fuxam-Importen abgeleiteten Abschluss-Summen können gelegentlich hinter konkreten Versuchs- oder gradedAt-Datensätzen zurückbleiben. Agenten sollten bei Abweichungen die konkreten Datensätze bevorzugen.

Fehlerbehebung

FUXAM_AUTH_REQUIRED

: Melde dich erneut bei Fuxam an, kopiere das aktuelle Clerk-__client-Cookie, entferne den alten MCP-Eintrag und füge ihn mit dem neuen Wert wieder hinzu.

codex mcp remove fuxam
claude mcp remove --scope user fuxam

FUXAM_UNSUPPORTED_INSTITUTION

: Diese Version unterstützt die Fuxam-Umgebung der CODE University.

FUXAM_CONTEXT_REQUIRED

: Der Server konnte keinen aktiven Kohorten- und Studienprogramm-Kontext identifizieren. Gib beim Eröffnen eines Issues den vollständigen Fehler an, aber niemals dein Cookie, Header oder rohe Fuxam-Antwortdaten.

Teilergebnisse

: Einige kuratierte Abfragen kombinieren mehrere Fuxam-Bereiche. Wenn ein optionaler vorgelagerter Bereich vorübergehend nicht verfügbar ist, gibt das MCP die Bereiche zurück, die es abrufen konnte, mit partial: true und kennzeichnet, was erneut versucht werden kann.

Datenschutz

Version 0.1 erhebt keine Telemetrie. Deine Fuxam-Anmeldedaten und deine Studiendaten bleiben auf deinem Computer, abgesehen von direkten Anfragen des lokalen MCP an Fuxam und Clerk. Tool-Ergebnisse werden an den von dir gewählten MCP-Client gesendet und unterliegen dessen eigenen Datenkontrollen.

Lizenz

Die nichtkommerzielle Nutzung ist unter der PolyForm Noncommercial License 1.0.0 lizenziert. Für die kommerzielle Nutzung ist eine separate schriftliche Lizenz von Maximilian Spitzer erforderlich; kontaktiere den Autor über GitHub.

Entwicklung

npm ci
npm run check
npm run test:package
npm run package:mcpb

Der Paket-Smoke-Test installiert das generierte npm-Tarball in einem sauberen temporären Verzeichnis, verhandelt MCP über stdio, listet seine Tools auf und überprüft das Verhalten beim Start ohne Anmeldedaten. Tests verwenden niemals echte Studierenden-Anmeldedaten oder führen eine Fuxam-Änderung durch.

Projektstatus

Dies ist ein inoffizieller, von Studierenden gebauter Client, der mit Genehmigung von CODE University und Fuxam veröffentlicht wurde. Fuxam bleibt die maßgebliche Quelle für akademische Aufzeichnungen, Voraussetzungen, Verfügbarkeit und Kontostatus.