FindClass MCP-Adapter

Der Adapter ist nur lokal über stdio verfügbar. Er leitet die 20 begrenzten Tools an die authentifizierte Backend-Workflow-API weiter.

Handels- und Fulfillment-Tools decken nach Berechtigungen gefilterte Lesezugriffe auf Bestellungen/Erstattungen/Abrechnungen/Slots ab, die Umbuchung von Bestellungen, die Erfassung von Fulfillment und das Erstellen/Schließen von Tutor-Slots. Zahlungs-Callbacks sind niemals MCP-Tools. Die Erstattungsprüfung verbleibt in der Admin-UI, da sie die bestehende dedizierte Erstattungsberechtigung und ein frisches TOTP erfordert; Schreibvorgänge für Abrechnungen verbleiben im Finanz-Workflow.

Datensatzsuche und Detailabfrage decken Inhalte, externe Anwendungen, Bestellungen, Erstattungen, Abrechnungen und Tutor-Slots ab; jedes Ergebnis wird durch die aktuellen Berechtigungen des Kontos gefiltert, das den MCP-Token besitzt.

Coupon-Vergaben frieren höchstens 100 ausgewählte Benutzer ein und stellen einen Coupon pro Benutzer aus; größere oder Mehrfach-Coupon-Vergaben bleiben in der Admin-UI.

{
  "mcpServers": {
    "findclass": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["/absolute/path/to/findclass-mcp/server.py"],
      "env": {
        "FINDCLASS_BASE_URL": "https://your-findclass-backend",
        "FINDCLASS_MCP_TOKEN": "set-in-the-client-secret-store"
      }
    }
  }
}

Installieren Sie über den Hash-Lock:

uv venv --python 3.14 .venv
uv pip install --python .venv/bin/python --require-hashes -r requirements.lock
.venv/bin/python -m unittest -v test_server.py

Oder führen Sie ./install-mcp-adapter.sh aus; es installiert denselben per Hash gesperrten Adapter, ohne ein Token zu schreiben.

Das Token ist nur einmal einsehbar und darf nicht in dieses Repository oder in normale Client-Logs geschrieben werden.