Hoja de trucos Cursor (2026): Agent, Ask, rules, MCP y atajos

Modos, archivos de reglas, configuración de MCP, y atajos para el editor Cursor. El panel Agent es la superficie de chat: busca el repo, edita archivos, y ejecuta la terminal. Una comparación con dos otros agentes de codificación está en Claude Code vs Copilot vs Cursor.

Modos

Abre el panel con Cmd+I (macOS) o Ctrl+I (Windows y Linux). Shift+Tab alterna modos. Cmd+. o Ctrl+. abre el menú de modo. Un cambio comienza una ventana de contexto nueva. El modo agent de Copilot es un producto diferente.

Plan guarda el plan en tu directorio home. Save to workspace lo mueve al proyecto. Ver desarrollo dirigido por especificaciones. Mientras Agent funciona, Enter encola la siguiente nota. En macOS, Cmd+Enter la envía ahora. Restore Checkpoint revierte archivos y mantiene la transcripción.

Tab y el atajo de edición en línea antiguo

Tab completa desde ediciones recientes, código cercano, y errores de linter, mostrados como texto gris. Puede cambiar varias líneas, agregar un import, o saltar a otro archivo (aparece un portal al fondo del editor). Tab de nuevo, después de aceptar, se mueve a la siguiente edición predicha. Las reglas no afectan Tab. Pospone o desactívalo desde el indicador Tab al fondo a la derecha.

La página antigua de edición en línea ahora describe Agent. Con código seleccionado, Cmd+K o Ctrl+K abre Agent con esas líneas. Cmd+L y Ctrl+L hacen lo mismo. Los docs dicen que Cmd+K solía abrir edición en línea y que esto ha sido reemplazado. Las mismas teclas cierran el panel lateral cuando no están vinculadas a un modo. En la Agents Window, Cmd+K o Ctrl+K abre la paleta de comandos para transcripciones pasadas. Cmd+F o Ctrl+F busca en la conversación abierta.

Menciones @

Escribe @ y continúa escribiendo para filtrar. Sáltalo cuando no conozcas el archivo. Agent buscará. Repite @ para adjuntar más de un elemento. / ejecuta una habilidad para un mensaje. Option+Enter (macOS) o Alt+Enter (Windows) mantiene esa habilidad como un Modo Personalizado.

Agent puede buscar la web con su herramienta Web. Eso no es una mención @. Los docs de mención actual no listan @Docs o @Web.

Reglas y AGENTS.md

Las reglas son instrucciones al inicio del contexto del modelo. Las reglas de proyecto, usuario, y equipo aplican en Agent, Ask, Plan, y Debug. No aplican a Tab, y .cursor/rules no es lo que Bugbot lee.

Las reglas de proyecto son archivos .mdc en .cursor/rules, incluyendo subcarpetas. Un archivo .md ahí se ignora. Compromete la carpeta. Crea una con New Cursor Rule en la paleta de comandos (Cmd+Shift+P o Ctrl+Shift+P), desde Customize, o con /create-rule.

Separa globs con comas. Mantén una regla bajo 500 líneas. Una ruta como @service-template.ts apunta Agent a un archivo. El archivo no está incrustado, así que cualquier cosa que deba estar siempre presente va en el cuerpo de la regla.

---
description: Cómo este repo ejecuta tests
alwaysApply: false
---

- Ejecuta tests con `npm test` desde la raíz del repositorio
- No edites nada bajo `dist/` o `build/`

AGENTS.md es Markdown plano, en la raíz o en un subdirectorio. Los archivos anidados aplican bajo ese directorio, se combinan con padres, y el archivo más cercano gana. Cursor lee CLAUDE.md del mismo modo y siempre lo aplica, ignorando alwaysApply. Eso se superpone con Claude Code.

Las reglas de usuario en Customize, Rules, se sincronizan con tu cuenta. Los archivos en ~/.cursor/rules (en Windows, %USERPROFILE%\.cursor\rules) permanecen en esa máquina. Las Team Rules vienen del panel en planes Team y Enterprise. En un conflicto el orden es Team, luego Project, luego User.

.cursorrules en la raíz del proyecto es legacy y será deprecado. Pégalo en una regla Always Apply y borra el archivo viejo.

MCP

MCP conecta Agent a herramientas externas. Setup que no es específico de Cursor está en MCP servidores explicados. Cursor soporta stdio local, SSE, y HTTP Streamable. Agent llama una herramienta cuando es relevante, incluyendo en Plan Mode, y pregunta primero a menos que Run Mode permita la llamada. Alterna servidores en Customize. Los logs están bajo MCP Logs en el panel Output (Cmd+Shift+U en macOS).

Una entrada local establece command, args, y env. Una entrada remota establece url y headers opcionales. Solo stdio acepta envFile. Los valores pueden usar ${env:NAME} y ${workspaceFolder}. La CLI lee el mismo archivo. Los bucles de herramientas son el patrón en IA agentiva.

