Premiers pas avec le serveur Auth0 Model Context Protocol (MCP)

Intégrez le serveur Auth0 Model Context Protocol (MCP) à vos clients IA.

Avant de commencer

• Installez Node.js v18 ou une version ultérieure sur votre système.
• Créez un compte Auth0 actif avec des droits d’administration.
• Installez au moins un client MCP pris en charge (Claude Desktop, Cursor ou Windsurf, par exemple).

Outillez votre équipe et vos utilisateurs en installant le serveur Auth0 Model Context Protocol (MCP) et en l’intégrant à plusieurs clients MCP couramment utilisés.

​

Installation et configuration

Installez Auth0 MCP Server en exécutant l’une de ces commandes dans votre terminal :

​

Pour Claude Desktop (par défaut)

npx @auth0/auth0-mcp-server init

​

Pour Cursor

npx @auth0/auth0-mcp-server init --client cursor

​

Pour Windsurf

npx @auth0/auth0-mcp-server init --client windsurf

​

Autres clients MCP

Pour utiliser Auth0 MCP Server avec n’importe quel autre client MCP, vous pouvez ajouter manuellement cette configuration au client, puis le redémarrer pour que les modifications prennent effet :

{
  "mcpServers": {
    "auth0": {
      "command": "npx",
      "args": ["-y", "@auth0/auth0-mcp-server", "run"],
      "capabilities": ["tools"],
      "env": {
        "DEBUG": "auth0-mcp"
      }
    }
  }
}

​

S’authentifier avec Auth0

Votre navigateur s’ouvrira automatiquement pour lancer le OAuth 2.0 flux d’autorisation d’appareil. Connectez-vous à votre compte Auth0 et accordez les autorisations demandées.

Les identifiants sont stockés de façon sécurisée dans le trousseau de votre système. Vous pouvez aussi vérifier leur présence à l’aide de votre outil de gestion du trousseau.

​

Vérifiez votre intégration

​

Claude Desktop

1. Redémarrez Claude Desktop pour vous assurer qu’il reconnaît le Auth0 MCP Server nouvellement installé.
2. Dans Claude Desktop, cliquez sur l’icône Tools et vérifiez que les outils Auth0 (par exemple, auth0_create_action ou auth0_delete_application) s’affichent dans la liste Available MCP Tools.
3. Lancez une conversation avec Claude Desktop et demandez de l’aide pour gérer votre locataire Auth0.

​

Cursor

1. Redémarrez Cursor pour vous assurer qu’il reconnaît le serveur Auth0 MCP Server nouvellement installé.
2. Dans Cursor, ouvrez Settings > MCP et vérifiez que Auth0 apparaît dans la liste MCP Servers.
3. Lancez une conversation avec Cursor et demandez-lui de vous aider à gérer votre locataire Auth0.

​

Windsurf

1. Redémarrez Windsurf pour vous assurer qu’il reconnaît le Auth0 MCP Server nouvellement installé.
2. Dans Windsurf, ouvrez Windsurf Settings > Cascade et vérifiez qu’Auth0 figure dans la liste Model Context Protocol (MCP) Servers.
3. Lancez une conversation avec Windsurf et demandez-lui de vous aider à gérer votre locataire Auth0.

​

Étapes de dépannage courantes

La plupart des problèmes de connexion peuvent être résolus en configurant le serveur MCP d’Auth0 et en redémarrant le client MCP.

​

Afficher l’aide de la ligne de commande :

Consultez la liste des commandes prises en charge et des exemples d’utilisation avec :

npx @auth0/auth0-mcp-server help

​

Problèmes d’authentification

Assurez-vous que les autorisations sont correctement configurées dans votre locataire Auth0, puis essayez de réinitialiser avec :

npx @auth0/auth0-mcp-server init

​

Échecs de connexion :

1. Assurez-vous que le serveur MCP est bien en cours d’exécution avec :

   ps aux | grep auth0-mcp
   

2. Redémarrez votre client IA après avoir vérifié que le serveur est en cours d’exécution.

​

Erreur « Claude ne parvient pas à se connecter au serveur » :

1. Redémarrez Claude Desktop après l’installation.

2. Vérifiez que le serveur est en cours d’exécution à l’aide de la commande suivante :

   ps aux | grep auth0-mcp
   

​

Erreurs d’API :

Vérifiez les autorisations et la date d’expiration de votre jeton Auth0. Activez le mode de débogage (voir ci-dessous) pour consulter les journaux détaillés.

​

Débogage des problèmes de configuration

​

Activer le mode de débogage

Activez le mode de débogage pour afficher des logs détaillés :

export DEBUG=auth0-mcp

​

Déboguer les journaux du client

Obtenez les journaux détaillés du client MCP dans Claude Desktop :

# Suivre les journaux en temps réel
tail -n 20 -F ~/Library/Logs/Claude/mcp*.log

Pour obtenir des journaux détaillés du MCP Server, exécutez le MCP Server d’Auth0 en mode débogage :

DEBUG=auth0-mcp npx @auth0/auth0-mcp-server run

​

Débogage avancé avec MCP Inspector

Pour un dépannage avancé, utilisez MCP Inspector :

npx @modelcontextprotocol/inspector -e DEBUG='auth0-mcp' @auth0/auth0-mcp-server run__text in bold__

​

Prochaines étapes

Découvrez toutes les fonctionnalités d’Auth0 MCP Server en consultant notre référence des outils du serveur Auth0 Model Context Protocol (MCP), ou consultez nos guides sur le serveur Auth0 Model Context Protocol pour voir des exemples concrets et des cas d’utilisation.