Passer au contenu principal

Connecter Claude Desktop au serveur MCP de Casdoor

Ce guide explique comment connecter Claude Desktop au serveur MCP de Casdoor, afin que vous puissiez gérer les applications, les utilisateurs et d'autres objets en discutant avec Claude.

Objectifs d'apprentissage​

  • Permettre à Claude Desktop de s'enregistrer comme client OAuth 2.0 auprès de Casdoor.
  • Ajouter le serveur MCP de Casdoor à la configuration de Claude Desktop.
  • Se connecter et vérifier que Claude peut appeler les outils.

Prérequis​

  • Une instance Casdoor fonctionnelle. Utilisez HTTPS en production.
  • Claude Desktop et Node.js, qui fournit npx
  • Accès administrateur à la console d'administration Casdoor

À propos de la connexion​

Claude Desktop communique avec les serveurs MCP locaux via l'entrée et la sortie standard. Le package mcp-remote fait le pont vers un serveur distant tel que Casdoor, et exécute le flux OAuth 2.0 : il lit les documents de découverte de Casdoor, s'enregistre en tant que client via l'enregistrement dynamique des clients (DCR), et ouvre votre navigateur pour la connexion.

Autoriser l'enregistrement dynamique des clients​

  1. Dans la console d'administration Casdoor, allez dans User Management > Organizations et ouvrez l'organisation built-in. Les clients s'enregistrent par défaut dans cette organisation.
  2. Activez Enable dynamic client registration.
  3. Enregistrez l'organisation.

Lorsque mcp-remote s'enregistre, Casdoor crée une application pour celui-ci dont le nom commence par dcr_. Voir Dynamic client registration.

Configurer Claude Desktop​

  1. Ouvrez le fichier de configuration de Claude Desktop dans un éditeur de texte :

    Operating systemPath
    macOS~/Library/Application Support/Claude/claude_desktop_config.json
    Windows%APPDATA%\Claude\claude_desktop_config.json
    Linux~/.config/Claude/claude_desktop_config.json

  2. Ajoutez le serveur MCP Casdoor. Remplacez your-casdoor.com par le domaine de votre instance Casdoor.

    {
      "mcpServers": {
        "casdoor": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://your-casdoor.com/api/mcp"
          ]
        }
      }
    }

  3. Fermez complètement Claude Desktop, pas seulement sa fenêtre, puis redémarrez-le.

Se connecter​

Au démarrage de Claude Desktop, mcp-remote ouvre votre navigateur par défaut.

  1. Connectez-vous sur la page de connexion Casdoor avec un compte autorisé à gérer les objets avec lesquels vous souhaitez que Claude travaille.
  2. Si Casdoor affiche un écran de consentement, cliquez sur Allow.
  3. Le navigateur affiche un message de succès. Revenez à Claude Desktop.

mcp-remote stocke les jetons sur votre ordinateur. Vous ne devez vous reconnecter qu'après la révocation ou l'expiration des jetons sans jeton d'actualisation.

Vérifier le résultat​

Demandez à Claude de travailler avec Casdoor, par exemple :

  • "List all applications in Casdoor."
  • "Show me the application named my-app."
  • "Create an application called test-app in the organization my-org."

Claude appelle les outils MCP et répond avec des données provenant de votre instance Casdoor, par exemple :

I found the following applications in your Casdoor instance:

1. claude-desktop-mcp (Claude Desktop MCP Client)
2. app-built-in (Casdoor)
...

Dépannage​

Claude Desktop ne peut pas se connecter au serveur MCP​

  • Vérifiez l'URL dans claude_desktop_config.json. Elle se termine par /api/mcp.
  • Vérifiez que Casdoor est actif et que votre ordinateur peut y accéder.
  • Vérifiez que le schéma est correct : https en production.

Échec de l'enregistrement​

Vérifiez que Enable dynamic client registration est activé pour l'organisation built-in.

Casdoor signale une incompatibilité de l'URL de redirection​

mcp-remote écoute le callback sur http://localhost:3334/oauth/callback. Si le port 3334 est utilisé, il choisit un autre port, et l'URL de redirection d'un enregistrement précédent ne correspond plus. Libérez le port, ou supprimez l'application dcr_ dans Casdoor ainsi que les identifiants mis en cache de mcp-remote, puis reconnectez-vous.

Un appel d'outil échoue avec insufficient_scope​

Le jeton du client ne possède pas la portée requise par l'outil. Voir MCP authorization and scopes.

Sécuriser la connexion​

  • HTTPS : Servez Casdoor via HTTPS en production, pour protéger le flux OAuth 2.0.
  • Moindre privilège : Connectez-vous avec un compte disposant uniquement des droits nécessaires à Claude.
  • Révocation : Pour couper le client, supprimez ses jetons sur la page Tokens de la console d'administration Casdoor.

Voir aussi​