Guía · Unos 5 minutos

Cómo conectar Onplana con Windsurf

Cinco pasos. Genere un token, pegue el fragmento mcpServers (Windsurf usa serverUrl), actualice Cascade y compruebe con una llamada a una herramienta. Unos 5 minutos.

Después podrá pedirle a Cascade 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 Windsurf hace el trabajo directamente en Onplana sin salir del editor.

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

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 Windsurf (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 Windsurf Cascade

    En Windsurf, abra el panel Plugins (MCP) y elija "View raw config". Se abre mcp_config.json. En macOS y Linux está en ~/.codeium/windsurf/mcp_config.json; en Windows, en la carpeta .codeium\windsurf de su perfil de usuario. Si el archivo está vacío, empiécelo con {}.

  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": {"serverUrl": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}. Windsurf usa la clave "serverUrl" para servidores HTTP remotos (no "url"). Sustituya pat_paste-your-token-here por el token del paso 1 y guarde.

  4. 4

    Actualizar Cascade

    En el panel Plugins (MCP), haga clic en "Refresh" (la flecha circular) para que Cascade vuelva a leer la configuración y haga el handshake MCP. El servidor onplana debería mostrar un estado verde y un número de herramientas disponibles. Cascade mantiene activas como máximo 100 herramientas MCP y Onplana expone 346, así que si faltan herramientas de Onplana, desactive otros servidores o herramientas que no necesite.

  5. 5

    Comprobar la conexión

    En Cascade, pregunte: «lista mis proyectos de Onplana». Windsurf llama a la herramienta list_projects de Onplana y muestra el resultado. Si ve un error, revise el token, confirme que la clave es "serverUrl" (no "url") y que el JSON es válido.

~/.codeium/windsurf/mcp_config.json

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

Cómo comprobar que funciona

Abra Cascade 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.»

Cascade 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.

¿Por qué Windsurf usa "serverUrl" en lugar de "url"?

Es el esquema de configuración de Windsurf para servidores MCP remotos por HTTP. Claude Desktop y Cursor usan "url"; Windsurf Cascade usa "serverUrl". El resto de la entrada (el nombre del servidor onplana y la cabecera Authorization) es idéntico. Usar "url" por error es el motivo más habitual de que una conexión de Windsurf no aparezca sin dar error.

¿Es estable el soporte MCP de Windsurf?

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

¿A qué herramientas tiene acceso Windsurf?

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 Windsurf 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.

¿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 Windsurf 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