MCP — Eduskript via claude.ai, Cursor & Claude Code

Eduskript stellt einen Model Context Protocol-Server bereit, damit du Inhalte in natürlicher Sprache aus deinem AI-Tooling heraus verfassen kannst. Du richtest claude.ai (oder Cursor oder Claude Code) auf deine Eduskript-Instanz aus, meldest dich einmal in einem Browser-Tab an, und die AI erhält begrenzten Zugriff auf deine Skripte.

Der Server ist pro Lehrperson begrenzt: Dein Token kann nur Inhalte lesen und bearbeiten, die du verfasst oder mitverfasst hast. Inhalte anderer Lehrpersonen sind unsichtbar.

Was du tun kannst

Der Server stellt Tools für Discovery, Lesen, Erstellen, Aktualisieren, Organisieren und Versionsverlauf bereit.

Entdecken und suchen

Tool	Was es macht
`get_eduskript_context`	Plattformüberblick, Markdown-Syntax-Referenz und deine AI-Präferenzen — einmal pro Sitzung aufrufen
`list_my_skripts`	Listet die Skripte auf, die du verfasst hast
`list_my_sites`	Listet deine Sites auf
`search_my_content`	Substring-Suche über deine verfassten Inhalte
`resolve_page_url`	Ermittelt die öffentliche URL einer Seite anhand ihrer ID

Lesen

Tool	Was es macht
`read_skript`	Liest die Metadaten und Seitenliste eines Skripts
`read_page`	Liest den vollständigen Markdown-Inhalt einer Seite
`read_collection`	Liest die Metadaten und Skriptliste einer Collection
`read_site_frontpage`	Liest den Inhalt der Frontseite deiner Site
`read_skript_frontpage`	Liest den Inhalt der Frontseite eines Skripts

Erstellen

Tool	Was es macht
`create_skript`	Erstellt ein neues Skript
`create_page`	Erstellt eine neue Seite in einem Skript, das du verfasst
`create_collection`	Erstellt eine neue Collection

Aktualisieren

Tool	Was es macht
`update_page_content`	Ersetzt den Markdown-Inhalt einer Seite
`update_page_metadata`	Aktualisiert Titel, Slug, Beschreibung oder Publish-Zustand einer Seite
`update_skript`	Aktualisiert die Metadaten oder den Publish-Zustand eines Skripts
`update_collection`	Aktualisiert die Metadaten einer Collection
`update_site_frontpage`	Aktualisiert den Inhalt der Frontseite deiner Site
`update_skript_frontpage`	Aktualisiert den Inhalt der Frontseite eines Skripts

Organisieren

Tool	Was es macht
`place_skript`	Verschiebt ein Skript in eine Collection (oder heraus)
`reorder_collection_skripts`	Ändert die Reihenfolge der Skripte innerhalb einer Collection

Versionen & SEO

Tool	Was es macht
`list_page_versions`	Listet den gespeicherten Versionsverlauf einer Seite auf
`restore_page_version`	Stellt eine Seite auf eine frühere Version zurück
`audit_skript_seo`	Prüft die Seiten eines Skripts auf SEO-Probleme

Destruktive Aktionen (Löschen, Mitautoren verwalten) bleiben dem Dashboard vorbehalten.

Setup — claude.ai (empfohlen)

Öffne https://claude.ai, klick auf dein Avatar → Settings → Connectors (oder Integrations, je nach Plan).
Klick auf Add custom connector.
Füge https://eduskript.org/api/mcp/mcp als Server-URL ein und gib ihr einen Namen wie „Eduskript".
Claude öffnet einen OAuth-Tab. Melde dich mit deinem Eduskript-Account an.
Klick auf dem Zustimmungsbildschirm auf Allow.
Der Tab leitet zurück; der Connector ist jetzt in deinen Chats verfügbar.

Custom Connectors sind auf den Plänen Claude Pro, Max, Team und Enterprise verfügbar.

Setup — Claude Code

claude mcp add --transport http eduskript https://eduskript.org/api/mcp/mcp

Claude Code öffnet einen Browser-Tab für den OAuth-Flow; melde dich an und klick auf Allow. Danach sind die Tools in jeder Claude-Code-Sitzung verfügbar.

Setup — Cursor

Öffne in Cursor Settings → MCP und füge einen Server hinzu:

{
  "eduskript": {
    "url": "https://eduskript.org/api/mcp/mcp"
  }
}

Der OAuth-Flow läuft gleich ab wie bei claude.ai.

Beispiel-Prompts

Einmal verbunden, probier:

„Zeig mir alle meine Skripte."
„Was steht auf der Seite über quadratische Funktionen?"
„Aktualisiere die Einführungsseite in meinem Algebra-Skript: Ersetze den zweiten Absatz durch eine klarere Erklärung der quadratischen Ergänzung."
„Erstelle eine neue Seite namens 'JOINs' in meinem SQL-Skript, fasse die vier Standard-JOIN-Typen zusammen, mit je einer Beispiel-Query."
„Durchsuche meine Inhalte nach 'Pythagoras' und sag mir, welche Seiten das erwähnen."
„Sortiere meine Skripte so um, dass 'Intro to Python' in der Programming-Collection zuerst kommt."
„Prüfe mein Statistics-Skript auf SEO-Probleme."

Zugriff widerrufen

Wenn du einen AI-Client nicht mehr nutzt, widerrufe seinen Zugriff:

Geh im Dashboard zu Settings → Connected Apps.
Klick auf Revoke neben der App.

Die nächste Anfrage von diesem Client liefert 401 zurück.

Was geloggt wird

Eduskript loggt:

Die ersten 12 Zeichen deines Access-Tokens (für die UI-Anzeige, nicht auditierbar).
Den Zeitstempel der letzten Nutzung des Tokens (wird bei jedem erfolgreichen Aufruf aktualisiert).
Toolname + (gekürzte) Argumente auf Anwendungsebene.

Wir loggen nie den vollständigen Token im Klartext.

Limits

Access-Tokens laufen nach 1 Stunde ab. Der Client erneuert sie automatisch.
Refresh-Tokens laufen nach 30 Tagen Inaktivität ab.
Die Suche liefert höchstens 20 Treffer.
Streamable HTTP läuft im Stateless-Modus, mehrstufige server-initiierte Benachrichtigungen sind daher nicht verfügbar — jeder Aufruf ist Request/Response.

Fehlerbehebung

Der OAuth-Tab öffnet sich, leitet aber wiederholt auf eine Login-Seite um. Stell sicher, dass dein Browser beim gleichen Eduskript-Account angemeldet ist, den die AI nutzen soll.
401 invalid_grant beim Erneuern. Der Refresh-Token ist abgelaufen oder wurde durch eine vorherige Anfrage rotiert, die abgestürzt ist, bevor das neue Paar gespeichert wurde. Trenne die Verbindung im AI-Client und verbinde erneut.
„Permission denied" bei einer Seite, die du im Dashboard bearbeiten kannst. Bestätige im Berechtigungs-Panel des Dashboards, dass du author (nicht nur viewer) beim übergeordneten Skript oder bei der Seite bist.