> ## Documentation Index
> Fetch the complete documentation index at: https://auth0-chore-myaccount-api-autoupdate.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

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "Beta",
    "ea": "Early Access"
  };
  const stageText = stageTextMap[stage] || "a product release stage";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>This feature is available for {linkify(`${plans} plans`, "https://auth0.com/pricing")}. </>}
            {contact && "To participate, contact " + contact + ". "}
            {terms && <>By using this feature, you agree to the applicable Free Trial terms in Okta's {linkify("Master Subscription Agreement", "https://www.okta.com/legal")}.</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>The {feature} feature is in {linkify(stageText, prsLink)}.</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="Auth0 MCP Server" stage="beta" />

<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), [Windsurf](https://www.windsurf.com/editor), [VS Code](https://code.visualstudio.com/download), [Claude Code](https://claude.ai/download) ou [Gemini CLI](https://github.com/google-gemini/gemini-cli), 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.

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

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

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

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

<h3 id="for-cursor">
  Pour Cursor
</h3>

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

<h3 id="for-windsurf">
  Pour Windsurf
</h3>

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

<h3 id="for-vs-code">
  Pour VS Code
</h3>

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

Vous serez invité à choisir une portée de configuration :

* **Global** : Disponible dans toutes les instances VS Code.
* **Espace de travail** : Disponible uniquement dans un projet ou un dépôt spécifique.

La commande configure automatiquement le fichier `mcp.json` approprié selon votre sélection.

<h3 id="for-claude-code">
  Pour Claude Code
</h3>

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

Vous serez invité à choisir une portée de configuration :

* **Utilisateur** : Écrit dans `~/.claude.json` et disponible dans tous vos projets.
* **Projet** : Disponible uniquement dans le projet actuel.

<h3 id="for-gemini-cli">
  Pour Gemini CLI
</h3>

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

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

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"
      }
    }
  }
}
```

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

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>

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

<h3 id="claude-desktop">
  Claude Desktop
</h3>

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.

<h3 id="cursor">
  Cursor
</h3>

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.

<h3 id="windsurf">
  Windsurf
</h3>

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.

<h3 id="vs-code">
  VS Code
</h3>

1. Redémarrez VS Code pour vous assurer qu’il reconnaît l’Auth0 MCP Server nouvellement installé.
2. Dans VS Code, ouvrez Copilot Chat en mode agent et vérifiez que les outils Auth0 sont disponibles.
3. Lancez une conversation et demandez de l’aide pour gérer votre tenant Auth0.

<h3 id="claude-code">
  Claude Code
</h3>

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

<h3 id="gemini-cli">
  Gemini CLI
</h3>

1. Redémarrez Gemini CLI pour vous assurer qu’il reconnaît l’Auth0 MCP Server nouvellement installé.
2. Lancez une conversation avec Gemini CLI et demandez de l’aide pour gérer votre tenant Auth0.

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

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

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

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

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

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

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

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

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.

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

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

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

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.

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

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

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

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

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

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

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

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

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

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.