Zum Inhalt springen
mofcloud

MCP und OAuth

Zuletzt aktualisiert:

MOF ist ein MCP-Server. Sobald er aktiv ist, können KI-Clients wie Claude Desktop, Cursor und Dify die Kostendaten abfragen, die der jeweilige Benutzer sehen darf. Der Zugriff ist schreibgeschützt.

MCP aktivieren

Administrator

  1. Öffnen Sie Admin → Einstellungen → MCP-Zugriff.
  2. Aktivieren Sie „MCP-Verbindungen zulassen“.
  3. Klicken Sie auf „Verbindung prüfen“. MCP-Dienst sollte „Verbunden“ anzeigen.

Der MCP-Container ist in den Deployment-Vorlagen enthalten; sonst ist nichts zu installieren. Schlägt die Prüfung fehl, stellen Sie sicher, dass der Container mof-mcp läuft und dieselbe Version wie MOF hat.

OAuth einrichten

Administrator · nötig für Claude Desktop

Mit OAuth fügen Benutzer eine Adresse in ihren KI-Client ein und melden sich mit ihrem MOF-Konto an. Ohne OAuth müssen sie manuell ein Token erstellen, und Claude Desktop kann keine Tokens verwenden.

  1. Stellen Sie MOF über öffentliches HTTPS bereit. Claude verbindet sich von seinen eigenen Servern, daher muss die Adresse aus dem Internet erreichbar sein.
  2. Fügen Sie dem Service mof zwei Variablen hinzu und erstellen Sie ihn neu:
compose.yaml · mof.environment
MOF_PUBLIC_URL: "https://mof.example.com"
MOF_MCP_OAUTH_SECRET: "REPLACE_WITH_A_RANDOM_SECRET_AT_LEAST_32_CHARACTERS"
  1. Klicken Sie unter Admin → Einstellungen → MCP-Zugriff erneut auf „Verbindung prüfen“. OAuth-Anmeldung sollte „Konfiguriert“ anzeigen.

MOF_PUBLIC_URL ist die Adresse, die Benutzer öffnen, ohne Pfad. Das Secret braucht mindestens 32 Zeichen und muss auf jedem MOF-Server gleich sein. „Konfiguriert“ heißt nur, dass beide gesetzt sind; erst die erste echte Anmeldung aus Claude bestätigt, dass der öffentliche Callback funktioniert. Umgebungsvariablen

Claude Desktop verbinden

Jeder Benutzer

  1. Öffnen Sie in MOF Einstellungen → MCP-Verbindungen und kopieren Sie die Server-URL.
  2. Öffnen Sie in Claude Desktop Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen. Geben Sie einen Namen wie MOF ein und fügen Sie die Adresse ein.
  3. Klicken Sie auf Verbinden, melden Sie sich im Browser mit Ihrem MOF-Konto an und bestätigen Sie.
  4. Stellen Sie Claude eine Frage, zum Beispiel „Wie viel haben wir letzten Monat ausgegeben, nach Cloud?“
Clients ohne OAuth: ein Token verwenden

Geben Sie unter Einstellungen → MCP-Verbindungen → Manuelle Tokens einen Namen ein und klicken Sie auf „Token erstellen“. Kopieren Sie es sofort; es wird nur einmal angezeigt und gilt 90 Tage. Senden Sie es als Request-Header:

Header
Authorization: Bearer YOUR_TOKEN

Zugriff widerrufen

Benutzer widerrufen ihre eigenen Apps und Tokens unter Einstellungen → MCP-Verbindungen, bei „Verbundene Apps“ und „Meine Tokens“. Das Deaktivieren von „MCP-Verbindungen zulassen“ in Admin trennt alle Verbindungen auf einmal.