Conectar Nirvana a clientes de IA externos mediante MCP
Nirvana incluye un servidor nativo de Model Context Protocol (MCP). Conéctalo a un cliente de IA externo — Claude, ChatGPT, Cursor, VS Code, Claude Code, Gemini CLI o cualquier aplicación compatible con MCP — y ese cliente podrá leer y escribir tus tareas y proyectos directamente, sin necesidad de tener la aplicación Nirvana abierta.
Esto es independiente del asistente de IA integrado de Nirvana, que se ejecuta dentro de la aplicación. MCP sirve para conectar clientes de IA externos a tu cuenta.
A qué puede acceder el cliente de IA
Una vez conectado, el cliente puede:
- Leer tus tareas — por estado GTD (Entrada, Siguientes, En espera, Programadas, Algún día, Más tarde, Foco), por proyecto, por etiqueta o por rango de fechas
- Leer recuentos de tareas — totales por lista GTD
- Leer tus etiquetas — contextos y áreas con recuentos de uso
- Crear tareas y proyectos — con nombre, notas, estado, etiquetas, fecha límite, fecha de inicio programada, energía y tiempo estimado
- Actualizar tareas (requiere Nirvana Pro) — cambiar cualquier campo, completar, destacar, mover entre listas o enviar a la papelera
El cliente solo puede acceder a tus datos. No puede ver la cuenta de ningún otro usuario y nunca ve tu contraseña de Nirvana.
Cómo conectar
Las guías de configuración de todos los clientes compatibles están en nirvanahq.com/mcp — sin necesidad de iniciar sesión. Elige tu aplicación allí y sigue sus pasos. La conexión ocurre dentro de la propia aplicación de IA: abre la pantalla de inicio de sesión de Nirvana, apruebas el acceso y la aplicación aparece en Connected Apps de tu panel MCP.
| Cliente | Método de instalación |
|---|---|
| Claude (claude.ai) | Un clic en Open in Claude — abre el diálogo Add custom connector |
| ChatGPT | Un clic en Open in ChatGPT — te lleva a Settings → Connectors → Advanced |
| Claude Code | Comando CLI copiable claude mcp add |
| Cursor | Enlace directo Add to Cursor de un clic |
| VS Code | Add to VS Code de un clic con el servidor ya rellenado |
| Gemini CLI | Comando CLI copiable gemini mcp add (la propia aplicación Gemini aún no admite conectores) |
| Otros clientes | Fragmento copiable de mcpServers.json (Continue, Zed y cualquier cliente que lea ese formato) |
Las guías de nirvanahq.com/mcp son la fuente de verdad para los pasos de instalación — se mantienen al día a medida que los conectores evolucionan. La URL del servidor MCP de Nirvana es siempre https://mcp.nirvanahq.com/mcp.
Requisitos de plan
Por parte de Nirvana: las cuentas gratuitas tienen acceso completo de lectura más creación de tareas y proyectos. Actualizar tareas existentes (renombrar, reetiquetar, completar, destacar, mover entre listas) requiere Nirvana Pro.
Por parte del cliente: la mayoría de los clientes MCP (Claude, Cursor, Claude Code, VS Code, Gemini CLI) funcionan en sus niveles gratuitos o de pago. ChatGPT requiere un plan de pago — el Developer Mode está disponible en las cuentas Plus, Pro, Business, Enterprise y Edu, con acceso completo de lectura y escritura (ChatGPT te pide confirmar cada acción de escritura; en Business y superiores, un administrador del espacio de trabajo puede restringirlo). Los planes Free y Team no tienen Developer Mode por el momento, y el flujo es solo web — todavía no hay soporte MCP en la aplicación móvil de ChatGPT.
Modelo de seguridad
Todos los clientes compatibles se autentican a través de la pantalla de inicio de sesión de Nirvana y reciben un token de acceso de corta duración más un token de actualización — nunca se pega una contraseña ni un secreto de larga duración en el cliente de IA.
Todas las solicitudes se limitan a tu única cuenta de Nirvana. El servidor MCP no puede leer ni escribir los datos de nadie más.
Gestionar y revocar el acceso
El panel MCP muestra en Connected Apps todas las aplicaciones conectadas a tu cuenta. Desconecta cualquiera de ellas en cualquier momento — el acceso termina de inmediato.
Si sospechas que una sesión está comprometida, desconéctala desde el panel y vuelve a conectar el cliente afectado.
Para desarrolladores
¿Estás creando tu propio agente o script? mcp.nirvanahq.com/developers ofrece tokens de acceso personal (claves de larga duración para clientes sin OAuth) y un playground interactivo donde puedes ejecutar cada herramienta MCP contra tu propia cuenta, además de un system prompt recomendado para un comportamiento del agente consciente de GTD.
Solución de problemas
"No tools available" o cero acciones tras conectar. Lo más probable es que el token de acceso haya caducado y el cliente no lo haya renovado correctamente. Desconecta desde el panel y vuelve a conectar desde el cliente.
Las acciones de crear o actualizar fallan con "requires a Pro subscription".
update_tasks requiere Nirvana Pro. create_tasks funciona en el plan gratuito.
ChatGPT muestra tareas pero no las crea ni las actualiza. ChatGPT pide confirmación antes de cada acción de escritura — revisa la conversación por si hay una aprobación pendiente. En los espacios de trabajo Business, Enterprise y Edu, un administrador también puede haber restringido las acciones de escritura o el propio conector.
El conector funcionaba ayer y hoy no. Desconecta y vuelve a conectar desde el panel. Los tokens de actualización de OAuth a veces se pierden tras largos periodos de inactividad, y la solución más limpia es un nuevo handshake.