# MCP-Server

Der Planer spricht das Model Context Protocol. Damit kann ein Sprachmodell
Aufgaben suchen, anlegen, abhaken und einplanen — mit denselben Tokens und
denselben Rechten wie die [Schnittstelle](API.md).

Adresse: `<APP_URL>/api/mcp`

## Einrichten

1. In der Anwendung unter **API** einen Token anlegen. Gib ihm nur, was das
   Modell wirklich braucht.
2. Den Client auf die Adresse zeigen lassen, mit dem Token als Bearer.

Für Claude Code:

```bash
claude mcp add planer --transport http https://planer.example.de/api/mcp \
  --header "Authorization: Bearer planer_…"
```

Für Clients, die nur stdio können, dazwischen `mcp-remote` setzen:

```json
{
  "mcpServers": {
    "planer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://planer.example.de/api/mcp",
        "--header",
        "Authorization: Bearer planer_…"
      ]
    }
  }
}
```

## Werkzeuge

Welche ein Modell zu sehen bekommt, hängt am Token. Was nicht erlaubt ist,
taucht gar nicht erst in der Liste auf — ein Modell soll nicht gegen eine Tür
laufen, die für es verschlossen ist.

| Werkzeug             | Recht       | Was es tut                                      |
| -------------------- | ----------- | ----------------------------------------------- |
| `aufgaben_suchen`    | `lesen`     | Aufgaben auflisten, optional gefiltert          |
| `woche_ansehen`      | `lesen`     | Zeitblöcke einer Woche mit Summe                |
| `kalender_auflisten` | `lesen`     | Verbundene Kalender samt Kennung                |
| `aufgabe_anlegen`    | `erfassen`  | Neue Aufgabe in der Inbox                       |
| `aufgabe_abhaken`    | `schreiben` | Aufgabe auf erledigt setzen                     |
| `zeitblock_anlegen`  | `schreiben` | Aufgabe einplanen und in den Kalender schreiben |

Zum Einplanen braucht es die Kennung eines Kalenderkontos — daher erst
`kalender_auflisten`, dann `zeitblock_anlegen`.

`zeitblock_anlegen` geht durch dieselbe Stelle wie das Ziehen in der
Wochenansicht: Rasterprüfung, Kalenderschreibweg, Schleifenschutz, Protokoll.
Ein über MCP angelegter Zeitblock verhält sich also genau wie ein von Hand
gezogener.

## Was der Server bewusst **nicht** kann

- **Löschen.** Weder Aufgaben noch Zeitblöcke. Abhaken ja, wegräumen nein.
- **Bereich oder Projekt setzen.** Was hier entsteht, landet in der Inbox.
- **Bereiche, Projekte oder Kalenderkonten anlegen und ändern.**
- **Einstellungen oder Tokens anfassen.**

Ein Modell soll den Alltag erleichtern, nicht die Ordnung umbauen.

## Protokoll

Jede schreibende Nutzung landet im Protokoll — mit dem Vermerk, dass sie über
MCP kam, und mit dem Token. Ein Modell, das Aufgaben anlegt, muss genauso
nachvollziehbar sein wie ein Mensch. Eher noch mehr.

## Ohne Sitzungen

Der Server ist zustandslos: Jede Anfrage steht für sich. Der Planer hat keine
langlaufenden Vorgänge, und eine Sitzungsverwaltung wäre Zustand, den mehrere
Container nicht teilen könnten.