Client einrichten

Für die meisten Menschen ist der beste Weg, MoodleMCP zu nutzen, es mit ChatGPT oder Claude zu verbinden: einmalig eingerichtet, in ein paar Minuten, ganz ohne Schlüssel zu handhaben. Kommandozeilen-Tools und Editoren folgen weiter unten für alle, die sie brauchen.

Welche Authentifizierung welcher Client unterstützt, steht unter Assistenten verbinden.

Bevor Sie beginnen: Ihr Endpunkt

Alle Clients verbinden sich mit dem MCP-Endpunkt Ihrer Organisation:

https://<ihre-organisation>.moodlemcp.com/mcp

Sie müssen ihn nicht von Hand zusammensetzen: Das Panel zeigt ihn mit einer Kopierschaltfläche unter Organisation → Moodle an, sowohl beim Anlegen der Verbindung als auch jederzeit danach. Hat Sie Ihr Administrator über das Plugin bereitgestellt, kommt die URL auch per E-Mail zusammen mit Ihrem Schlüssel.

ChatGPT

ChatGPT verbindet sich über Mit Ihrem Moodle anmelden: Es gibt keinen Schlüssel zu kopieren.

Öffnen Sie die ChatGPT-Einstellungen und wechseln Sie in den Bereich Connectors.
Aktivieren Sie in den erweiterten Einstellungen den Entwicklermodus, falls noch nicht geschehen — er erlaubt das Hinzufügen eigener MCP-Connectors.
Legen Sie einen neuen Connector an und fügen Sie die URL Ihres Endpunkts ein.
Wählen Sie im geöffneten Browserfenster Mit Ihrem Moodle anmelden, melden Sie sich mit Ihrem eigenen Moodle-Konto an und bestätigen Sie.
Aktivieren Sie den Connector in einem Gespräch über das Werkzeug-Menü und stellen Sie eine Frage zu Ihrem Moodle.

Eigene Connectors erfordern einen kostenpflichtigen ChatGPT-Tarif, und die genaue Bezeichnung der Menüs kann je nach Version leicht abweichen.

Claude (claude.ai und Claude Desktop)

Gilt sowohl für Claude im Browser (claude.ai) als auch für die Desktop-Anwendung, mit denselben Schritten und ebenfalls über Mit Ihrem Moodle anmelden:

Öffnen Sie die Claude-Einstellungen und wechseln Sie zu Connectors.
Wählen Sie Eigenen Connector hinzufügen und fügen Sie die URL Ihres Endpunkts ein.
Beim Verbinden öffnet sich ein Browserfenster: Wählen Sie Mit Ihrem Moodle anmelden, melden Sie sich in Ihrem Moodle an und bestätigen Sie.
Prüfen Sie in einem Gespräch, dass der Connector im Werkzeug-Menü aktiviert ist, und stellen Sie eine Frage zu Ihrem Moodle.

Eigene Connectors erfordern einen kostenpflichtigen Claude-Tarif. Der Connector bleibt an Ihre Moodle-Identität gebunden: Um sich als jemand anderes zu verbinden, entfernen Sie ihn und autorisieren erneut.

Claude Code

Mit einem MCP-Schlüssel in einem Bearer-Header:

claude mcp add --transport http moodle https://<ihre-organisation>.moodlemcp.com/mcp \
  --header "Authorization: Bearer mcpk_..."

Möchten Sie lieber keinen Schlüssel handhaben, fügen Sie den Server ohne den Header hinzu und authentifizieren Sie sich per OAuth, sobald Claude Code danach fragt — es ist derselbe Mit Ihrem Moodle anmelden-Ablauf im Browser.

Cursor

In Cursors MCP-Konfigurationsdatei — .cursor/mcp.json innerhalb des Projekts oder der globalen Datei Ihres Benutzers:

{
  "mcpServers": {
    "moodle": {
      "url": "https://<ihre-organisation>.moodlemcp.com/mcp",
      "headers": { "Authorization": "Bearer mcpk_..." }
    }
  }
}

VS Code

VS Code verwendet ein eigenes Format, in .vscode/mcp.json innerhalb des Projekts:

{
  "servers": {
    "moodle": {
      "type": "http",
      "url": "https://<ihre-organisation>.moodlemcp.com/mcp",
      "headers": { "Authorization": "Bearer mcpk_..." }
    }
  }
}

Clients, die nur stdio sprechen

Überbrücken Sie mit dem Standardpaket mcp-remote:

npx mcp-remote https://<ihre-organisation>.moodlemcp.com/mcp \
  --header "Authorization: Bearer mcpk_..."

Skripte und Continuous Integration

Jeder HTTP-Client genügt: Senden Sie den Schlüssel als Bearer-Header über den Streamable-HTTP-Transport. Stellen Sie für Automatisierungen einen eigenen Schlüssel aus: nur lesend, auf die nötigen Werkzeuge beschränkt und mit Ablaufdatum. Siehe Schlüssel und Berechtigungen.

Bewahren Sie den Schlüssel in Ihrem Secret-Store auf, nie im Repository. Wenn ein Schlüssel abfließt, widerrufen Sie ihn im Panel — sein nächster Aufruf wird abgewiesen.

Prüfen, ob es funktioniert

Fragen Sie den Assistenten etwas, das Ihr Moodle braucht, etwa „In welchen Kursen bin ich eingeschrieben?". Behauptet er, keine Werkzeuge zu haben, hat er meist seine MCP-Konfiguration nicht neu geladen: starten Sie den Client neu oder deaktivieren und reaktivieren Sie den Connector. Weitere Symptome behandelt die Fehlerbehebung.