Nirvana mit externen KI-Clients über MCP verbinden

Nirvana verfügt über einen nativen Model Context Protocol (MCP)-Server. Verbinden Sie ihn mit Claude Desktop, Claude.ai, Cursor, ChatGPT oder einem anderen MCP-kompatiblen KI-Client, um diesem Client vollen Lese-/Schreibzugriff auf Ihre Aufgaben und Projekte zu geben — ohne die Nirvana-App geöffnet haben zu müssen.

Dies ist von Nirvanas eingebautem KI-Assistenten getrennt, der innerhalb der App läuft. Die MCP-Integration ist für externe KI-Clients gedacht, die Sie mit Ihrem eigenen Konto verwenden.

Auf was der MCP-Zugang dem KI-Client Zugriff gewährt

Nach der Verbindung kann der KI-Client:

• Ihre Aufgaben lesen — nach Status (Als Nächstes, Warten auf, Geplant usw.), Projekt, Schlagwort oder Datumsbereich
• Aufgaben erstellen — mit Name, Notizen, Fälligkeitsdatum, Status und Schlagwörtern
• Aufgaben aktualisieren — Name, Notizen, Fälligkeitsdatum, Status oder Schlagwörter ändern
• Ihre Schlagwörter lesen — alle Kontexte, Bereiche und Kontakte einsehen
• Aufgabenzahlen lesen — Gesamtzahlen nach Status

Der Client kann nur auf Ihre eigenen Daten zugreifen. Er kann nicht auf das Konto eines anderen Nutzers zugreifen.

---

Option A — Claude Desktop, Claude Code oder Cursor (Persönliches Zugriffstoken)

Diese lokalen KI-Clients verwenden ein persönliches Zugriffstoken (PAT) zur Authentifizierung.

Schritt 1: Token generieren

1. Gehen Sie zu mcp.nirvanahq.com/tokens und melden Sie sich mit Ihren Nirvana-Zugangsdaten an.
2. Klicken Sie auf Neues Token, geben Sie ihm einen Namen (z. B. „Claude Desktop") und kopieren Sie das Token.

Halten Sie dieses Token vertraulich. Jeder mit dem Token kann Ihre Aufgaben lesen und ändern. Es kann nicht wiederhergestellt werden, wenn es verloren geht — Sie müssen ein neues generieren.

Schritt 2: Nirvana zu Claude Desktop hinzufügen

1. Öffnen Sie Claude Desktop und gehen Sie zu Einstellungen → Entwickler → Konfiguration bearbeiten (oder suchen Sie claude_desktop_config.json in Ihrem Konfigurationsordner).
2. Fügen Sie Folgendes unter mcpServers hinzu:

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

3. Ersetzen Sie YOUR_PAT_TOKEN_HERE durch das Token, das Sie generiert haben.
4. Starten Sie Claude Desktop neu.

Nirvana erscheint nun als verbundenes Tool. Versuchen Sie: „Was steht in meiner Nirvana-Als-Nächstes-Liste?"

---

Option B — Claude.ai oder ChatGPT (OAuth)

Diese webbasierten Clients verwenden OAuth zur Authentifizierung — keine Token müssen manuell verwaltet werden.

1. Suchen Sie in Ihrem KI-Client nach Tools hinzufügen, Integrationen oder MCP-Server (die Bezeichnung variiert je nach Client).
2. Geben Sie die Nirvana-MCP-Server-URL ein: https://mcp.nirvanahq.com/mcp
3. Melden Sie sich bei Aufforderung mit Ihren Nirvana-Zugangsdaten an und autorisieren Sie den Zugang.

Der Client erhält ein zeitlich begrenztes Zugriffstoken, das sich automatisch erneuert. Sie können den Zugang jederzeit von der Token-Seite widerrufen.

---

Verbindung überprüfen

Versuchen Sie nach der Verbindung:

• „Was ist in meinem Nirvana-Posteingang?"
• „Wie viele Aufgaben habe ich in Als Nächstes?"
• „Füge 'MCP-Verbindung testen' zu meinem Nirvana-Posteingang hinzu."

---

Zugang verwalten und widerrufen

Besuchen Sie mcp.nirvanahq.com/tokens, um:

• Alle aktiven Token und OAuth-Sitzungen anzuzeigen
• Den Zugang für jeden Client jederzeit zu widerrufen

Wenn ein Token jemals kompromittiert wird, widerrufen Sie es sofort und generieren Sie ein neues.