> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

# Premiers pas avec Auth0 Model Context Protocol (MCP) Server

<Card title="Avant de commencer">
  * Installez [Node.js v18 ou version ultérieure](https://nodejs.org/en/download) sur votre système.
  * Créez un [compte Auth0](https://auth0.com/) actif avec des autorisations d’administrateur.
  * Installez au moins un client MCP pris en charge ([Claude Desktop](https://claude.ai/download), [Cursor](https://www.cursor.com/downloads) ou [Windsurf](https://www.windsurf.com/editor), par exemple).
</Card>

Aidez votre équipe et vos utilisateurs à tirer parti d’[Auth0 Model Context Protocol (MCP) Server](/docs/fr-ca/get-started/auth0-mcp-server) en l’installant et en l’intégrant à plusieurs [clients MCP](https://modelcontextprotocol.io/clients) couramment utilisés.

<div id="installation-and-configuration">
  ## Installation et configuration
</div>

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

<div id="for-claude-desktop-default">
  ### Pour Claude Desktop (par défaut)
</div>

```bash lines theme={null}
npx @auth0/auth0-mcp-server init
```

<div id="for-cursor">
  ### Pour Cursor
</div>

```bash lines theme={null}
npx @auth0/auth0-mcp-server init --client cursor
```

<div id="for-windsurf">
  ### Pour Windsurf
</div>

```bash lines theme={null}
npx @auth0/auth0-mcp-server init --client windsurf
```

<div id="other-mcp-clients">
  ### Autres clients MCP
</div>

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 :

```json lines theme={null}
{
  "mcpServers": {
    "auth0": {
      "command": "npx",
      "args": ["-y", "@auth0/auth0-mcp-server", "run"],
      "capabilities": ["tools"],
      "env": {
        "DEBUG": "auth0-mcp"
      }
    }
  }
}
```

<div id="authenticate-with-auth0">
  ## Authentifiez-vous avec Auth0
</div>

Votre navigateur s’ouvrira automatiquement pour lancer le <Tooltip tip="OAuth 2.0 : cadre d’autorisation qui définit les protocoles et les flux de travail d’autorisation." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=OAuth+2.0">OAuth 2.0</Tooltip> flux sur appareil d’<Tooltip tip="OAuth 2.0 : cadre d’autorisation qui définit les protocoles et les flux de travail d’autorisation." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=authorization+flow">autorisation</Tooltip>. Connectez-vous à votre compte Auth0 et accordez les autorisations demandées.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  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.
</Callout>

<div id="verify-your-integration">
  ## Vérifier votre intégration
</div>

<div id="claude-desktop">
  ### Claude Desktop
</div>

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.

<div id="cursor">
  ### Cursor
</div>

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.

<div id="windsurf">
  ### Windsurf
</div>

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.

<div id="common-troubleshooting-steps">
  ## Étapes de dépannage courantes
</div>

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  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.
</Callout>

<div id="get-command-line-help">
  #### Obtenir de l’aide sur la ligne de commande :
</div>

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

```bash lines theme={null}
npx @auth0/auth0-mcp-server help
```

<div id="authentication-issues">
  #### Problèmes d’authentification
</div>

Assurez-vous que les autorisations de votre tenant Auth0 sont correctes, puis essayez de réinitialiser avec :

```bash lines theme={null}
npx @auth0/auth0-mcp-server init
```

<div id="connection-failures">
  #### Échecs de connexion :
</div>

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

   ```ps lines theme={null}
   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.

<div id="claude-cant-connect-to-the-server-error">
  #### Erreur : Claude ne peut pas se connecter au serveur
</div>

1. Redémarrez Claude Desktop après l’installation.
2. Vérifiez que le serveur est en cours d’exécution avec :

   ```ps lines theme={null}
   ps aux | grep auth0-mcp
   ```

<div id="api-errors">
  #### Erreurs d’API :
</div>

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.

<div id="debug-configuration-issues">
  ## Résoudre les problèmes de configuration
</div>

<div id="enable-debug-mode">
  #### Activer le mode de débogage
</div>

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

```bash lines theme={null}
export DEBUG=auth0-mcp
```

<div id="debug-client-logs">
  #### Déboguer les journaux du client
</div>

Accédez aux journaux détaillés du client MCP dans Claude Desktop :

```bash lines theme={null}
# 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 :

```bash lines theme={null}
DEBUG=auth0-mcp npx @auth0/auth0-mcp-server run
```

<div id="advanced-debugging-using-mcp-inspector">
  #### Débogage avancé à l’aide du MCP Inspector
</div>

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

```bash wrap lines theme={null}
npx @modelcontextprotocol/inspector -e DEBUG='auth0-mcp' @auth0/auth0-mcp-server run__text in bold__
```

<div id="next-steps">
  ## Prochaines étapes
</div>

Explorez toutes les capacités du Auth0 MCP Server en consultant notre [référence des outils du Auth0 Model Context Protocol (MCP) Server](/docs/fr-ca/get-started/auth0-mcp-server/auth0-mcp-tools-reference), ou consultez nos guides du Auth0 Model Context Protocol (MCP) Server pour découvrir des exemples pratiques et des cas d’utilisation.