Notion
Conecta Cursor con Notion para delegar especificaciones, tareas y comentarios a los agentes de programación. Como la integración se basa en el SDK de Cursor, todos los agentes de programación usan el mismo entorno de ejecución, harness y modelos que impulsan Cursor.
La configuración, el chat, las @menciones y la asignación de tareas se realizan en Notion. Cursor ejecuta el agente de programación en una VM segura y aislada de Cloud Agent, por lo que sigue funcionando en segundo plano mientras realizas otras tareas.
Consulta la documentación completa de Notion aquí.
Cursor en Notion está en fase beta y está disponible para todos los usuarios de Cursor con planes Notion Business o Enterprise.
Primeros pasos
Requisitos
Antes de conectar Cursor con Notion, asegúrate de contar con lo siguiente:
- GitHub conectado a tu cuenta de Cursor para acceder a repositorios y crear pull requests
- Una clave de API de usuario de Cursor, que crearás durante la configuración
El consumo de Cursor en Notion se factura a través de tu cuenta actual y está disponible sin coste adicional.
Instalación
- En Notion, ve a Agents en la barra lateral → New Agent → Cursor.
- Elige un punto de partida para tu agente:
- Empieza con una plantilla predeterminada: las plantillas para tareas habituales (como Code Q&A y Bug Triage) te ayudan a personalizar Cursor para flujos de trabajo específicos.
- Empieza desde cero: configura tus propias instrucciones, activadores y conexiones con el harness estándar de Cursor.
- Crea u obtén tu clave de API de Cursor en tu Panel de control e introdúcela en Notion.
- Añade las páginas, bases de datos y espacios de Notion que necesite tu agente, como tu base de datos de tareas de ingeniería y páginas de especificaciones.
- Guarda el agente y empieza a trabajar.
Cursor ya está conectado y tu agente puede escribir código y abrir pull requests desde las tareas o el chat del agente.
Permisos
- La conexión está vinculada a tu clave de API personal. Esto significa que el acceso y la actividad en Cursor están vinculados a tu cuenta individual de Cursor, no a todo el espacio de trabajo. Más información →
- Los repositorios, el entorno y las conexiones proceden de la configuración de tu agente de Cursor. Configúralos en el panel de control de Cursor.
- Cada agente de Cursor solo puede acceder al contenido que hayas compartido en Notion. Los permisos se configuran por agente en Notion y no se heredan de quien inicia una ejecución.
Cómo usarlo
Lleva Cursor a tus tableros de tareas, documentos de especificaciones y otros contextos que ya están en Notion.
Si intentas usar Cursor en un espacio de trabajo donde no tiene permisos, configura una ventana emergente para concederle acceso.
Menciona al agente
Empieza con un documento de especificación o una página. Deja un comentario y menciona a Cursor con @. Pídele que elabore la especificación, perfeccione el plan o responda una pregunta.
Cursor responde en los comentarios. Haz clic en Ver chat para abrir la conversación completa.
La primera vez que menciones al agente en una página, aprueba el acceso a la página cuando se te solicite.
Ejemplos de instrucciones:
- "Crea un plan para esta especificación. Espera aprobación."
- "Revisa este documento y señala todo lo que no esté claro."
- "Convierte esto en una lista de tareas concretas y luego abre PR para cada una."
Asignar una tarea
En una base de datos o un tablero de tareas, asigna una tarea a Cursor. El agente:
- Actualizará el estado de la tarea mientras trabaja
- Publicará actualizaciones de progreso como comentarios
- Incluirá enlaces a las páginas o PR que cree
Solución de problemas
El agente no puede acceder a una página o base de datos
- Confirma que la página o base de datos figure en Herramientas y acceso, no solo como referencia en las instrucciones.
- Confirma que la página no esté restringida a un grupo al que no pertenezca el agente.
- Si la página es privada, compártela directamente con el agente.
La conexión con GitHub falla o el agente no puede hacer push
- Confirma que el token tenga los permisos Contents: lectura/escritura y Pull requests: lectura/escritura.
- Comprueba si tu organización de GitHub requiere SSO o aprobación de la organización.
- Confirma que el repositorio predeterminado de tu configuración sea correcto.
- Regenera el token si ha caducado y vuelve a conectarte.
El agente no se activó cuando lo mencioné con @
- Confirma que el activador agente mencionado esté activado.
- Menciona al agente en un comentario en lugar de en el cuerpo de la página. Los comentarios son más fiables.
- Confirma que el agente tenga acceso a la página en la que lo mencionaste.
Preguntas frecuentes
¿Cómo funciona la facturación?
El consumo de Cursor en Notion se factura a través de tu cuenta de Cursor, igual que el consumo de Cloud Agent. Está disponible para todos los usuarios de Cursor sin coste adicional. También necesitarás un plan Business o Enterprise de Notion.
¿Dónde puedo consultar la actividad de Cursor?
Los resultados aparecen en Notion, en la página o tarea donde se ejecutó el agente. También puedes consultar tus sesiones de chat en la vista del agente de Notion o en Cursor.
¿Las ejecuciones de Cursor iniciadas desde Notion respetan la retención cero de datos (ZDR)?
Sí. Las ejecuciones de los agentes de programación respetan tus ajustes de privacidad actuales de Cursor.