# Conecta Nickbox a VS Code

> Agrega Nickbox como servidor MCP HTTP en VS Code, desde la paleta de comandos o con .vscode/mcp.json.

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

VS Code agrega Nickbox como servidor MCP HTTP, desde la paleta de comandos o con un pequeño archivo JSON.

## Antes de empezar

- Una versión reciente de VS Code con soporte MCP y chat de agente disponible.
- Una cuenta de Nickbox con al menos un buzón conectado.
- Tu URL de MCP: aquí `https://nickbox.io/mcp`; la real está en el panel, en Conectar.

## Opción A: paleta de comandos

1. Abre la paleta de comandos y ejecuta **MCP: Add Server**.
2. Elige **HTTP**.
3. Pega la URL:

   ```text
   https://nickbox.io/mcp
   ```

4. Ponle el nombre `nickbox` y elige dónde guardarlo: tu perfil de usuario o el espacio de trabajo actual.
5. Cuando VS Code lo pida, permite que abra el navegador, inicia sesión con Google y aprueba el acceso de solo lectura.

## Opción B: editar el archivo

Crea `.vscode/mcp.json` en tu espacio de trabajo:

```json
{
  "servers": {
    "nickbox": {
      "type": "http",
      "url": "https://nickbox.io/mcp"
    }
  }
}
```

Ojo: VS Code usa `servers`, no `mcpServers`. Guarda el archivo e inicia el servidor con la acción **Start** que aparece sobre la entrada. VS Code abre el navegador para iniciar sesión.

## Comprueba que funciona

Abre el chat en modo agente, abre el selector de herramientas y confirma que las de Nickbox están activas. Luego pregunta:

```text
list my inboxes
```

Debes ver tus nombres cortos. VS Code pregunta antes de ejecutar una herramienta por primera vez.

## Solución de problemas

- **Falta MCP: Add Server.** Actualiza VS Code o revisa que tu organización no haya desactivado MCP.
- **El servidor no arranca.** Ejecuta **MCP: List Servers**, selecciona nickbox y abre su salida para ver el error.
- **Usaste `mcpServers` y no pasó nada.** Cámbialo a `servers` en `.vscode/mcp.json`.
- **La sesión expiró.** Ejecuta **MCP: List Servers**, elige nickbox y reinicia o inicia sesión de nuevo.
- **Google bloquea el acceso en Workspace.** Consulta la [guía para administradores de Workspace](/es/docs/workspace-admin).