# MCP: KI-Assistenten

Verbinde Claude, ChatGPT und andere KI-Assistenten über das Model Context Protocol (MCP) mit deinem Flowplan. Sie suchen, lesen und schreiben mit genau deinen Rechten und nicht mehr.

Neben der optionalen [eingebauten KI](/ai) kannst du über MCP den Assistenten anbinden, den *du* wählst. Er arbeitet mit deinen Seiten, Datenbanken und Aufgaben. Er sieht nur, was du in Flowplan sehen kannst.

## Einrichten

1. Lege unter **Einstellungen → API & KI-Assistenten** ein [persönliches API-Token](/api-and-webhooks) für den Assistenten an. Wähle **Nur lesen**, wenn der Assistent nur suchen und lesen soll. Wähle **Lesen und schreiben**, wenn er auch Seiten und Datensätze anlegen soll.
2. Kopiere die Adresse unter **KI-Assistenten (MCP)**. Sie besteht aus deiner Flowplan-Adresse und `/api/mcp`, zum Beispiel `https://flowplan.example.com/api/mcp`.
3. Trage beides in deinen Client ein (Beispiele unten). Die Einstellungsseite zeigt für jeden Client eine fertige Konfiguration und setzt ein gerade erstelltes Token gleich ein.

Nimm für jeden Assistenten ein eigenes Token. So siehst du, wann welcher zuletzt zugegriffen hat, und kannst einen widerrufen, ohne die anderen zu treffen.

### Claude Code

```bash
claude mcp add --transport http flowplan https://flowplan.example.com/api/mcp \
  --header "Authorization: Bearer fp_…"
```

Mit `--scope user` steht die Verbindung in all deinen Projekten bereit. In Claude Code zeigt `/mcp` die Verbindung und ihre Werkzeuge.

### Claude Desktop

Claude Desktop verbindet sich mit entfernten MCP-Servern, die ein Token verwenden, über die kleine Brücke `mcp-remote`, die Node.js benötigt. Öffne **Einstellungen → Entwickler → Konfiguration bearbeiten**, trage Folgendes in `claude_desktop_config.json` ein und starte Claude neu:

```json
{
  "mcpServers": {
    "flowplan": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://flowplan.example.com/api/mcp", "--header", "Authorization:${FLOWPLAN_AUTH}"],
      "env": { "FLOWPLAN_AUTH": "Bearer fp_…" }
    }
  }
}
```

Das Token steht in `env` und nicht in `args`: So taucht es nicht in der Prozessliste auf.

### ChatGPT

In ChatGPT gibt es eigene MCP-Konnektoren im **Entwicklermodus**, je nach Tarif und Workspace-Einstellungen. Lege unter **Einstellungen → Apps & Konnektoren** einen neuen Konnektor mit der Adresse `https://flowplan.example.com/api/mcp` an. Bietet ChatGPT eine Anmeldung per Token oder API-Schlüssel an, trage dort `fp_…` ein.

