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

# Claude Code

> Conecta el MCP de Tukan a Claude Code para consultar los datos de Tukan directamente desde tu terminal.

## Requisitos previos

* [Claude Code](https://docs.anthropic.com/en/docs/claude-code) instalado en tu terminal.
* Una cuenta de Tukan con créditos de consumo.

## Configuración

Elige una de las dos opciones según dónde quieras tener disponible el MCP:

<Tabs>
  <Tab title="Global (todos tus proyectos)">
    Recomendado si quieres acceder al MCP de Tukan desde cualquier directorio en tu computadora.

    ```bash theme={null}
    claude mcp add -s user --transport http tukan https://ai.tukanmx.com/mcp
    ```
  </Tab>

  <Tab title="Solo en el proyecto actual">
    Úsalo si prefieres limitar la conexión al directorio desde el que ejecutes el comando.

    ```bash theme={null}
    claude mcp add --transport http tukan https://ai.tukanmx.com/mcp
    ```
  </Tab>
</Tabs>

<Note>
  El comando es idéntico en macOS, Linux y Windows: el CLI de Claude Code es multiplataforma.
</Note>

La primera vez que Claude Code utilice la conexión, se abrirá una ventana de autenticación en tu navegador. Inicia sesión con tu cuenta de Tukan.

### Verificar la conexión

Para confirmar que el servidor MCP se agregó correctamente:

```bash theme={null}
claude mcp list
```

Deberías ver `tukan` en la lista de servidores configurados.

## Ejemplo de uso

Una vez conectado, puedes hacer consultas desde Claude Code:

<CodeGroup>
  ```text Ejemplo 1 theme={null}
  ¿Cuáles son los 10 estados con mayor cartera de crédito al consumo?
  ```

  ```text Ejemplo 2 theme={null}
  Genera una tabla con la captación bancaria por tipo de instrumento en el último trimestre.
  ```

  ```text Ejemplo 3 theme={null}
  ¿Cuántas cuentas de ahorro hay por estado en México?
  ```
</CodeGroup>

## Consideraciones

<Note>
  En ocasiones, Claude Code te pedirá que te reautentiques.

  Esto es normal y forma parte de las mejoras continuas del MCP de Tukan para garantizar una buena experiencia de nuestro servicio. Si esto sucede, simplemente sigue el proceso de autenticación nuevamente para restablecer la conexión.
</Note>