Erweiterungen

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 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

Lege unter Einstellungen → API & KI-Assistenten ein persönliches API-Token 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.
Kopiere die Adresse unter KI-Assistenten (MCP). Sie besteht aus deiner Flowplan-Adresse und /api/mcp, zum Beispiel https://flowplan.example.com/api/mcp.
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

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:

{
  "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). 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):

{
  "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 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 [email protected].“

Auf GitHub bearbeiten

MCP: KI-Assistenten

#Einrichten

#Claude Code

#Claude Desktop

#ChatGPT

#Cursor, VS Code, Windsurf und andere

#Werkzeuge

#Rechte

#Sicherheitshinweise

#Was unterstützt wird

#Beispiele