Bietet deine ChatGPT-Version nur OAuth oder „Keine Authentifizierung“ an, kann sich ChatGPT noch nicht mit Flowplan verbinden. Flowplan meldet derzeit nur mit persönlichen Tokens an (siehe [Was unterstützt wird](#was-unterstuetzt-wird)). Schreibe das Token nie als Umweg in die Adresse: Adressen landen in Protokollen.

### Cursor, VS Code, Windsurf und andere

Clients, die Streamable HTTP sprechen und eigene Kopfzeilen erlauben, nutzen diese Konfiguration (die genaue Datei hängt vom Client ab, z. B. `.cursor/mcp.json` oder `.vscode/mcp.json`):

```json
{
  "mcpServers": {
    "flowplan": {
      "type": "http",
      "url": "https://flowplan.example.com/api/mcp",
      "headers": { "Authorization": "Bearer fp_…" }
    }
  }
}
```

## Werkzeuge

| Werkzeug | Was es tut | Token |
| --- | --- | --- |
| `list_workspaces` | Deine Arbeitsbereiche mit deiner Rolle und den Bereichen, die du siehst | Lesen |
| `list_pages` | Seiten eines Arbeitsbereichs, optional in einem Bereich oder unter einer Seite | Lesen |
| `search` | Volltextsuche über Seiten, Datensätze, Kommentare und Dateiinhalte | Lesen |
| `read_page` | Eine Seite als Markdown; Datenbanken mit ihren Datensätzen | Lesen |
| `query_database` | Datensätze mit Eigenschaften nach Namen, Eigenschaftsdefinitionen, Ansichten; Textfilter, eine gespeicherte Ansicht, Blättern | Lesen |
| `get_record` | Ein Datensatz mit allen Eigenschaften und seinem Datensatzdokument | Lesen |
| `my_tasks` | Deine Aufgaben aus Dokumenten und Datensätzen, mit Fälligkeit | Lesen |
| `create_page` | Neues Dokument, neue Datenbank oder neues Whiteboard; Dokumente können mit Markdown-Inhalt beginnen | Schreiben |
| `append_to_page` | Hängt Markdown ans Ende eines Dokuments an | Schreiben |
| `create_record` | Neuer Datensatz; Eigenschaften nach Namen | Schreiben |
| `update_record` | Ändert einzelne Eigenschaften eines Datensatzes | Schreiben |

Eigenschaften werden mit ihrem Namen (oder ihrer ID) angegeben. Datumswerte schreibst du als `JJJJ-MM-TT`, Auswahlen mit ihrem Namen, Personen mit E-Mail-Adresse oder Namen und Relationen als Liste von Datensatz-IDs. `update_record` nimmt die `version` aus `get_record` entgegen: Hat jemand den Datensatz inzwischen geändert, wird die Änderung abgelehnt und nicht überschrieben.

Außerdem ist jede Seite als **Ressource** `flowplan://page/<ID>` abrufbar (deine Favoriten sind aufgelistet). Es gibt zwei **Prompts**: *Seite zusammenfassen* und *Meinen Tag planen*.

## Rechte

- Jeder Aufruf handelt als die Person, der das Token gehört, mit **genau ihren Rechten**. Es gelten dieselben Prüfungen wie im Browser: Mitgliedschaft im Arbeitsbereich und Gastzugang, private Bereiche, Seiten- und Gruppenrechte, private Datensätze und mit PIN gesperrte Journale.
- **Lese-Tokens** bieten nur Lese-Werkzeuge an. Ein Schreibaufruf mit einem Lese-Token wird abgelehnt.
- **Schreib-Werkzeuge** führen dieselben Aktionen aus wie die Oberfläche. Automatische Versionen, Erwähnungen und Aufgaben-Benachrichtigungen, Follower, das Aktivitätsprotokoll und [Webhooks](/api-and-webhooks#webhooks) funktionieren also wie gewohnt. Gesperrte Seiten bleiben gesperrt.
- Tokens haben nie Administratorrechte und können keine Tokens anlegen oder widerrufen.
- Die öffentliche Demo hat keinen MCP-Zugang: Demo-Konten können keine Tokens anlegen, und `/api/mcp` nimmt keine Browser-Sitzungen an.

## Sicherheitshinweise

- Behandle das Token wie ein Passwort. Wer es hat, kann alles lesen (und mit einem Schreib-Token ändern), was du kannst. Widerrufe ein Token unter **Einstellungen → API & KI-Assistenten**, wenn du es nicht mehr brauchst oder es in falsche Hände geraten sein könnte; die Verbindung endet sofort.
- KI-Assistenten lassen sich durch Inhalte, die sie lesen, in die Irre führen (Prompt Injection), etwa durch Text auf einer mit dir geteilten Seite. Gib einem Assistenten ein **Lese-Token**, wenn er nicht schreiben muss. Nutze bei einem Schreib-Token die Bestätigungsabfragen des Clients für Werkzeugaufrufe.
- Antworten können alles enthalten, was du in Flowplan lesen kannst. Diese Inhalte gehen an den Anbieter deines Assistenten, prüfe also vorher dessen Datenschutzbedingungen.
- `/api/mcp` nimmt nur Tokens an, nicht das Anmelde-Cookie. Eine fremde Website kann deine Browser-Sitzung deshalb nicht benutzen. Anfragen mit fremdem `Origin` werden abgelehnt.
- Grenzen: 120 Anfragen pro Minute und Person, 2 MB pro Anfrage, und Antworten werden nach 200.000 Zeichen gekürzt. Für Schreib-Werkzeuge gelten dieselben Größengrenzen wie in der Oberfläche.

## Was unterstützt wird

- Transport: **Streamable HTTP** (`POST /api/mcp`, JSON-Antworten, ohne Sitzung). Protokollversionen 2025-06-18, 2025-03-26 und 2024-11-05.
- Anmeldung: persönliche API-Tokens als `Authorization: Bearer fp_…`. Eine Anmeldung per **OAuth** (für Clients, die nur OAuth können) gibt es noch nicht.
- Nicht enthalten: Inhalte löschen, Verwaltung, Dateien und Uploads, Whiteboard-Inhalte.

## Beispiele

- „Such in Flowplan nach dem Angebot für Müller und fasse die offenen Punkte zusammen.“
- „Lies die Seite *Teammeeting* und ergänze einen Abschnitt *Entscheidungen* mit den Ergebnissen von heute.“
- „Zeig meine überfälligen Aufgaben und mach mir einen Plan für heute.“
- „Leg in der Datenbank *Bugs* einen Eintrag an: Titel *Login auf dem iPad hängt*, Status *Offen*, zugewiesen an anna@example.com.“