Guía · Unos 5 minutos

Cómo conectar Onplana con Claude Desktop

Cinco pasos. Genere un token, pegue el fragmento de configuración, reinicie Claude Desktop y compruebe con una llamada a una herramienta. Unos 5 minutos en total.

Después podrá pedirle a Claude 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 Claude hace el trabajo directamente en Onplana.

Abrir Onplana → Configuración → Agentes Descargar Claude Desktop

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 Claude Desktop (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 de Claude Desktop

    En Claude Desktop, haga clic en Settings → Developer → Edit Config. Se abre claude_desktop_config.json en su editor predeterminado. En macOS está en ~/Library/Application Support/Claude/claude_desktop_config.json; en Windows, en %APPDATA%\Claude\claude_desktop_config.json. Si el archivo está vacío o no existe, créelo 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": {"url": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}. Sustituya pat_paste-your-token-here por el token que copió en el paso 1. Guarde el archivo.

  4. 4

    Reiniciar Claude Desktop

    Cierre Claude Desktop por completo (Comando+Q en macOS, cierre total en Windows) y vuelva a abrirlo. La herramienta de Onplana debería aparecer en el selector de herramientas.

  5. 5

    Comprobar la conexión

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

claude_desktop_config.json

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

Cómo comprobar que funciona

Abra una conversación nueva en Claude Desktop 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.»

Claude le muestra la llamada a la herramienta en la conversación 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.

¿Hay OAuth como alternativa al token?

Sí. Onplana figura en el directorio de Connectors de Claude: en Claude Desktop (o en claude.ai) abra Settings, busque Connectors, explore el directorio, elija Onplana y apruebe el inicio de sesión en el navegador, sin pegar nada. Por debajo es OAuth 2.1 con PKCE, y Onplana publica metadatos de descubrimiento según RFC 9728 y RFC 8414 en https://mcp.onplana.com/.well-known/oauth-protected-resource y oauth-authorization-server. El camino con token pegado que se describe aquí es para cuando quiere el archivo de configuración; OAuth es para quien prefiere no gestionar tokens de larga duración.

¿A qué herramientas tiene acceso Claude?

346 herramientas: lectura (p. ej. list_projects, get_project, list_tasks, list_my_tasks, list_overdue, list_risks, search_org_knowledge, summarize_project, analyze_project_risks, generate_status_report), escritura (p. ej. create_project, create_task, update_task, assign_task, create_milestone, create_comment, bulk_update_tasks, create_sprint_with_tasks, submit_timesheet, link_dependency, move_task_to_sprint) y todas 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 Claude 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.

¿Puedo usar Claude Code (CLI) en lugar de Claude Desktop?

Sí. Claude Code trae soporte MCP integrado. Instalación en una línea: `claude mcp add onplana --transport http https://mcp.onplana.com/mcp`. Claude Code inicia OAuth en la primera llamada a una herramienta (sin token que pegar), abre un navegador para iniciar sesión en Onplana y completa el consentimiento; después, cualquier sesión de `claude` en ese proyecto ve el catálogo de herramientas de Onplana. Para usar un token en lugar de OAuth, añada `--header "Authorization: Bearer pat_…"` al comando. Compruebe con `claude mcp list`. Funciona en macOS, Linux y WSL en Windows.

¿Dónde puedo revocar la conexión?

En Onplana, Configuración → Agentes → Conexiones muestra cada conexión, tanto los tokens de acceso personal como los inicios de sesión en el navegador: elija Revocar en la fila. Surte efecto de inmediato; la siguiente llamada de Claude a una herramienta devuelve 401 y Claude le pide que vuelva a conectar.

¿Qué pasa si se filtra mi token?

Revóquelo de inmediato (ver arriba) y genere uno nuevo en el mismo panel. El token comprometido deja de funcionar en su siguiente llamada. Desde el plan Enterprise, un propietario o administrador de la organización ve cada llamada que hizo el token filtrado en la página Audit Logs, en Agent Activity, para revisar qué pudo ver o cambiar el atacante.

¿Funciona en Linux?

Claude Desktop solo existe por ahora para macOS y Windows. En Linux, use otro cliente MCP como el MCP Inspector oficial (npx @modelcontextprotocol/inspector) o Cursor (compatible con Linux), o integre la conexión de Onplana en un script de agente local con el SDK cliente tipado de TypeScript de Onplana.

Relacionado