> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Supervise cambios administrativos, de acceso y de configuración en sus equipos y organización de Cursor Enterprise

La integración de Cursor recopila el **audit log** de Cursor para la
supervisión de seguridad y la detección. Cubre inicios de sesión, cambios de
miembros y roles, el ciclo de vida de claves API y cuentas de servicio, límites
de gasto, modo de privacidad, hooks del equipo, reglas, servidores MCP,
integraciones y la política de red del cloud agent, sin
requerir software en los dispositivos de los empleados.

> [!NOTE]
>
> Wirespeed solo lee metadatos del audit log. No recopila prompts, historial
> de chat, código generado ni actividad de agentes.

## Requisitos previos

Los audit logs de Cursor requieren un plan **Cursor Enterprise**. Las claves API
del plan Teams no pueden leer el audit log, y Wirespeed las rechaza al conectar.

Elija la clave que coincida con su configuración de Cursor:

| Clave | Quién la crea | Ámbito | Audit log cubierto |
| - | - | - | - |
| **Organization API key** (recomendada cuando esté disponible) | Un administrador de la organización | `auditlogs:read` (solo lectura) | Todos los equipos vinculados a la organización, más eventos a nivel de organización como cambios de SSO y del proveedor de identidad |
| **Team API key** | Un administrador del equipo | permiso **View audit logs** (solo lectura) | Un equipo |

Una clave de organización solo existe cuando su empresa ha configurado una
**Organization** de Cursor que vincula sus equipos Enterprise. Si tiene un solo
equipo Enterprise sin organización, use una clave API de equipo.

## Paso 1: Crear una clave

### Organization API key

