Aller au contenu
mofcloud

MCP et OAuth

Dernière mise à jour :

MOF est un serveur MCP. Une fois activé, des clients IA comme Claude Desktop, Cursor et Dify peuvent interroger les données de coûts que chaque utilisateur est autorisé à voir. L’accès est en lecture seule.

Activer MCP

Administrateur

  1. Ouvrez Admin → Paramètres → Accès MCP.
  2. Activez « Autoriser les connexions MCP ».
  3. Cliquez sur « Vérifier la connexion ». Le service MCP doit afficher « Connecté ».

Le conteneur MCP est fourni avec les modèles de déploiement ; rien d’autre à installer. Si la vérification échoue, assurez-vous que le conteneur mof-mcp tourne et a la même version que MOF.

Configurer OAuth

Administrateur · requis pour Claude Desktop

Avec OAuth, les utilisateurs collent une adresse dans leur client IA et se connectent avec leur compte MOF. Sans OAuth, ils doivent créer un jeton à la main, et Claude Desktop ne peut pas utiliser de jetons.

  1. Servez MOF en HTTPS public. Claude se connecte depuis ses propres serveurs, l’adresse doit donc être joignable depuis Internet.
  2. Ajoutez deux variables au service mof et recréez-le :
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. Dans Admin → Paramètres → Accès MCP, cliquez à nouveau sur « Vérifier la connexion ». La connexion OAuth doit afficher « Configuré ».

MOF_PUBLIC_URL est l’adresse que les utilisateurs ouvrent, sans chemin. Le secret doit faire au moins 32 caractères et être identique sur chaque serveur MOF. « Configuré » signifie seulement que les deux sont définis ; la première vraie connexion depuis Claude confirme que le callback public fonctionne. Variables d’environnement

Connecter Claude Desktop

Chaque utilisateur

  1. Dans MOF, ouvrez Paramètres → Connexions MCP et copiez l’URL du serveur.
  2. Dans Claude Desktop, ouvrez Paramètres → Connecteurs → Ajouter un connecteur personnalisé. Saisissez un nom comme MOF et collez l’adresse.
  3. Cliquez sur Se connecter, connectez-vous avec votre compte MOF dans le navigateur et approuvez.
  4. Posez une question à Claude, par exemple « Combien avons-nous dépensé le mois dernier, par cloud ? »
Clients sans OAuth : utiliser un jeton

Dans Paramètres → Connexions MCP → Jetons manuels, saisissez un nom et cliquez sur « Créer un jeton ». Copiez-le aussitôt ; il n’est affiché qu’une fois et dure 90 jours. Envoyez-le comme en-tête de requête :

Header
Authorization: Bearer YOUR_TOKEN

Révoquer l’accès

Les utilisateurs révoquent leurs propres applications et jetons dans Paramètres → Connexions MCP, sous « Applications connectées » et « Mes jetons ». Désactiver « Autoriser les connexions MCP » dans Admin coupe toutes les connexions d’un coup.