Guía · Unos 5 minutos

Cómo conectar Onplana con Cursor

Cinco pasos. Genere un token, pegue el fragmento mcpServers, recargue Cursor y compruebe con una llamada a una herramienta. Unos 5 minutos.

Después podrá pedirle al Agent de Cursor cosas como «crea un plan de proyecto para el lanzamiento del Q3 con hitos semanales» o «resume los riesgos de esta semana en todos los proyectos activos», y Cursor hace el trabajo directamente en Onplana sin salir del editor.

Abrir Onplana → Configuración → Agentes Documentación MCP de Cursor

Los cinco pasos

  1. 1

    Generar un token de conexión de Onplana

    Inicie sesión en Onplana en app.onplana.com. Vaya a Configuración → Agentes → Conectar agente, elija el mosaico Cursor (o Custom MCP client), luego Token de acceso personal y después Generar token y mostrar el fragmento de conexión. Copie el token de acceso personal (empieza por pat_). El token solo tiene el alcance MCP_AGENT: puede llamar a herramientas MCP, pero no crear otros tokens, cambiar la facturación ni tocar nada fuera de la superficie MCP.

  2. 2

    Abrir la configuración MCP de Cursor

    En Cursor, abra Settings (Comando+Mayús+J en macOS, Ctrl+Mayús+J en Windows o Linux), vaya a Tools & MCP y elija New MCP Server. Cursor también lee directamente una configuración JSON: para el proyecto en .cursor/mcp.json en la raíz de su repositorio, o global en ~/.cursor/mcp.json. Editar el JSON da el mismo resultado que la interfaz.

  3. 3

    Pegar la configuración del servidor MCP de Onplana

    Añada una entrada "onplana" bajo la clave "mcpServers". La configuración completa: {"mcpServers": {"onplana": {"url": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}. Sustituya pat_paste-your-token-here por el token del paso 1. Guarde el archivo.

  4. 4

    Recargar Cursor

    Recargue la ventana de Cursor (Comando+Mayús+P o Ctrl+Mayús+P, luego "Reload Window"), o desactive y vuelva a activar el servidor onplana en Settings, luego Tools & MCP. Las herramientas de Onplana aparecen en la lista de herramientas del Agent con un punto de estado verde en cuanto el handshake funciona.

  5. 5

    Comprobar la conexión

    En el chat del Agent de Cursor, pregunte: «lista mis proyectos de Onplana». Cursor llama a la herramienta list_projects de Onplana y muestra el resultado. Si ve un error, revise el token y confirme que el archivo de configuración es JSON válido.

.cursor/mcp.json (proyecto) o ~/.cursor/mcp.json (global)

{
  "mcpServers": {
    "onplana": {
      "url": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      }
    }
  }
}

Cómo comprobar que funciona

Abra el chat del Agent de Cursor y pruebe cualquiera de estas:

  • «Lista mis proyectos de Onplana.»
  • «¿Qué está atrasado en mi cuenta de Onplana?»
  • «Crea una tarea de Onplana en el proyecto X llamada ‘Migrar Postgres a Aurora’.»
  • «Genera un informe de estado del proyecto Y.»

Cursor muestra la llamada a la herramienta antes de ejecutarla, así puede revisar qué datos se leen o se escriben. Los cambios se aplican en todos los planes; en Free algunas acciones de escritura tienen un límite mensual (ninguno desde el plan Professional), y el agente puede pedir una vista previa que no confirma nada mediante su opción dryRun.

Preguntas frecuentes

¿Qué plan de Onplana incluye MCP?

MCP está incluido en todos los planes, incluido el gratuito. El número de conexiones de agentes simultáneas crece con el plan (Free 2, Professional 3, Business 5, Enterprise 10, Enterprise+ ilimitadas), y su saldo de tokens de IA (una asignación mensual en los planes de pago, un bono único en Free, más el crédito que compre) es lo que limita el uso real de la IA. Puede cambiar de plan cuando quiera en app.onplana.com/billing.

¿Es estable el soporte MCP de Cursor?

Sí, MCP es una función ya publicada en Cursor y no una vista previa. La conexión de Onplana se asocia al proveedor CURSOR y recibe todas las herramientas de lectura, creación y actualización. Aun así, la configuración de Cursor puede moverse entre versiones; si ocurre, consulte la ubicación actual en docs.cursor.com y mantenga la misma entrada del servidor onplana.

¿Configuración del proyecto o global?

Cualquiera. .cursor/mcp.json en la raíz de un repositorio limita la conexión a ese proyecto (útil cuando distintos repositorios corresponden a distintas organizaciones de Onplana con tokens separados). ~/.cursor/mcp.json aplica la conexión a todas las ventanas de Cursor. Si ambas definen un servidor "onplana", gana la del proyecto.

¿A qué herramientas tiene acceso Cursor?

Al mismo catálogo de 346 herramientas que ve cualquier cliente MCP: lectura (list_projects, get_project, list_tasks, list_my_tasks, list_overdue, list_risks, search_org_knowledge, summarize_project, generate_status_report), escritura (create_project, create_task, update_task, assign_task, create_milestone, create_comment, bulk_update_tasks, create_sprint_with_tasks, link_dependency) y las áreas de gobernanza, control de cambios, cumplimiento, documentos y flujos de trabajo. El plan habilita algunas herramientas; el catálogo completo está en onplana.com/mcp.

¿Puede Cursor eliminar proyectos o tareas por MCP?

Sí, de forma recuperable, salvo que un administrador lo haya desactivado. Las herramientas de eliminación por MCP son: eliminar una tarea, un proyecto, una lista o un documento. Cada una es un interruptor por espacio de trabajo que está activado hasta que un administrador guarde una elección, y quien llama sigue necesitando el permiso que necesitaría de todos modos. Todas eliminan de forma reversible a la papelera, y una tarea o un proyecto eliminado se guarda con todo su subárbol y se restaura con los identificadores originales, así que se conservan las dependencias y la jerarquía. Sprints, hitos, épicas y objetivos no tienen ninguna herramienta de eliminación por MCP.

¿Hay OAuth en lugar de pegar un token?

Onplana publica metadatos de descubrimiento de OAuth 2.1 (RFC 9728 y RFC 8414) en mcp.onplana.com/.well-known/. Que Cursor los use automáticamente depende del soporte de autenticación MCP de su versión de Cursor; el camino con el token en la cabecera que se describe aquí funciona en todas las versiones compatibles con servidores MCP remotos.

¿Dónde revoco la conexión?

En Onplana, en Configuración, luego Agentes, luego Conexiones, y Revocar en la fila del token. Surte efecto de inmediato; la siguiente llamada de Cursor a una herramienta devuelve 401. Desde el plan Enterprise, un propietario o administrador de la organización ve cada llamada que hizo el token en la página Audit Logs, en Agent Activity.

Relacionado