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

> Integra Auth0 Model Context Protocol (MCP) Server con tus clientes de IA.

# Primeros pasos con Auth0 Model Context Protocol (MCP) Server

<Card title="Antes de empezar">
  * Instala [Node.js v18 o superior](https://nodejs.org/en/download) en tu sistema.
  * Crea una [cuenta de Auth0](https://auth0.com/) activa con permisos administrativos.
  * Instala al menos un cliente MCP compatible ([Claude Desktop](https://claude.ai/download), [Cursor](https://www.cursor.com/downloads) o [Windsurf](https://www.windsurf.com/editor), por ejemplo).
</Card>

Capacita a tu equipo y a tus usuarios instalando [Auth0 Model Context Protocol (MCP) Server](/es/docs/get-started/auth0-mcp-server) e intégralo con varios [clientes MCP](https://modelcontextprotocol.io/clients) de uso habitual.

<div id="installation-and-configuration">
  ## Instalación y configuración
</div>

Instala Auth0 MCP Server ejecutando uno de estos comandos en tu terminal:

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

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

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

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

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

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

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

Para usar Auth0 MCP Server con cualquier otro cliente MCP, puedes añadir manualmente esta configuración al cliente y reiniciarlo para que los cambios surtan efecto:

```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">
  ## Autentícate con Auth0
</div>

Tu navegador se abrirá automáticamente para iniciar el <Tooltip tip="OAuth 2.0: Marco de autorización que define protocolos y flujos de autorización." cta="Ver glosario" href="/es/docs/glossary?term=OAuth+2.0">OAuth 2.0</Tooltip> flujo de <Tooltip tip="OAuth 2.0: Marco de autorización que define protocolos y flujos de autorización." cta="Ver glosario" href="/es/docs/glossary?term=authorization+flow">autorización para dispositivos</Tooltip>. Inicia sesión en tu cuenta de Auth0 y concede los permisos solicitados.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Las credenciales se almacenan de forma segura en el llavero del sistema. Si lo deseas, puedes verificarlo con la herramienta de administración del llavero.
</Callout>

<div id="verify-your-integration">
  ## Verifica tu integración
</div>

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

1. Reinicie Claude Desktop para asegurarse de que reconozca el Auth0 MCP Server recién instalado.
2. En Claude Desktop, haga clic en el icono de **Tools** y verifique que las herramientas de Auth0 (por ejemplo, `auth0_create_action` o `auth0_delete_application`) aparezcan en la lista **Available MCP Tools**.
3. Inicie una conversación con Claude Desktop y pídale ayuda para administrar su Tenant de Auth0.

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

1. Reinicia Cursor para asegurarte de que reconozca el Auth0 MCP Server recién instalado.
2. En Cursor, abre **Settings > MCP** y verifica que **Auth0** aparezca en la lista de **MCP Servers**.
3. Inicia una conversación con Cursor y pide ayuda para administrar tu Tenant de Auth0.

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

1. Reinicia Windsurf para asegurarte de que reconozca el MCP Server de Auth0 recién instalado.
2. En Windsurf, abre **Windsurf Settings > Cascade** y verifica que **Auth0** aparezca en la lista **Model Context Protocol (MCP) Servers**.
3. Inicia una conversación con Windsurf y pídele ayuda para administrar tu Tenant de Auth0.

<div id="common-troubleshooting-steps">
  ## Pasos habituales para solucionar problemas
</div>

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  La mayoría de los problemas de conexión se pueden resolver configurando el servidor MCP de Auth0 y reiniciando el cliente MCP.
</Callout>

<div id="get-command-line-help">
  #### Obtenga ayuda desde la línea de comandos:
</div>

Consulte una lista de comandos admitidos y ejemplos de uso con:

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

<div id="authentication-issues">
  #### Problemas de autenticación
</div>

Asegúrese de tener los permisos correctos en su Tenant de Auth0 e intente volver a inicializar con:

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

<div id="connection-failures">
  #### Fallos de conexión:
</div>

1. Confirme que el servidor MCP esté en ejecución con:

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

2. Reinicie su cliente de IA después de verificar que el servidor esté en ejecución.

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

1. Reinicia Claude Desktop después de la instalación.
2. Verifica que el servidor esté en ejecución con:

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

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

Verifica los permisos y el vencimiento de tu token de Auth0. Habilita el modo de depuración (consulta más abajo) para ver registros detallados.

<div id="debug-configuration-issues">
  ## Solucionar problemas de configuración
</div>

<div id="enable-debug-mode">
  #### Activar el modo de depuración
</div>

Active el modo de depuración para ver logs detallados:

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

<div id="debug-client-logs">
  #### Depurar los logs del cliente
</div>

Obtén logs detallados del cliente MCP desde Claude Desktop:

```bash lines theme={null}
# Seguir los logs en tiempo real
tail -n 20 -F ~/Library/Logs/Claude/mcp*.log
```

Obtén logs detallados del MCP Server al ejecutar Auth0 MCP Server en modo de depuración:

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

<div id="advanced-debugging-using-mcp-inspector">
  #### Depuración avanzada con MCP Inspector
</div>

Para la solución de problemas avanzada, use 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">
  ## Próximos pasos
</div>

Explore todas las capacidades de Auth0 MCP Server visitando nuestra [Referencia de herramientas de Auth0 Model Context Protocol (MCP) Server](/es/docs/get-started/auth0-mcp-server/auth0-mcp-tools-reference), o consulte nuestras guías de Auth0 Model Context Protocol Server para ver ejemplos prácticos y casos de uso.