Beta

Las funciones de IA están en fase beta y disponibles para miembros de acceso anticipado. Unirse a la lista de espera →

Conectar Nirvana a clientes de IA externos mediante MCP

Nirvana tiene un servidor nativo de Model Context Protocol (MCP). Conéctalo a Claude Desktop, Claude.ai, Cursor, ChatGPT o cualquier otro cliente de IA compatible con MCP para dar a ese cliente acceso completo de lectura y escritura a tus tareas y proyectos — 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. La integración MCP es para clientes de IA externos que utilizas con tu propia cuenta.

A qué da acceso la conexión MCP al cliente de IA

Una vez conectado, el cliente de IA puede:

  • Leer tus tareas — por estado (Siguientes, En espera, Programadas, etc.), proyecto, etiqueta o rango de fechas
  • Crear tareas — con nombre, notas, fecha límite, estado y etiquetas
  • Actualizar tareas — cambiar nombre, notas, fecha límite, estado o etiquetas
  • Leer tus etiquetas — ver todos tus contextos, áreas y contactos
  • Leer recuentos de tareas — totales por estado

El cliente solo puede acceder a tus propios datos. No puede acceder a la cuenta de ningún otro usuario.

Opción A — Claude Desktop, Claude Code o Cursor (Token de acceso personal)

Estos clientes de IA locales usan un Token de acceso personal (PAT) para la autenticación.

Paso 1: Generar un token

  1. Ve a mcp.nirvanahq.com/tokens e inicia sesión con tus credenciales de Nirvana.
  2. Haz clic en Nuevo token, ponle un nombre (por ejemplo, "Claude Desktop") y copia el token.

Mantén este token en privado. Cualquiera que tenga el token puede leer y modificar tus tareas. No puede recuperarse si se pierde — tendrás que generar uno nuevo.

Paso 2: Añadir Nirvana a Claude Desktop

  1. Abre Claude Desktop y ve a Configuración → Desarrollador → Editar configuración (o localiza claude_desktop_config.json en tu carpeta de configuración).
  2. Añade lo siguiente bajo mcpServers:
{
  "mcpServers": {
    "nirvana": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.nirvanahq.com/mcp"],
      "env": {
        "AUTHORIZATION": "Bearer YOUR_PAT_TOKEN_HERE"
      }
    }
  }
}
  1. Sustituye YOUR_PAT_TOKEN_HERE por el token que generaste.
  2. Reinicia Claude Desktop.

Nirvana aparecerá ahora como una herramienta conectada. Prueba preguntando: "¿Qué hay en mi lista de Siguientes de Nirvana?"

Opción B — Claude.ai o ChatGPT (OAuth)

Estos clientes basados en web usan OAuth para la autenticación — no hay que gestionar tokens manualmente.

  1. En tu cliente de IA, busca Añadir herramientas, Integraciones o Servidores MCP (el nombre varía según el cliente).
  2. Introduce la URL del servidor MCP de Nirvana: https://mcp.nirvanahq.com/mcp
  3. Cuando se te pida, inicia sesión con tus credenciales de Nirvana y autoriza el acceso.

El cliente recibe un token de acceso de tiempo limitado que se renueva automáticamente. Puedes revocar el acceso en cualquier momento desde la página de tokens.

Verificar la conexión

Una vez conectado, prueba:

  • "¿Qué hay en mi Bandeja de entrada de Nirvana?"
  • "¿Cuántas tareas tengo en Siguientes?"
  • "Añade 'probar la conexión MCP' a mi Bandeja de entrada de Nirvana."

Gestionar y revocar el acceso

Visita mcp.nirvanahq.com/tokens para:

  • Ver todos los tokens activos y las sesiones OAuth
  • Revocar el acceso a cualquier cliente en cualquier momento

Si un token queda comprometido, revócalo inmediatamente y genera uno nuevo.