# Conecta Nickbox a Claude Code

> Agrega Nickbox a Claude Code con un comando e inicia sesión desde el menú /mcp.

Updated: 2026-10-03 · Canonical: https://staging.nickbox.io/es/docs/claude-code

Un comando agrega Nickbox a Claude Code, y el menú `/mcp` se encarga del inicio de sesión.

## Antes de empezar

- Claude Code instalado y funcionando en tu terminal.
- Una cuenta de Nickbox con al menos un buzón conectado.
- Tu URL de MCP. Aquí es `https://nickbox.io/mcp`; la real está en el panel, en Conectar.

## Pasos

1. Agrega el servidor desde la terminal:

   ```bash
   claude mcp add --transport http nickbox https://nickbox.io/mcp
   ```

   Por defecto se guarda para el proyecto actual. Agrega `--scope user` si lo quieres en todos tus proyectos.

2. Inicia Claude Code:

   ```bash
   claude
   ```

3. Dentro de Claude Code ejecuta:

   ```text
   /mcp
   ```

4. Selecciona **nickbox** y elige autenticar. El navegador abre la página de inicio de sesión de Nickbox.
5. Inicia sesión con Google y aprueba el acceso de solo lectura. Cuando el navegador diga que puedes cerrar la pestaña, vuelve a la terminal. El estado de nickbox debe indicar que está conectado.

## Comprueba que funciona

En Claude Code pregunta:

```text
list my inboxes
```

Debes ver los nombres cortos que pusiste en el panel. También puedes confirmar el registro desde la terminal:

```bash
claude mcp list
```

## Solución de problemas

- **El navegador no se abre.** Claude Code suele mostrar la URL de inicio de sesión en la terminal. Cópiala en un navegador.
- **nickbox vuelve a pedir autenticación.** Ejecuta `/mcp`, selecciona nickbox y autentica de nuevo. La sesión puede expirar o revocarse desde tu cuenta de Google.
- **Comando no encontrado u opción incorrecta.** Ejecuta `claude --version` y actualiza Claude Code. Las versiones antiguas usan otras opciones para servidores remotos.
- **Lo agregaste a un proyecto y falta en otro.** El alcance por defecto es el proyecto actual. Quítalo con `claude mcp remove nickbox` y agrégalo otra vez con `--scope user`.
- **Google bloquea el acceso en una cuenta Workspace.** Tu administrador debe permitir la app. Consulta la [guía para administradores de Workspace](/es/docs/workspace-admin).