Client einrichten

Für die meisten ist der beste Weg, LMS MCP zu nutzen, die Verbindung mit ChatGPT oder Claude: eine einmalige Einrichtung von zwei Minuten, ganz ohne Schlüssel. Kommandozeilenwerkzeuge und Editoren folgen danach, für alle, die sie brauchen.

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

Vorab: die Connector-URL

Jeder Client verbindet sich mit der Connector-URL einer Moodle-Verbindung:

https://<ihre-organisation>.slxd.app/mcp/lmsmcp/<verbindung>

Sie müssen sie nicht selbst zusammenbauen: Das Panel zeigt sie mit einer Kopierschaltfläche auf der Seite der Verbindung unter Organisation → Moodle — direkt nach dem Anlegen der Verbindung und jederzeit später. Wer von der Administration über das Plugin bereitgestellt wurde, bekommt die URL zusammen mit dem Schlüssel auch per E-Mail.

Hat Ihre Organisation mehrere Moodle-Sites, richten Sie pro Verbindung einen Client ein — die URL wählt die Site aus.

ChatGPT

ChatGPT verbindet sich mit Mit Ihrem Moodle anmelden: Es gibt keinen Schlüssel zum Kopieren.

  1. Öffnen Sie die Einstellungen von ChatGPT und gehen Sie zum Bereich Connectors.
  2. Schalten Sie in den erweiterten Einstellungen den Entwicklermodus ein, falls er aus ist — erst er erlaubt eigene MCP-Connectors.
  3. Legen Sie einen neuen Connector an und fügen Sie die Connector-URL der Verbindung ein.
  4. Wenn sich das Browserfenster öffnet, wählen Sie Mit Ihrem Moodle anmelden, melden Sie sich mit Ihrem eigenen Moodle-Konto an und bestätigen Sie.
  5. Schalten Sie den Connector in einer Unterhaltung im Werkzeugmenü ein und fragen Sie etwas zu Ihrem Moodle.

Eigene Connectors setzen einen kostenpflichtigen ChatGPT-Tarif voraus, und die genauen Menünamen können je nach Version leicht abweichen.

Claude (claude.ai und Claude Desktop)

Dieselben Schritte gelten für Claude im Browser (claude.ai) und für die Desktop-App, beide mit Mit Ihrem Moodle anmelden:

  1. Öffnen Sie die Einstellungen von Claude und gehen Sie zu Connectors.
  2. Wählen Sie Eigenen Connector hinzufügen und fügen Sie die Connector-URL der Verbindung ein.
  3. Beim Verbinden öffnet sich ein Browserfenster: Wählen Sie Mit Ihrem Moodle anmelden, melden Sie sich in Ihrem Moodle an und bestätigen Sie.
  4. Prüfen Sie in einer Unterhaltung, dass der Connector im Werkzeugmenü aktiv ist, und fragen Sie etwas zu Ihrem Moodle.

Eigene Connectors setzen einen kostenpflichtigen Claude-Tarif voraus. Der Connector bleibt an Ihre Moodle-Identität gebunden: Um als jemand anderes zu verbinden, entfernen Sie den Connector und autorisieren neu.

Claude Code

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

claude mcp add --transport http moodle \
  https://<ihre-organisation>.slxd.app/mcp/lmsmcp/<verbindung> \
  --header "Authorization: Bearer mcpk_..."

Wer keine Schlüssel handhaben möchte, fügt den Server ohne Header hinzu und authentifiziert sich per OAuth, sobald Claude Code danach fragt — derselbe Browser-Ablauf Mit Ihrem Moodle anmelden.

Cursor

In der MCP-Konfigurationsdatei von Cursor — .cursor/mcp.json im Projekt oder die globale Ihres Benutzers:

{
  "mcpServers": {
    "moodle": {
      "url": "https://<ihre-organisation>.slxd.app/mcp/lmsmcp/<verbindung>",
      "headers": { "Authorization": "Bearer mcpk_..." }
    }
  }
}

VS Code

VS Code nutzt ein eigenes Format, in .vscode/mcp.json im Projekt:

{
  "servers": {
    "moodle": {
      "type": "http",
      "url": "https://<ihre-organisation>.slxd.app/mcp/lmsmcp/<verbindung>",
      "headers": { "Authorization": "Bearer mcpk_..." }
    }
  }
}

Clients, die nur stdio sprechen

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

npx mcp-remote https://<ihre-organisation>.slxd.app/mcp/lmsmcp/<verbindung> \
  --header "Authorization: Bearer mcpk_..."

Skripte und CI

Jeder HTTP-Client genügt: Senden Sie den Schlüssel als Bearer-Header über den Streamable-HTTP-Transport. Für Automatisierung erzeugen Sie einen eigenen Schlüssel: nur lesend, auf die nötigen Werkzeuge begrenzt und mit Ablaufdatum. Siehe Schlüssel und Berechtigungen.

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

Prüfen, ob es funktioniert

Fragen Sie den Assistenten etwas, das Ihr Moodle braucht, etwa „In welchen Kursen bin ich eingeschrieben?". Sagt er, er habe keine Werkzeuge, hat er fast immer seine MCP-Konfiguration nicht neu geladen: Client neu starten oder den Connector aus- und wieder einschalten. Weitere Symptome stehen unter Fehlerbehebung.

Client einrichten