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

# Getting Started with Auth0 Model Context Protocol (MCP) Server

> Integrate Auth0 Model Context Protocol (MCP) Server with your AI clients.

<Card title="Avant de commencer">
  * Install [Node.js v18 or higher](https://nodejs.org/en/download) on your system.
  * Create an active [Auth0 account](https://auth0.com/)with administrative permissions.
  * Install at least one supported MCP client ([Claude Desktop](https://claude.ai/download), [Cursor](https://www.cursor.com/downloads), or [Windsurf](https://www.windsurf.com/editor), for example).
</Card>

Empower your team and your users by installing [Auth0 Model Context Protocol (MCP) Server](/docs/fr-CA/fr-ca/get-started/auth0-mcp-server) and integrating with several commonly-used [MCP clients](https://modelcontextprotocol.io/clients).

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

Install Auth0 MCP Server by running one of these commands in your terminal:

<div id="for-claude-desktop-default">
  ### For Claude Desktop (default)
</div>

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

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

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

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

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

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

To use Auth0 MCP Server with any other MCP Client, you can manually add this configuration to the client and restart for changes to take effect:

```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">
  ## Authenticate with Auth0
</div>

Your browser will automatically open to initiate the <Tooltip href="/docs/fr-CA/fr-ca/glossary?term=oath2" tip="OAuth 2.0
Cadre d’applications d’autorisation qui définit les protocoles d’autorisation et les flux de production." cta="Voir le glossaire">OAuth 2.0</Tooltip> device <Tooltip href="/docs/fr-CA/fr-ca/glossary?term=authorization-flow" tip="Flux d’autorisation
Octroi d’autorisation (ou flux de production) indiqué dans le cadre d’applications OAuth 2.0." cta="Voir le glossaire">authorization flow</Tooltip>. Log into your Auth0 account and grant the requested permissions.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Credentials are securely stored in your system's keychain. You can optionally verify storage through your keychain management tool.
</Callout>

<div id="verify-your-integration">
  ## Verify your integration
</div>

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

1. Restart Claude Desktop to ensure it recognizes the newly installed Auth0 MCP Server.
2. In Claude Desktop, click on the **Tools** icon and verify that Auth0 tools (for example, `auth0_create_action` or `auth0_delete_application`) show up in the **Available MCP Tools** list.
3. Begin a conversation with Claude Desktop and ask help managing your Auth0 tenant.

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

1. Restart Cursor to ensure it recognizes the newly installed Auth0 MCP Server.
2. In Cursor, open **Settings > MCP** and verify that **Auth0** appears in the **MCP Servers** list.
3. Begin a conversation with Cursor and ask for help managing your Auth0 tenant.

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

1. Restart Windsurf to ensure it recognizes the newly installed Auth0 MCP Server.
2. In Windsurf, open **Windsurf Settings > Cascade** and verify that **Auth0** appears in the **Model Context Protocol (MCP) Servers** list.
3. Begin a conversation with Windsurf and ask for help managing your Auth0 tenant.

<div id="common-troubleshooting-steps">
  ## Common troubleshooting steps
</div>

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Most connection issues can be resolved by configuring the Auth0 MCP server and restarting the MCP client.
</Callout>

<div id="get-command-line-help">
  #### Get command line help:
</div>

View a list of supported commands and usage examples with:

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

<div id="authentication-issues">
  #### Authentication issues
</div>

Ensure correct permissions in your Auth0 tenant and try re-initializing with:

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

<div id="connection-failures">
  #### Connection failures:
</div>

1. Confirm the MCP server is actively running with:

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

2. Restart your AI client after verifying the server is running.

<div id="claude-cant-connect-to-the-server-error">
  #### Claude Can't Connect to the Server error:
</div>

1. Restart Claude Desktop after installation.
2. Check that the server is running with:

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

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

Check your Auth0 token permissions and expiration. Enable debug mode (see below) to view detailed logs.

<div id="debug-configuration-issues">
  ## Debug configuration issues
</div>

<div id="enable-debug-mode">
  #### Enable debug mode
</div>

Enable debug mode to view detailed logs:

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

<div id="debug-client-logs">
  #### Debug client logs
</div>

Get detailed MCP client logs from Claude Desktop:

```bash lines theme={null}
# Follow logs in real-time
tail -n 20 -F ~/Library/Logs/Claude/mcp*.log
```

Get detailed MCP server logs by running the Auth0 MCP Server in debug mode:

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

<div id="advanced-debugging-using-mcp-inspector">
  #### Advanced debugging using MCP Inspector
</div>

For advanced troubleshooting, use the MCP Inspector:

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

<div id="next-steps">
  ## Next steps
</div>

Explore the full capabilities of Auth0 MCP Server by visiting our [Auth0 Model Context Protocol (MCP) Server Tools Reference](/docs/fr-CA/fr-ca/get-started/auth0-mcp-server/auth0-mcp-tools-reference), or check out our Auth0 Model Context Protocol Server Guides for practical examples and use cases.