Connecter Nirvana à des clients IA externes via MCP
Nirvana embarque un serveur Model Context Protocol (MCP) natif. Connectez-le à un client IA externe — Claude, ChatGPT, Cursor, VS Code, Claude Code, Gemini CLI ou toute application compatible MCP — et ce client pourra lire et écrire vos tâches et projets directement, sans que l'application Nirvana soit ouverte.
Ceci est distinct de l'assistant IA intégré de Nirvana, qui vit dans l'application Nirvana. MCP sert à connecter des clients IA externes à votre compte.
À quoi le client IA peut accéder
Une fois connecté, le client peut :
- Lire vos tâches — par état GTD (Boîte d'entrée, Suivantes, En attente, Planifiées, Un jour, Plus tard, Focus), par projet, par étiquette ou par plage de dates
- Lire les compteurs de tâches — totaux par liste GTD
- Lire vos étiquettes — contextes et domaines avec leurs compteurs d'utilisation
- Créer des tâches et des projets — avec nom, notes, état, étiquettes, date d'échéance, date de début planifiée, énergie et estimation de durée
- Mettre à jour des tâches (nécessite Nirvana Pro) — modifier n'importe quel champ, terminer, mettre en favori, déplacer entre les listes ou envoyer à la corbeille
Le client ne peut accéder qu'à vos données. Il ne voit jamais le compte d'un autre utilisateur, ni votre mot de passe Nirvana.
Comment se connecter
Les guides de configuration de tous les clients pris en charge se trouvent sur nirvanahq.com/mcp — sans connexion requise. Choisissez-y votre application et suivez ses étapes. La connexion elle-même se fait dans l'application IA : elle ouvre l'écran de connexion de Nirvana, vous approuvez l'accès, et l'application apparaît sous Connected Apps dans votre tableau de bord MCP.
| Client | Méthode d'installation |
|---|---|
| Claude (claude.ai) | Un clic sur Open in Claude — ouvre la boîte de dialogue Add custom connector |
| ChatGPT | Un clic sur Open in ChatGPT — mène à Settings → Connectors → Advanced |
| Claude Code | Commande CLI copiable claude mcp add |
| Cursor | Lien direct Add to Cursor en un clic |
| VS Code | Add to VS Code en un clic, serveur prérempli |
| Gemini CLI | Commande CLI copiable gemini mcp add (l'application Gemini elle-même ne prend pas encore en charge les connecteurs) |
| Autres clients | Extrait mcpServers.json copiable (Continue, Zed et tout client qui lit ce format) |
Les guides sur nirvanahq.com/mcp sont la source de vérité pour les étapes d'installation — ils restent à jour à mesure que les connecteurs évoluent. L'URL du serveur MCP de Nirvana est toujours https://mcp.nirvanahq.com/mcp.
Exigences de forfait
Côté Nirvana : les comptes gratuits ont un accès complet en lecture, plus la création de tâches et de projets. La mise à jour de tâches existantes (renommer, ré-étiqueter, terminer, mettre en favori, déplacer entre les listes) nécessite Nirvana Pro.
Côté client : la plupart des clients MCP (Claude, Cursor, Claude Code, VS Code, Gemini CLI) fonctionnent avec leurs offres gratuites ou payantes. ChatGPT nécessite un forfait payant — le Developer Mode est disponible sur les comptes Plus, Pro, Business, Enterprise et Edu, avec un accès complet en lecture et en écriture (ChatGPT vous demande de confirmer chaque action d'écriture ; à partir de Business, un administrateur d'espace de travail peut le restreindre). Les forfaits Free et Team n'ont pas de Developer Mode pour l'instant, et le flux est réservé au web — pas encore de prise en charge MCP dans l'application mobile ChatGPT.
Modèle de sécurité
Chaque client pris en charge s'authentifie via l'écran de connexion de Nirvana et reçoit un jeton d'accès de courte durée plus un jeton de rafraîchissement — aucun mot de passe ni secret de longue durée n'est jamais collé dans le client IA.
Toutes les requêtes sont limitées à votre seul compte Nirvana. Le serveur MCP ne peut ni lire ni écrire les données de quelqu'un d'autre.
Gérer et révoquer l'accès
Le tableau de bord MCP liste sous Connected Apps chaque application connectée à votre compte. Déconnectez-en une à tout moment — son accès prend fin immédiatement.
Si vous soupçonnez qu'une session est compromise, déconnectez-la depuis le tableau de bord puis reconnectez le client concerné.
Pour les développeurs
Vous construisez votre propre agent ou script ? mcp.nirvanahq.com/developers propose des jetons d'accès personnels (clés de longue durée pour les clients sans OAuth) et un playground interactif où vous pouvez exécuter chaque outil MCP sur votre propre compte, ainsi qu'un system prompt recommandé pour un comportement d'agent adapté à GTD.
Dépannage
« No tools available » ou zéro action après la connexion. Le jeton d'accès a probablement expiré et le client ne l'a pas renouvelé proprement. Déconnectez depuis le tableau de bord, puis reconnectez depuis le client.
Les actions de création ou de mise à jour échouent avec « requires a Pro subscription ».
update_tasks nécessite Nirvana Pro. create_tasks fonctionne avec le compte gratuit.
ChatGPT affiche les tâches mais ne les crée ni ne les met à jour. ChatGPT demande une confirmation avant chaque action d'écriture — vérifiez la conversation pour une approbation en attente. Dans les espaces de travail Business, Enterprise et Edu, un administrateur peut aussi avoir restreint les actions d'écriture ou le connecteur lui-même.
Le connecteur fonctionnait hier, plus aujourd'hui. Déconnectez puis reconnectez depuis le tableau de bord. Les jetons de rafraîchissement OAuth se perdent parfois après de longues périodes d'inactivité ; la solution la plus propre est une nouvelle poignée de main.