Nirvana über MCP mit externen KI-Clients verbinden
Nirvana bringt einen nativen Model Context Protocol (MCP)-Server mit. Verbinden Sie ihn mit einem externen KI-Client — Claude, ChatGPT, Cursor, VS Code, Claude Code, Gemini CLI oder einer beliebigen MCP-kompatiblen App — und dieser Client kann Ihre Aufgaben und Projekte direkt lesen und schreiben, ohne dass die Nirvana-App laufen muss.
Dies ist unabhängig von Nirvanas integriertem KI-Assistenten, der innerhalb der Nirvana-App lebt. MCP dient dazu, externe KI-Clients mit Ihrem Konto zu verbinden.
Worauf der KI-Client zugreifen kann
Einmal verbunden, kann der Client:
- Ihre Aufgaben lesen — nach GTD-Status (Eingang, Nächste, Warten, Geplant, Irgendwann, Später, Fokus), nach Projekt, nach Tag oder nach Datumsbereich
- Aufgabenzähler lesen — Summen pro GTD-Liste
- Ihre Tags lesen — Kontexte und Bereiche mit Nutzungszählern
- Aufgaben und Projekte erstellen — mit Name, Notizen, Status, Tags, Fälligkeitsdatum, geplantem Startdatum, Energie und Zeitschätzung
- Aufgaben aktualisieren (erfordert Nirvana Pro) — jedes Feld ändern, abschließen, markieren, zwischen Listen verschieben oder in den Papierkorb legen
Der Client kann nur auf Ihre Daten zugreifen. Er sieht weder das Konto anderer Nutzer noch jemals Ihr Nirvana-Passwort.
So verbinden Sie sich
Einrichtungsanleitungen für alle unterstützten Clients finden Sie unter nirvanahq.com/mcp — ohne Anmeldung. Wählen Sie dort Ihre App und folgen Sie den Schritten. Die Verbindung selbst geschieht in der KI-App: Sie öffnet Nirvanas Anmeldebildschirm, Sie genehmigen den Zugriff, und die App erscheint unter Connected Apps in Ihrem MCP-Dashboard.
| Client | Installationsweg |
|---|---|
| Claude (claude.ai) | Ein Klick auf Open in Claude — öffnet den Dialog „Add custom connector“ |
| ChatGPT | Ein Klick auf Open in ChatGPT — führt zu Settings → Connectors → Advanced |
| Claude Code | Kopierbarer CLI-Befehl claude mcp add |
| Cursor | Ein-Klick-Deeplink Add to Cursor |
| VS Code | Ein Klick auf Add to VS Code mit vorausgefülltem Server |
| Gemini CLI | Kopierbarer CLI-Befehl gemini mcp add (die Gemini-App selbst unterstützt noch keine Konnektoren) |
| Andere Clients | Kopierbarer mcpServers.json-Schnipsel (Continue, Zed und jeder Client, der dieses Format liest) |
Die Anleitungen auf nirvanahq.com/mcp sind die verbindliche Quelle für die Installationsschritte — sie bleiben aktuell, während sich die Konnektoren weiterentwickeln. Die URL des Nirvana-MCP-Servers lautet immer https://mcp.nirvanahq.com/mcp.
Plan-Voraussetzungen
Auf Nirvana-Seite: Kostenlose Konten haben vollen Lesezugriff sowie das Erstellen von Aufgaben und Projekten. Das Aktualisieren bestehender Aufgaben (umbenennen, neu taggen, abschließen, markieren, zwischen Listen verschieben) erfordert Nirvana Pro.
Auf Client-Seite: Die meisten MCP-Clients (Claude, Cursor, Claude Code, VS Code, Gemini CLI) funktionieren in ihren kostenlosen oder bezahlten Stufen. ChatGPT erfordert einen bezahlten Plan — der Developer Mode ist auf Plus-, Pro-, Business-, Enterprise- und Edu-Konten verfügbar, mit vollem Lese- und Schreibzugriff (ChatGPT bittet vor jeder Schreibaktion um Bestätigung; ab Business kann ein Workspace-Administrator ihn einschränken). Die Pläne Free und Team haben derzeit keinen Developer Mode, und der Ablauf ist nur im Web verfügbar — in der ChatGPT-Mobil-App gibt es noch keine MCP-Unterstützung.
Sicherheitsmodell
Jeder unterstützte Client authentifiziert sich über Nirvanas Anmeldebildschirm und erhält ein kurzlebiges Zugriffstoken plus ein Refresh-Token — es wird niemals ein Passwort oder ein langlebiges Geheimnis in den KI-Client eingefügt.
Alle Anfragen sind auf Ihr einzelnes Nirvana-Konto beschränkt. Der MCP-Server kann die Daten anderer weder lesen noch schreiben.
Zugriff verwalten und widerrufen
Das MCP-Dashboard listet unter Connected Apps jede mit Ihrem Konto verbundene App auf. Trennen Sie jede davon jederzeit — der Zugriff endet sofort.
Wenn Sie vermuten, dass eine Sitzung kompromittiert ist, trennen Sie sie über das Dashboard und verbinden Sie den betroffenen Client neu.
Für Entwickler
Sie bauen einen eigenen Agenten oder ein Skript? mcp.nirvanahq.com/developers bietet Personal Access Tokens (langlebige Schlüssel für Clients ohne OAuth) und einen interaktiven Playground, in dem Sie jedes MCP-Tool gegen Ihr eigenes Konto ausführen können — plus einen empfohlenen System-Prompt für GTD-bewusstes Agentenverhalten.
Fehlerbehebung
„No tools available“ oder null Aktionen nach dem Verbinden. Höchstwahrscheinlich ist das Zugriffstoken abgelaufen und der Client hat es nicht sauber erneuert. Trennen Sie die Verbindung im Dashboard und verbinden Sie sich dann vom Client aus neu.
Erstellen oder Aktualisieren schlägt fehl mit „requires a Pro subscription“.
update_tasks erfordert Nirvana Pro. create_tasks funktioniert im kostenlosen Plan.
ChatGPT zeigt Aufgaben, erstellt oder aktualisiert sie aber nicht. ChatGPT bittet vor jeder Schreibaktion um Bestätigung — prüfen Sie die Unterhaltung auf eine ausstehende Freigabe. In Business-, Enterprise- und Edu-Workspaces kann außerdem ein Administrator Schreibaktionen oder den Konnektor selbst eingeschränkt haben.
Der Konnektor funktionierte gestern, heute nicht mehr. Trennen und neu verbinden über das Dashboard. OAuth-Refresh-Tokens gehen nach langen Leerlaufphasen manchmal verloren; die sauberste Lösung ist ein frischer Handshake.