Cursor Plugins: arquitectura de plugins oficiales y gestión del contexto del agenteArtículo · digest del 28 de octubre
Corte isométrico arquitectónico de un sistema modular de plugins para editor de código con bloques flotantes del manifiesto plugin.json y MCP.
Artículo4 secciones≈ 7 min

Cursor Plugins: arquitectura de plugins oficiales y gestión del contexto del agente

Cualquier desarrollador que use el editor Cursor a diario en un equipo tarde o temprano acaba chocando con «la maldición del archivo .cursorrules». Al principio, ese archivo de configuración parece la solución perfecta: anotas un par de reglas de estilo, indicas la versión de Node.js, le pides al agente que use funciones flecha y todo va como la seda. Pero pasan un par de meses, el proyecto se llena de microservicios, se suman más compañeros al repositorio y la configuración se convierte en un muro de texto desestructurado de mil quinientas líneas. Al final, el agente se lía con sus propias reglas, la ventana de contexto se llena de ruido y el modelo empieza a alucinar con instrucciones contradictorias.

Para poner orden en este ecosistema, el equipo de Anysphere presentó el repositorio oficial abierto y la especificación de extensiones cursor/plugins. Es un salto cualitativo: en lugar de instrucciones monolíticas en texto plano, el editor pasa a una arquitectura modular de plugins con manifiestos declarativos, servidores de herramientas aislados y un control granular de la memoria del agente.

Anatomía de un plugin: de una sábana de texto a un manifiesto modular

Veamos cómo funciona un plugin de Cursor por dentro. La base de cada módulo es el estándar abierto de manifiestos plugin.json, alineado con la especificación comunitaria Agent Plugins (agent-plugins.org). El plugin ya no intenta resolver todos los problemas del mundo en un único archivo, sino que se organiza en un directorio bien estructurado donde se separan las habilidades (skills/), las reglas específicas por tipo de archivo (rules/), los servidores del protocolo Model Context Protocol (mcp.json), los hooks del sistema (hooks.json) y los comandos interactivos (commands/).

En la raíz del repositorio del marketplace se encuentra .cursor-plugin/marketplace.json, que registra los módulos disponibles. Cuando un usuario o un proyecto conecta un plugin, Cursor lee su manifiesto propio .cursor-plugin/plugin.json.

{
  "$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json",
  "name": "team-code-guard",
  "displayName": "Team Code Guard",
  "version": "1.0.0",
  "description": "Корпоративные правила код-ревью, проверка архитектурных слоев и запуск песочницы",
  "author": {
    "name": "Platform Team",
    "email": "platform@example.com"
  },
  "repository": "https://github.com/my-org/team-code-guard",
  "license": "MIT",
  "category": "Developer Tools",
  "keywords": ["audit", "architecture", "security", "review"],
  "skills": ["skills/**/SKILL.md"],
  "rules": ["rules/**/*.mdc"],
  "mcp": "./mcp.json",
  "minClientVersions": {
    "cursor": "0.45.0"
  }
}

Fíjate en el campo minClientVersions y en las rutas declarativas de reglas rules/**/*.mdc. El formato MDC (Markdown for Cursor) permite vincular instrucciones concretas a máscaras de archivos: por ejemplo, las reglas de validación de esquemas GraphQL solo se activarán en el contexto del agente cuando esté abierto o se esté modificando un archivo con extensión .graphql.

Plugins del sistema: desde auditorías a fondo hasta aprendizaje continuo

El catálogo cursor/plugins ya reúne más de 80 plugins listos para usar, repartidos entre utilidades de desarrollo, productividad de oficina e integraciones con plataformas SaaS externas. A mí me llamaron especialmente la atención varios módulos de ingeniería que demuestran la madurez de esta arquitectura:

  1. Plugin thermos: Todo un arsenal para auditar ramas en profundidad antes de hacer merge. El módulo lanza subagentes en paralelo que analizan con lupa la seguridad de las dependencias, buscan fugas de memoria, ejecutan linters y preparan un Pull Request listo para fusionar con una descripción exhaustiva de cada cambio.
  2. Plugin continual-learning (autor: Eric Zakariasson): Resuelve el problema clásico de la amnesia del agente entre sesiones. El plugin analiza la transcripción de la conversación tras resolver una tarea técnica compleja, extrae los escollos poco evidentes del proyecto y actualiza de forma concisa la memoria a largo plazo en AGENTS.md, descartando el ruido innecesario.
  3. Plugins de visualización pr-review-canvas y docs-canvas: Convierten la aburrida salida de texto de la terminal en lienzos interactivos con zoom dentro del propio IDE, lo que permite explorar visualmente relaciones arquitectónicas y diffs complejos.
  4. Stacks de ingeniería pstack y dyl-stack: Imponen al modelo una metodología de análisis de causa raíz (Root Cause Analysis). El agente tiene terminantemente prohibido aplicar parches superficiales (monkey-patching): está obligado a localizar el defecto en el núcleo de la arquitectura.

Si recuerdas nuestra guía práctica de Cursor para empresas: automatización del desarrollo, allí ya insistíamos en la importancia de contar con un entorno estable, y este nuevo sistema de plugins lleva esa estabilidad al nivel de un estándar corporativo.

Integración con Model Context Protocol mediante mcp.json

La especificación de plugins da el siguiente paso lógico: integra de forma nativa en la arquitectura el protocolo MCP (Model Context Protocol). Si un plugin necesita herramientas externas —como abrir un navegador para pruebas end-to-end con Playwright, lanzar consultas analíticas a ClickHouse o levantar una base de datos aislada en Docker—, estas se declaran en el archivo mcp.json.

{
  "mcpServers": {
    "internal-linter": {
      "command": "node",
      "args": ["./dist/mcp-linter-server.js"],
      "env": {
        "NODE_ENV": "production"
      }
    },
    "db-sandbox": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-p", "5432:5432", "postgres:16-alpine"]
    }
  }
}

Cuando se abre el proyecto en Cursor, el entorno inicializa automáticamente los servidores de herramientas declarados. El agente obtiene acceso tipado a ellos mediante function calling, pero permanece aislado dentro de los límites establecidos.

Escollos y seguridad en la gestión de secretos

Por muy potente que sea esta arquitectura de plugins, conviene evaluar con cabeza fría sus límites de aplicación y sus riesgos de seguridad.

El principal escollo tiene que ver con el manejo de datos confidenciales. Los plugins que se integran con servicios externos (GitHub, Slack, Databricks, Brex) requieren tokens de acceso. Está terminantemente prohibido escribir secretos a fuego dentro de los manifiestos o en los scripts auxiliares del plugin. La especificación de Cursor exige usar la sección de variables de entorno variables, solicitando los valores al usuario a través de la interfaz protegida de ajustes del editor.

El segundo matiz es la compatibilidad multiplataforma. Aunque el manifiesto base plugin.json se apoya en el estándar abierto agent-plugins.org, ciertas funciones específicas como los lienzos integrados (canvas) o los hooks propietarios del entorno solo están disponibles por ahora dentro de Cursor.

Aun así, el paso hacia los plugins modulares marca la madurez de todo el sector: el agente de desarrollo deja definitivamente de ser un juguete para generar código repetitivo y se convierte en una herramienta corporativa escalable.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 2