Conectar Claude Code

Agregas el servidor con un comando y lo autorizas con otro. Claude Code es el cliente más corto de conectar a Vitrina.

Agregar el servidor

Elige dónde va a existir

Por omisión, el servidor queda en este proyecto y solo para ti. Si quieres a Vitrina en todos tus proyectos, agrégalo con -s user.

Corre `claude mcp add`

claude mcp add --transport http vitrina https://api.vitrinadev.com/mcp

Added HTTP MCP server vitrina with URL: https://api.vitrinadev.com/mcp to local config

--transport http no es opcional: sin él, Claude Code asume que vitrina es un comando que tiene que ejecutar y falla al arrancarlo.

Confirma que lo ve, y que todavía no entra

claude mcp list

Checking MCP server health…

vitrina: https://api.vitrinadev.com/mcp (HTTP) - ! Needs authentication

! Needs authentication es el estado correcto en este punto. Claude Code llamó a Vitrina, recibió el 401 con la dirección del servidor de autorización, y espera que lo autorices.

Autorizar

Dos caminos, el mismo resultado. Dentro de una sesión de Claude Code:

/mcp

y eliges vitrina → Authenticate. O, desde la terminal:

claude mcp login vitrina

Starting authentication for "vitrina"…
If the browser didn't open, visit:
  https://api.vitrinadev.com/oauth/authorize?response_type=code&client_id=…

Waiting for authorization… (^C to cancel)
Or paste the redirect URL here:

Se abre el navegador en Vitrina. Entra con tu cuenta, revisa los permisos, marca la casilla de costos si la quieres, y presiona Permitir. La pestaña vuelve sola a localhost y la terminal termina:

Authenticated with "vitrina". Its tools are now available in Claude Code.

claude mcp list

vitrina: https://api.vitrinadev.com/mcp (HTTP) - ✔ Connected

Desde ahí tu asistente ya lee el workspace: los leads sin responder, la agenda de la semana, el catálogo.

En una sesión sin navegador (por SSH, dentro de un contenedor) usa claude mcp login vitrina --no-browser. Imprime la URL, la abres donde quieras, y pegas de vuelta la dirección completa a la que te redirigió.

Trampa

El puerto del callback cambia en cada intento

Claude Code escucha en un puerto de localhost distinto en cada intento, y Vitrina lo acepta. Si ves redirect_uri inválido en la pantalla de autorización, no es algo que hayas escrito mal: sigue los pasos de Diagnosticar una conexión MCP.

Sin navegador: una clave de conexión

Para una máquina que no puede abrir un navegador ni guardar una sesión (un servidor, un runner de CI) hay una segunda forma. En la aplicación, Conexiones → MCP → Crear clave de conexión, y:

claude mcp add --transport http vitrina https://api.vitrinadev.com/mcp \
  --header "Authorization: Bearer $VITRINA_CONNECTOR_KEY"

Added HTTP MCP server vitrina with URL: https://api.vitrinadev.com/mcp to local config
Headers: {
  "Authorization": "[REDACTED]"
}

claude mcp list

vitrina: https://api.vitrinadev.com/mcp (HTTP) - ✔ Connected

Conectado de inmediato, sin el paso de autorización: la clave ya es la credencial. La contrapartida es que es un secreto que tú guardas y que no caduca solo. Trátalo como cualquier otra key sk_ (Autenticación).

Revisar y desconectar

claude mcp get vitrina

vitrina:
  Scope: Local config (private to you in this project)
  Status: ✔ Connected
  Type: http
  URL: https://api.vitrinadev.com/mcp

To remove this server, run: claude mcp remove vitrina -s local

claude mcp remove lo saca de tu máquina. Eso no revoca nada del lado de Vitrina: la autorización sigue viva en Conexiones → MCP → Aplicaciones conectadas, y ahí es donde se corta de verdad.

Trampa

Si la autorización se rompe sola: claude mcp logout

Claude Code guarda las credenciales OAuth de cada servidor en el llavero del sistema. Si algo las deja inconsistentes (reinstalaste, cambiaste de cuenta, el servidor se reconstruyó), el síntoma es una pantalla de autorización que falla al empezar, no un error en la terminal.

claude mcp logout vitrina
claude mcp login vitrina

logout borra lo guardado para ese servidor y nada más. Córrelo desde el directorio del proyecto si lo agregaste con el alcance por omisión.