1. Inicie sesión en el [panel de Cursor](https://cursor.com/dashboard) como
   administrador de la organización
2. Abra la configuración **API Keys** de la organización y haga clic en **New API Key**
3. Nombre la clave, por ejemplo `Wirespeed Audit Log`, y seleccione el
   ámbito **`auditlogs:read`**
4. Cree la clave y cópiela

### Team API key

1. Inicie sesión en el [panel de Cursor](https://cursor.com/dashboard) como
   administrador del equipo
2. Abra **Settings → API Keys** y haga clic en **New API Key**
3. Nombre la clave, por ejemplo `Wirespeed Audit Log`
4. Abra la lista de permisos y seleccione **Audit logs → View audit logs**. Desactive
   cualquier otro permiso, incluido **General → View team resources**, que
   Cursor selecciona de forma predeterminada
5. Cree la clave y cópiela

Cursor muestra la clave una sola vez. Guárdela de forma segura.

## Paso 2: Conectar Cursor a Wirespeed

1. En Wirespeed, abra Integraciones → [**Añadir integración**](https://app.wirespeed.co/settings/integrations?tab=browse)
2. Busque y seleccione **Cursor**
3. Elija **Organization API key** o **Team API key** para que coincida con la clave que
   creó
4. Pegue la clave
5. Haga clic en **Integrar**

Wirespeed lee el audit log con la clave antes de habilitar la integración. Una
conexión correcta demuestra que la clave puede leer el audit log; no significa
que ya existan eventos.

## ¿Qué eventos se recopilan?

Wirespeed importa todos los tipos de evento que devuelve el audit log, incluidos:

* Inicios y cierres de sesión
* Invitaciones, altas, bajas, cambios de rol y credenciales
  revocadas de miembros
* Claves API de equipo, organización y usuario, cuentas de servicio y claves de
  cuenta de servicio
* Configuración del equipo, límites de gasto y modo de privacidad
* Hooks, reglas, comandos y servidores MCP del equipo
* Integraciones de Slack, repositorio y Bugbot
* Cambios de grupos de directorio, SSO y proveedor de identidad
* Secretos del cloud agent y política de red

La primera sincronización solicita hasta siete días de historial. Cada consulta
recopila a continuación eventos desde la ventana anterior en adelante, leyendo
dos minutos por detrás del tiempo real y releyendo un solapamiento breve para
capturar eventos indexados con retraso. Cursor limita cada solicitud del audit
log a una ventana de 30 días.

## Detecciones gestionadas

Wirespeed evalúa los eventos recopilados en busca de cambios de configuración y
postura. Son informativos salvo que se indique lo contrario:

| Detección | Evento |
| - | - |
| Usuario eliminado | `remove_user` |
| Rol de propietario asignado | `update_user_role` a `OWNER` o `FREE_OWNER` (persistencia) |
| Clave API o cuenta de servicio creada | `team_api_key`, `organization_api_key` o `user_api_key` creada; `service_account` creada; `api_key` creada o rotada (persistencia) |
| Clave API o cuenta de servicio revocada | `team_api_key`, `organization_api_key` o `user_api_key` revocada; `service_account` archivada |
| Límite de gasto cambiado | Límite de gasto del equipo o por usuario en `team_settings`, `user_spend_limit` o un límite de gasto de cuenta de servicio |
| Configuración del equipo cambiada | Cualquier otro cambio de `team_settings` |
| Servidor MCP del equipo cambiado | `mcp_server_config` con ámbito de equipo |
| Hook del equipo cambiado | `team_hook`. Los hooks del equipo ejecutan un script en la máquina de cada miembro |
| Regla o comando del equipo cambiado | `team_rule` o `team_command` |
| Integración cambiada | `slack_account_link`, `team_repo` o `bugbot_installation` |
| Modo de privacidad del equipo cambiado | `privacy_mode` con ámbito de equipo |
| Configuración de SSO cambiada | `organization_identity_provider` (solo claves de organización) |
| Política de red del cloud agent cambiada | `cloud_agent_environment_settings` |
| Inicio de sesión fallido | `login` con `success: false` |

Los inicios de sesión también se normalizan como eventos de autenticación para
búsquedas SIEM y detecciones de inicio de sesión entre plataformas.

## Solución de problemas

### Clave no válida

Un error `401` significa que la clave es incorrecta, está incompleta o se
revocó. Confirme que se pegó la clave completa sin espacios y, a continuación,
cree una clave de sustitución y actualice Wirespeed si es necesario.

### La clave no puede leer audit logs

Un error `403` significa que la clave no puede leer el audit log. Compruebe que:

1. Su plan de Cursor es **Enterprise**
2. Una clave de equipo tiene el permiso **Audit logs → View audit logs**
3. Una clave de organización lleva el ámbito `auditlogs:read`
4. El tipo de clave seleccionado en Wirespeed coincide con la clave: una clave
   de organización conectada como clave de equipo, o al revés, se rechaza

### La integración se conecta pero no aparecen eventos

Una integración en buen estado registra `0 new logs ingested` en cada consulta
cuando no existen eventos nuevos. Confirme que existen eventos antes de
esperarlos en Wirespeed:

```bash theme={null}
curl -sS "https://api.cursor.com/teams/audit-logs?startTime=7d&pageSize=5" \
  --config - <<< "user = \"$CURSOR_API_KEY:\""
```

Para una clave de organización, use `https://api.cursor.com/organizations/audit-logs`.
Una matriz `events` vacía significa que no hay nada que Wirespeed pueda ingestar.

### Limitación de velocidad

Cursor permite 20 solicitudes de audit log por minuto por equipo u organización,
compartidas entre todas las claves e integraciones. Ante una respuesta `429`,
Wirespeed mantiene su posición y reintenta en la siguiente sincronización.

## Recursos adicionales

* [Cursor compliance and monitoring](https://cursor.com/docs/enterprise/compliance-and-monitoring)
* [Cursor Admin API: audit logs](https://cursor.com/docs/account/teams/admin-api#get-audit-logs)
* [Cursor Organization Admin API](https://cursor.com/docs/account/organizations/organization-admin-api)
* [Cursor API overview](https://cursor.com/docs/api)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.