{
  "mcpServers": {
    "repo-tools": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}

Cloud Agents y Bugbot

Cloud Agents se llamaban Background Agents. Se ejecutan en una VM aislada y pueden abrir un pull request. Comienza desde Cloud bajo la entrada de agent, desde cursor.com/agents, o con @cursor en Slack, Linear, GitHub, o Bitbucket. En la CLI, prefija el mensaje con &. A partir de octubre de 2026, los docs requieren Premium o superior, Teams, Enterprise, o un plan pagado legacy. Free y Plus no los incluyen. Tab no se ejecuta en la nube.

Bugbot comenta en diffs de pull-request, en cada actualización o después de cursor review o bugbot run. Una cuenta de bot o GitHub App publicándolos se ignora. .cursor/rules no aplica. Pon notas de revisión en .cursor/BUGBOT.md. El archivo raíz siempre se incluye. Un archivo anidado aplica cuando rutas cambiadas se sientan bajo él. Las configuraciones opcionales viven en .cursor/config/bugbot.yaml en la rama base.

/review y /review-bugbot, en Cursor 3.7+, en cursor.com/agents, y en la CLI, revisan el diff de rama contra la base default, incluyendo ediciones sin comprometer.

CLI

El comando documentado es agent.

agent --version y agent update verifican y actualizan la CLI. En macOS, Linux, o WSL, agrega ~/.local/bin a PATH si agent falta. /summarize encoge contexto (/compress es un alias). Ctrl+J inserta una nueva línea. Ctrl+D sale en el segundo press. La CLI carga .cursor/rules más root AGENTS.md y CLAUDE.md. Debug es solo editor.

Modelos y Privacy Mode

Cmd+/ o Ctrl+/ alterna modelos. En macOS, Cmd+Option+/ cambia el modelo. La opción permanece hasta que la cambies. Auto usa Cursor Router y puede cambiar modelo entre turnos.

A partir de octubre de 2026, Free y Plus incluyen Grok 4.7, Grok 4.6, Grok 4.5, y Composer 2.5. Premium y superior, Teams, Enterprise, y legacy Pro, Pro+, y Ultra desbloquean modelos de terceros.

Privacy Mode mantiene código fuera del entrenamiento de Cursor y de proveedores de modelos. Actívalo bajo General en settings (Cmd+Shift+J o Ctrl+Shift+J). Los equipos Enterprise lo tienen activado por defecto, y un admin puede bloquearlo. Tus propias API keys siguen la política del proveedor. Los modelos que requieren retención de datos del proveedor permanecen apagados hasta que un admin los aprueba.

Atajos de teclado

Abre el mapa completo con Cmd+R luego Cmd+S, o Ctrl+R luego Ctrl+S. Los acordes de Windows abajo son solo los que una página de ayuda indica.

Patrones que reutilizarás

Shift+Tab a Ask cuando la respuesta no debe tocar archivos
Shift+Tab a Plan, edita el plan, luego construye
Selecciona el test fallando, presiona Ctrl+L, y nombra la corrección
Tab acepta, Escape salta, Ctrl+Right toma una palabra
Pon instrucciones repetidas en .cursor/rules/*.mdc y tokens en ${env:API_KEY}
agent --mode=ask -p "list failing tests and their files"
Prefija & cuando la ejecución debe continuar después de que la laptop se apague

Nombra el archivo y qué significa terminar. El mismo hábito está en la hoja de trucos de prompting ChatGPT. Un test fallando antes de la edición es el bucle en TDD asistido por IA.

Preguntas frecuentes

¿Es Chat un modo separado de Agent en Cursor?

La documentación actual describe un panel Agent, también llamado Agent Chat, y cuatro modos adentro: Agent, Ask, Plan, y Debug. No hay modo Chat separado en esa lista. Abre el panel con Cmd+I o Ctrl+I, luego cambia con Shift+Tab o el selector de modo. Cambiar modos comienza una ventana de contexto fresca.

¿Dónde viven las reglas de proyecto de Cursor, y qué debería hacer con .cursorrules?

Las reglas de proyecto son archivos .mdc en .cursor/rules. Un archivo .md plano en esa carpeta se ignora. Las reglas de usuario viven en Customize, Rules, y se sincronizan con tu cuenta; los archivos bajo ~/.cursor/rules permanecen en esa máquina. .cursorrules en la raíz del repo es legacy. Cópialo a una regla Always Apply, luego borra el archivo viejo.

¿Qué hace Cmd+K o Ctrl+K en Cursor ahora?

Con código seleccionado, Cmd+K o Ctrl+K abre Agent con esas líneas en la entrada. Cmd+L y Ctrl+L hacen lo mismo. Los docs de ayuda dicen que Cmd+K solía abrir edición en línea y que ese flujo de trabajo ha sido reemplazado. Las mismas teclas también cierran el panel lateral cuando no están vinculadas a un modo.

¿Cómo agrego un servidor MCP en Cursor?

Pon un servidor de repo en .cursor/mcp.json o un servidor personal en ~/.cursor/mcp.json. Un servidor local establece command, args, y env. Un servidor remoto establece url y headers opcionales. La CLI lee el mismo mcp.json. Enciende o apaga servidores desde Customize.

¿Cómo ejecuto Cursor Agent desde la terminal?

Instala el script oficial, luego ejecuta agent. Shift+Tab rota Agent, Plan, y Ask. /plan y /ask cambian modos, y agent -p ejecuta un prompt y sale. Prefija un mensaje con & para pasar esa tarea a un Cloud Agent y recógelo en cursor.com/agents.