Premiers pas avec Auth0 Model Context Protocol (MCP) Server

Avant de commencer

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

Aidez votre équipe et vos utilisateurs à tirer parti d’Auth0 Model Context Protocol (MCP) Server en l’installant 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

Pour VS Code

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

Vous serez invité à choisir une permission de configuration :

Global : disponible dans toutes les instances de VS Code.
Workspace : disponible uniquement dans un projet ou un dépôt précis.

La commande configure automatiquement le fichier mcp.json approprié selon votre choix.

Pour Claude Code

npx @auth0/auth0-mcp-server init --client claude-code

Vous serez invité à choisir une permission de configuration :

User : écrite dans ~/.claude.json et accessible dans tous vos projets.
Project : accessible uniquement dans le projet actuel.

Pour Gemini CLI

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

Autres clients MCP

Pour utiliser Auth0 MCP Server avec n’importe quel autre client MCP, vous pouvez ajouter manuellement cette configuration dans le 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"
      }
    }
  }
}

Authentifiez-vous avec Auth0

Votre navigateur s’ouvrira automatiquement pour lancer le flux sur appareil d’. 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 clés de votre système. Vous pouvez aussi le vérifier à l’aide de votre outil de gestion du trousseau de clés.

Vérifier votre intégration

Claude Desktop

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

Cursor

Redémarrez Cursor pour vous assurer qu’il reconnaît le Auth0 MCP Server nouvellement installé.
Dans Cursor, ouvrez Settings > MCP et vérifiez que Auth0 figure dans la liste des MCP Servers.
Lancez une conversation avec Cursor et demandez de l’aide pour gérer votre tenant Auth0.

Windsurf

Redémarrez Windsurf pour vous assurer qu’il reconnaît l’Auth0 MCP Server nouvellement installé.
Dans Windsurf, ouvrez Paramètres de Windsurf > Cascade et vérifiez que Auth0 apparaît dans la liste des serveurs MCP (Model Context Protocol).
Lancez une conversation avec Windsurf et demandez-lui de vous aider à gérer votre tenant Auth0.

VS Code

Redémarrez VS Code afin qu’il reconnaisse le Auth0 MCP Server fraîchement installé.
Dans VS Code, ouvrez Copilot Chat en mode agent et vérifiez que les outils Auth0 sont bien disponibles.
Amorcez une conversation et demandez de l’aide pour gérer votre locataire Auth0.

Claude Code

Redémarrez Claude Code pour vous assurer qu’il reconnaît le Auth0 MCP Server nouvellement installé.
Vérifiez que les outils Auth0 (par exemple, auth0_create_action ou auth0_list_applications) sont accessibles dans votre session.
Amorcez une conversation avec Claude Code et demandez de l’aide pour gérer votre locataire Auth0.

Gemini CLI

Redémarrez Gemini CLI afin qu’il reconnaisse le Auth0 MCP Server qui vient d’être installé.
Entamez une conversation avec Gemini CLI et demandez-lui de l’aide pour gérer votre locataire Auth0.

Étapes de dépannage courantes

La plupart des problèmes de connexion peuvent être réglés en configurant le Auth0 MCP Server et en redémarrant le client MCP.

Obtenir de l’aide sur 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 de votre tenant Auth0 sont correctes, puis essayez de réinitialiser avec :

npx @auth0/auth0-mcp-server init

Échecs de connexion :

Assurez-vous que le serveur MCP est bien en cours d’exécution avec :
ps aux | grep auth0-mcp
Redémarrez votre client d’IA après avoir vérifié que le serveur est en cours d’exécution.

Erreur : Claude ne peut pas se connecter au serveur

Redémarrez Claude Desktop après l’installation.
Vérifiez que le serveur est en cours d’exécution avec :
ps aux | grep auth0-mcp

Erreurs d’API :

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

Résoudre les problèmes de configuration

Activer le mode de débogage

Activez le mode de débogage pour consulter des journaux détaillés :

export DEBUG=auth0-mcp

Déboguer les journaux du client

Accédez aux 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

Obtenez des logs détaillés du MCP Server en exécutant Auth0 MCP Server en mode de débogage :

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

Débogage avancé à l’aide du MCP Inspector

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

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

Prochaines étapes

Explorez toutes les capacités du Auth0 MCP Server en consultant notre référence des outils du Auth0 Model Context Protocol (MCP) Server, ou consultez nos guides du Auth0 Model Context Protocol (MCP) Server pour découvrir des exemples pratiques et des cas d’utilisation.

Guides de démarrage rapide

Présentation d’Auth0

Configurer Auth0

Applications

Premiers pas avec Auth0 Model Context Protocol (MCP) Server

Avant de commencer

Installation et configuration

Pour Claude Desktop (par défaut)

Pour Cursor

Pour Windsurf

Pour VS Code

Pour Claude Code

Pour Gemini CLI

Autres clients MCP

Authentifiez-vous avec Auth0

Vérifier votre intégration

Claude Desktop

Cursor

Windsurf

VS Code

Claude Code

Gemini CLI

Étapes de dépannage courantes

Obtenir de l’aide sur la ligne de commande :

Problèmes d’authentification

Échecs de connexion :

Erreur : Claude ne peut pas se connecter au serveur

Erreurs d’API :

Résoudre les problèmes de configuration

Activer le mode de débogage

Déboguer les journaux du client

Débogage avancé à l’aide du MCP Inspector

Prochaines étapes

Avant de commencer

​Installation et configuration

​Pour Claude Desktop (par défaut)

​Pour Cursor

​Pour Windsurf

​Pour VS Code

​Pour Claude Code

​Pour Gemini CLI

​Autres clients MCP

​Authentifiez-vous avec Auth0

​Vérifier votre intégration

​Claude Desktop

​Cursor

​Windsurf

​VS Code

​Claude Code

​Gemini CLI

​Étapes de dépannage courantes

​Obtenir de l’aide sur la ligne de commande :

​Problèmes d’authentification

​Échecs de connexion :

​Erreur : Claude ne peut pas se connecter au serveur

​Erreurs d’API :

​Résoudre les problèmes de configuration

​Activer le mode de débogage

​Déboguer les journaux du client

​Débogage avancé à l’aide du MCP Inspector

​Prochaines étapes

Installation et configuration

Pour Claude Desktop (par défaut)

Pour Cursor

Pour Windsurf

Pour VS Code

Pour Claude Code

Pour Gemini CLI

Autres clients MCP

Authentifiez-vous avec Auth0

Vérifier votre intégration

Claude Desktop

Cursor

Windsurf

VS Code

Claude Code

Gemini CLI

Étapes de dépannage courantes

Obtenir de l’aide sur la ligne de commande :

Problèmes d’authentification

Échecs de connexion :

Erreur : Claude ne peut pas se connecter au serveur

Erreurs d’API :

Résoudre les problèmes de configuration

Activer le mode de débogage

Déboguer les journaux du client

Débogage avancé à l’aide du MCP Inspector

Prochaines étapes