GUÍA DE PROVEEDOR
Cursor
Despacha tareas a la API de agentes en segundo plano de Cursor — sin necesidad de ventana de IDE. El Bridge ejecuta un runner de Node.js que se comunica con Cursor mediante gRPC, manteniendo la compatibilidad con Bun.
Clave de API de Cursor Requiere Node.js (gRPC) Headless — sin IDE necesario
Requisitos
- ✓ Una cuenta de Cursor con una suscripción activa y acceso a la API
- ✓ Node.js 18+ instalado — el Bridge lanza un runner de Node.js para gRPC (incompatible con el runtime nativo de Bun)
- ✓ CTRL NODE Bridge instalado en tu máquina (GitHub)
¿Por qué Node.js? El SDK de Cursor usa binarios nativos de gRPC incompatibles con el runtime de Bun. El Bridge incorpora un
cursor-sdk-runner.mjs ligero y lo ejecuta automáticamente con Node.js — no tienes que hacer nada extra, solo tener Node.js instalado.
Inicio rápido
Ejecutar el Bridge
$ PAIRING_TOKEN=tu-token-de-emparejamiento \
CURSOR_API_KEY=cursor_… \
./ctrlnode
CURSOR_API_KEY=cursor_… \
./ctrlnode
Archivo .env
PAIRING_TOKEN=tu-token-de-emparejamiento
CURSOR_API_KEY=cursor_…
Variables de entorno
| Variable | Obligatoria | Descripción |
|---|---|---|
| CURSOR_API_KEY | Sí | Clave de API de Cursor desde la configuración de tu cuenta. |
Cómo el Bridge despacha tareas a Cursor
Cuando CTRL NODE despacha una tarea a un agente de Cursor:
- El Bridge lanza un proceso hijo de Node.js que ejecuta el
cursor-sdk-runner.mjsincorporado. - El runner se conecta a la API de agentes en segundo plano de Cursor mediante gRPC y envía la tarea.
- Las ediciones de código, la salida de la terminal y las respuestas del agente se transmiten de vuelta por el WebSocket del Bridge.
- Al finalizar, el estado de la tarea se actualiza en el panel de CTRL NODE. El proceso de Node.js finaliza limpiamente.
Nota: Cursor puede crear artefactos de node_modules en el workspace durante la ejecución de la tarea — esto es un comportamiento normal del SDK.