# Mit Cursor verbinden

In Cursor bindest du Kalender Sync als Remote-MCP-Server ein. Danach kennt der Agent in Cursor deine Kalender über alle verbundenen Anbieter — Google, Outlook, iCloud, GMX, WEB.DE und mehr.

## 1. Zugang und Schlüssel in Kalender Sync erstellen

Noch kein Konto? Lege es unter [app.kalender-sync.de](https://app.kalender-sync.de/) an (7 Tage Professional gratis, keine Kreditkarte) und [verbinde deine Kalender](https://docs.kalender-sync.de/getting-started/connect-first-calendar/).

Öffne in der App **KI-Assistent → Assistent verbinden** und wähle **Etwas anderes**. Wie bei jedem Zugang wählst du die Kalender einzeln aus und stellst je Kalender die [Detailtiefe](https://docs.kalender-sync.de/ki-assistent/sichtbarkeit/) ein — nicht freigegebene Kalender existieren für Cursor nicht.

Mit **Schlüssel erstellen** bekommst du deinen Zugriffs-Schlüssel (ein Token, beginnt mit `ksa_`). Er wird **nur einmal angezeigt**. Behandle ihn wie ein Passwort: Wer den Schlüssel hat, hat genau den Zugriff, den du diesem Zugang gegeben hast. Füge ihn nie in einen Chat ein.

:::note[Warum ein Schlüssel und kein Anmeldefenster?]
Die Anmeldung per Browser-Fenster (OAuth) bieten wir derzeit nur für Claude und ChatGPT an. Cursor verbindet sich deshalb mit einem Zugriffs-Schlüssel. Für dich ändert das nichts an den Rechten: Du bestimmst weiterhin je Kalender, was sichtbar ist und ob Termine angelegt werden dürfen.
:::

## 2. Kalender Sync in Cursor eintragen

1. Lege den Schlüssel als Umgebungsvariable `KALENDER_SYNC_KEY` in deinem Shell-Profil oder Systemumfeld ab (Cursor liest bei Remote-Servern keine `envFile`). Alternativ trägst du ihn direkt statt `${env:KALENDER_SYNC_KEY}` ein — dann gehört die Datei nicht in ein Git-Repository.
2. Ergänze in `~/.cursor/mcp.json` (für alle Projekte) oder `.cursor/mcp.json` (nur dieses Projekt) den Eintrag. Bestehende Server bleiben erhalten:

```json
{
  "mcpServers": {
    "kalender-sync": {
      "url": "https://app.kalender-sync.de/mcp",
      "headers": {
        "Authorization": "Bearer ${env:KALENDER_SYNC_KEY}"
      }
    }
  }
}
```

3. Cursor neu laden. Unter **Settings → MCP** sollte **kalender-sync** mit seinen Tools erscheinen.

Danach kannst du loslegen, z. B.: *„Welche Kalender sind über Kalender Sync freigegeben?"*, *„Wo habe ich diese Woche zwei Stunden am Stück?"* oder *„Wann ist mein Zahnarzt-Termin?"*

## Wenn etwas nicht klappt

- **401 / „Unauthorized“:** Schlüssel falsch, abgelaufen oder widerrufen. Prüfe den Header: Name exakt `Authorization`, Wert `Bearer ksa_…` (mit Leerzeichen). Im Zweifel einen neuen Schlüssel erstellen.
- **Ein Kalender fehlt:** Er ist für diesen Zugang nicht freigegeben. Ergänze ihn in der App unter **KI-Assistent → Freigabe bearbeiten** — das wirkt sofort, ein neuer Schlüssel ist nicht nötig.

## Zugang widerrufen

In Kalender Sync unter **KI-Assistent** beim Zugang auf **Widerrufen** — sofort wirksam, der Schlüssel ist damit ungültig, egal was in Cursor gespeichert ist. Mehr dazu unter [Zugang widerrufen](https://docs.kalender-sync.de/ki-assistent/#zugang-widerrufen).