Connecter Nirvana à des clients IA externes via MCP

Nirvana dispose d'un serveur Model Context Protocol (MCP) natif. Connectez-le à Claude Desktop, Claude.ai, Cursor, ChatGPT ou tout autre client IA compatible MCP pour donner à ce client un accès complet en lecture/écriture à vos tâches et projets — sans avoir besoin que l'application Nirvana soit ouverte.

Ceci est distinct de l'assistant IA intégré à Nirvana, qui s'exécute dans l'application. L'intégration MCP est destinée aux clients IA externes que vous utilisez avec votre propre compte.

Ce à quoi la connexion MCP donne accès au client IA

Une fois connecté, le client IA peut :

Lire vos tâches — par état (Suivant, En attente, Programmé, etc.), projet, étiquette ou plage de dates
Créer des tâches — avec un nom, des notes, une date d'échéance, un état et des étiquettes
Mettre à jour des tâches — changer le nom, les notes, la date d'échéance, l'état ou les étiquettes
Lire vos étiquettes — voir tous vos contextes, zones et contacts
Lire le nombre de tâches — totaux par état

Le client ne peut accéder qu'à vos propres données. Il ne peut pas accéder au compte d'un autre utilisateur.

Option A — Claude Desktop, Claude Code ou Cursor (Jeton d'accès personnel)

Ces clients IA locaux utilisent un Jeton d'accès personnel (PAT) pour l'authentification.

Étape 1 : Générer un jeton

Allez sur mcp.nirvanahq.com/tokens et connectez-vous avec vos identifiants Nirvana.
Cliquez sur Nouveau jeton, donnez-lui un nom (ex. : « Claude Desktop »), et copiez le jeton.

Gardez ce jeton confidentiel. Toute personne possédant le jeton peut lire et modifier vos tâches. Il ne peut pas être récupéré s'il est perdu — vous devrez en générer un nouveau.

Étape 2 : Ajouter Nirvana à Claude Desktop

Ouvrez Claude Desktop et allez dans Paramètres → Développeur → Modifier la configuration (ou localisez claude_desktop_config.json dans votre dossier de configuration).
Ajoutez ce qui suit sous mcpServers :

{
  "mcpServers": {
    "nirvana": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.nirvanahq.com/mcp"],
      "env": {
        "AUTHORIZATION": "Bearer VOTRE_JETON_PAT_ICI"
      }
    }
  }
}

Remplacez VOTRE_JETON_PAT_ICI par le jeton que vous avez généré.
Redémarrez Claude Desktop.

Nirvana apparaîtra maintenant comme un outil connecté. Essayez de demander : « Qu'est-ce qui est dans ma liste Suivant de Nirvana ? »

Option B — Claude.ai ou ChatGPT (OAuth)

Ces clients web utilisent OAuth pour l'authentification — pas de jetons à gérer manuellement.

Dans votre client IA, cherchez Ajouter des outils, Intégrations ou Serveurs MCP (le libellé varie selon le client).
Saisissez l'URL du serveur MCP de Nirvana : https://mcp.nirvanahq.com/mcp
Lorsque vous y êtes invité, connectez-vous avec vos identifiants Nirvana et autorisez l'accès.

Le client reçoit un jeton d'accès à durée limitée qui se renouvelle automatiquement. Vous pouvez révoquer l'accès à tout moment depuis la page des jetons.

Vérifier la connexion

Une fois connecté, essayez :

« Qu'est-ce qui est dans ma Boîte de réception Nirvana ? »
« Combien de tâches ai-je dans Suivant ? »
« Ajoute "tester la connexion MCP" à ma Boîte de réception Nirvana." »

Gérer et révoquer l'accès

Visitez mcp.nirvanahq.com/tokens pour :

Afficher tous les jetons actifs et les sessions OAuth
Révoquer l'accès pour n'importe quel client à tout moment

Si un jeton est compromis, révoquez-le immédiatement et générez-en un nouveau.