Premiers pas avec Auth0 Model Context Protocol (MCP) Server

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

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 ou Windsurf, 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

​

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 OAuth 2.0 flux sur appareil d’autorisation. 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

1. Redémarrez Claude Desktop pour vous assurer qu’il reconnaît l’Auth0 MCP Server nouvellement installé.
2. 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.
3. Lancez une conversation avec Claude Desktop et demandez de l’aide pour gérer votre tenant Auth0.

​

Cursor

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

​

Windsurf

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

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 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

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

2. 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.