# Conectar Claude Code, Cursor o VS Code con una API key

URL: https://ventix.smartbusiness.site/manual/asistentes-de-ia/conectar-con-una-api-key

Los programas que no tienen inicio de sesión con Ventix, como Cursor y VS Code, se conectan con una **API key**. Claude
Code puede usar cualquiera de las dos formas. Este artículo es para personas con algo de experiencia técnica. Para
conectar otro sistema (una tienda, un ERP) en lugar de un asistente, usa la [API pública](https://ventix.smartbusiness.site/manual/api).

## Antes de empezar

- Plan **Enterprise** y un usuario **Administrador**.
- La API key actúa con el usuario que la crea, con sus roles.

## Crear la API key

1. Abre **Configuraciones Globales → API Keys** y pulsa **Conectar con IA**. Se abre **Conectar un asistente de IA**.
2. Pulsa **Nueva API Key**. Elige solo los permisos que necesita el asistente; con **Solo lectura** se marcan las
   lecturas que no muestran costos. Los permisos se explican en
   [Elegir los permisos](https://ventix.smartbusiness.site/manual/asistentes-de-ia/elegir-los-permisos).
3. Copia la clave cuando aparece: Ventix no la vuelve a mostrar.
4. En la misma ventana, elige tu programa y copia su configuración. La clave va en el encabezado `X-API-Key`.

Usa una clave distinta para cada asistente: así puedes revocar una sin afectar a las demás.

## Claude Code sin API key

Claude Code también puede conectarse con tu usuario, como Claude en la web:

```bash
claude mcp add --transport http ventix https://ventix-api.smartbusiness.site/mcp
```

Después escribe `/mcp` en Claude Code y elige autenticar. Se abre Ventix en el navegador y la conexión vuelve a tu
computadora (`localhost`). Ventix te advierte de eso: apruébala solo si tú acabas de iniciarla.

## Cuidar la clave

- La API key es como una contraseña: no la pegues en chats ni la subas a repositorios.
- Si se filtra, revócala en **Configuraciones Globales → API Keys** y crea otra. La revocación es inmediata.