Die MCP-Server-Integration macht deine Flyo-Inhalte für KI-Assistenten zugänglich. Jede MCP-Integration ist ein eigener Server, mit dem sich Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT, Cursor oder VS Code verbinden. Der Assistent arbeitet dabei immer im Namen der angemeldeten Person: Er sieht nur, was diese Person auch in Flyo sieht, und nur in den Content Pools und Integrationen, die der MCP-Integration zugewiesen sind.
Beta
Der KI-Assistent liest Einträge, Entitäten, Dateien, Statistiken, Integrationen und Nitro Sites. Auf der Stufe Bearbeiten erstellt und ändert er Einträge, lädt Dateien hoch, plant Content Pools und legt Social Media Entwürfe an.
Was der KI-Assistent sieht
- Content Pools: Die zugewiesenen Content Pools bestimmen, welche Einträge lesbar sind. Ohne Pool liest der Assistent keine Einträge, freigegebene Integrationen bleiben lesbar.
- Freigegebene Integrationen und Nitro Sites: Du wählst, welche Integrationen der Assistent kennt. Bei einer Nitro CMS Site sieht er deren Seiten, Struktur und den Stand der Veröffentlichung, bei einer API SDK- oder Social SDK-Integration die Adressen und das OpenAPI-Dokument. Andere Integrationstypen bringen dem Assistenten in dieser Version nichts und stehen nicht zur Auswahl. Jede Site wird einzeln freigegeben.
- Statistiken: Mit dem Schalter «Statistiken lesen» sieht der Assistent Impressionen und Top-Inhalte, aber nur für Personen mit dem Recht Statistik.
- Rechte der Person: Jede Person sieht über den Assistenten höchstens, was sie in Flyo sieht. Ein Mitglied ohne Recht auf einen Content Pool sieht dessen Einträge auch im Assistenten nicht.
Einrichten
- Klicke auf den grünen «Hinzufügen»-Button (unten rechts immer sichtbar), wähle Integration und im Bereich KI-Assistent die Integration MCP Server.
- Weise die Content Pools zu, deren Einträge der Assistent lesen darf: alles, was in diesen Pools liegt, in jeder Entität. Der Assistent kennt nur die Entitäten, die in diesen Pools vorkommen oder in denen er schreiben darf; die übrigen Entitäten der Organisation sieht er nicht. Der Schritt «Zugriff» zeigt die zugewiesenen Pools, unter «Content Pools zuweisen» änderst du sie jederzeit.
- Wähle im Schritt Zugriff die Stufe (Lesen oder Bearbeiten), die freigegebenen Integrationen und Nitro Sites und entscheide, ob der Assistent Statistiken lesen darf. Auf der Stufe Bearbeiten wählst du ausserdem, in welchen Entitäten der Assistent Einträge erstellen und ändern darf, ob er Online-Einträge direkt speichern und den Status ändern darf, und bei jedem kuratierten Content Pool, was er mit dem Pool darf: Einträge hinzufügen (sofort in den Pool), entfernen (sofort aus dem Pool) und terminieren, also beides auf ein Datum legen, an einem Tag hinein und an einem Tag wieder heraus, samt Verschieben und Streichen im Fahrplan. Terminieren ersetzt die beiden anderen nicht: ein terminiertes Hinzufügen braucht Hinzufügen, ein terminiertes Entfernen braucht Entfernen. Pools mit Regeln füllen sich selbst, da gibt es nichts zu erlauben. Unter Social Media wählst du die Profile, für die der Assistent Entwürfe anlegen darf; ohne gewähltes Profil legt er keine an.
- Speichern. Im Schritt Verbinden findest du die Adresse des MCP Servers und die Anleitung für jeden KI-Assistenten.
Mehrere Server pro Organisation
Du kannst mehrere MCP-Integrationen anlegen, zum Beispiel eine für die Redaktion mit allen Content Pools und eine für eine Agentur mit einer einzelnen Nitro Site. Jede hat ihre eigene Adresse und ihre eigene Verbindung.
Verbinden
Jede Person verbindet sich mit ihrem eigenen Flyo Konto und bestätigt den Zugriff. Die Verbindung erscheint danach unter Konto → Verbundene Apps und lässt sich dort jederzeit trennen.
Im KI-Assistenten heisst die Verbindung «Flyo · Name der Organisation». So ist in jedem Gespräch klar, in welcher Organisation gearbeitet wird, auch wenn eine Person mehrere Flyo-Verbindungen hat.
| KI-Assistent | So geht es |
|---|---|
| claude.ai | Einstellungen → Connectors → «Add custom connector», Name und Adresse eingeben und speichern. Beim Connector auf «Connect» klicken, mit dem Flyo Konto anmelden und den Zugriff erlauben. Im Chat unter dem Plus den Connector aktivieren. |
| Claude Desktop | Einstellungen → Connectors → «Add custom connector», Name und Adresse eingeben. «Connect», mit dem Flyo Konto anmelden und den Zugriff erlauben. |
| Claude Code | Den Befehl aus dem Schritt «Verbinden» im Terminal ausführen (claude mcp add --transport http …) oder die Datei .mcp.json im Projekt anlegen. Die Anmeldung mit /mcp starten. |
| ChatGPT | Einstellungen → Connectors (Entwicklermodus) → «Create», Name und Adresse eingeben, OAuth als Authentifizierung wählen. Mit dem Flyo Konto anmelden und den Zugriff erlauben. |
| Cursor | Die Datei .cursor/mcp.json aus dem Schritt «Verbinden» im Projekt anlegen. In den MCP Einstellungen beim Server auf «Login» klicken. |
| VS Code | Die Datei .vscode/mcp.json im Projekt anlegen und den Server in der MCP Ansicht starten. |
Claude Team und Enterprise
Ein Owner fügt den Connector einmal für die ganze Organisation hinzu, jedes Mitglied meldet sich danach mit dem eigenen Flyo Konto an.
Was der Assistent kann
Der Assistent ruft zu Beginn eines Gesprächs den Kontext ab (Organisation, Content Pools, Entitäten, Sprachen) und arbeitet dann mit diesen Werkzeugen:
| Werkzeug | Zweck |
|---|---|
get_context | Organisation, Content Pools, Entitäten, Sprachen, Zugriff und freigegebene Integrationen |
get_entity | Die Felder einer Entität und ihr JSON Schema |
search_entries, list_pool_entries | Einträge suchen oder einen Content Pool in seiner Reihenfolge auflisten |
get_entry, get_entry_activity | Einen Eintrag vollständig lesen, mit Status, Pools, Links und Verlauf |
search_files, get_file | Dateien und Bilder der Organisation finden und lesen |
list_integrations, get_integration | Die freigegebenen Integrationen mit ihren Adressen |
nitro_list_sites, nitro_list_pages, nitro_get_structure, nitro_get_page, nitro_get_publish_diff | Nitro CMS Sites: Seiten, Struktur, eine Seite, unveröffentlichte Änderungen |
get_entry_stats, get_top_entries, get_stats_overview | Statistiken, nur mit dem Schalter und dem Recht Statistik |
Schreiben (Stufe Bearbeiten)
| Werkzeug | Zweck |
|---|---|
create_entry | Einen neuen Eintrag anlegen. Er startet offline und ist für die Überprüfung markiert, der Assistent schaltet nichts selbst online. |
update_entry | Einzelne Felder eines Eintrags ändern. Bei einem Online-Eintrag entsteht ein Änderungsvorschlag, den eine Person in Flyo prüft, ausser die Integration erlaubt das direkte Speichern. Ein Offline-Eintrag wird direkt geändert. |
upload_file | Eine Datei von einer öffentlichen Adresse hochladen, mit Caption und Copyright. Die Datei durchläuft dieselben Prüfungen wie jeder Upload. |
set_entry_status | Einen Eintrag online oder offline schalten oder terminieren, nur mit dem Schalter «Status ändern» und nur, wenn die Person das Recht dazu hat. |
update_pool_entries | Einen kuratierten Content Pool planen: Einträge sofort oder zu einem Datum hinzufügen, sofort oder zu einem Datum entfernen, einen Eintrag im Fahrplan verschieben oder streichen. Nur die Aktionen, die du beim Pool erlaubt hast (Hinzufügen, Entfernen, Terminieren), und nur für Personen, die den Pool auch in Flyo bearbeiten dürfen. list_pool_entries zeigt neben den Einträgen den Fahrplan. |
list_social_profiles, create_social_draft | Die freigegebenen Social Media Profile, mit denen die Person posten darf, samt Netzwerken und Textlimiten; und ein Social Media Post als Entwurf: gleicher Text und gleiche Dateien für die gewählten Netzwerke eines Profils, auf Wunsch mit Datum. Der Assistent veröffentlicht nie; eine Person prüft den Entwurf unter Social Media und gibt ihn frei. Nur für die unter Social Media gewählten Profile und nur mit dem Recht Social Media. |
Für jedes Schreiben gilt: nur in den gewählten Entitäten, nie in extern gepflegten (Read-only) Entitäten, und nur im Rahmen der Rechte der angemeldeten Person. Jede Änderung erscheint in der Aktivität des Eintrags mit dem Vermerk «via KI-Assistent».
Dazu kommen Ressourcen, die du in Claude direkt an ein Gespräch anhängen kannst, zum Beispiel flyo://entries/123 für einen Eintrag als Dokument, flyo://entities/event für das Schema einer Entität oder flyo://files/45 für ein Bild. In claude.ai und Claude Desktop zeigt der Assistent Einträge und Trefferlisten als Karten mit Bild, Status und dem Link in die Konsole. Darf die Verbindung den Status ändern, schaltet ein Button auf der Karte den Eintrag online oder offline; darf sie einen Content Pool befüllen, fügt die Trefferliste ausgewählte Einträge dem Pool hinzu. Jede dieser Aktionen ist ein normaler Werkzeugaufruf mit denselben Prüfungen.
Texte in Einträgen, Dateien und Seiten behandelt der Assistent als Inhalt, nicht als Anweisung. Der Tone of Voice deiner Organisation steht ihm als Stilvorgabe für neue Texte zur Verfügung.
Was passiert, wenn du die Berechtigungen änderst
Jede Person hat beim Verbinden genau dem zugestimmt, was die Integration damals erlaubt hat: der Stufe und den Schaltern. Änderst du eine Integration, die bereits verbundene Apps hat, gilt:
| Änderung | Verbundene Apps | Was die Person erlebt |
|---|---|---|
| Stufe nach oben (Lesen zu Bearbeiten) | werden getrennt | Beim nächsten Gespräch fragt die App neu nach dem Zugriff. Die Person sieht die neuen Berechtigungen auf der Bestätigungsseite und ist danach wieder verbunden. |
| Ein Schalter wird eingeschaltet (Statistiken, Direkt speichern, Online schalten) | werden getrennt | wie oben |
| Stufe nach unten (Bearbeiten zu Lesen) | bleiben | nichts; die weggefallenen Werkzeuge stehen dem Assistenten ab sofort nicht mehr zur Verfügung |
| Ein Schalter wird ausgeschaltet | bleiben | nichts; die Einschränkung gilt ab sofort |
| Content Pools, Entitäten, Pool-Aktionen, Social Media Profile oder freigegebene Integrationen geändert | bleiben | nichts; der neue Umfang gilt ab sofort |
Kurz: Mehr dürfen heisst neu zustimmen, weniger dürfen gilt sofort. Die Listen (welche Pools, Entitäten, Profile und Integrationen) sind der Umfang innerhalb der zugestimmten Stufe und lösen keine neue Zustimmung aus, auch wenn sie grösser werden.
Das Formular warnt vor dem Speichern, wenn eine Änderung die Verbindungen trennt und wie viele Apps betroffen sind. Nach dem Speichern steht im Änderungsprotokoll der Organisation für jede getrennte App ein Eintrag mit dem Grund. Die betroffenen Personen erhalten keine Nachricht; sie merken es daran, dass ihre App beim nächsten Mal erneut nach dem Zugriff fragt.
Zugriff und Sicherheit
- Die Anmeldung läuft über das Flyo Konto (OAuth), nie über einen geteilten Schlüssel. Jede Verbindung gehört einer Person und endet, wenn die Person die Organisation verlässt, die Integration deaktiviert oder gelöscht wird, oder wenn die Berechtigungen der Integration erweitert werden. Dann bestätigt die Person den Zugriff erneut.
- Unter Konto → Verbundene Apps sieht jede Person ihre Verbindungen und trennt sie bei Bedarf. Owner und Manager sehen in der Integration zusätzlich alle verbundenen Apps der Mitglieder und können sie trennen.
- Jeder Aufruf eines Werkzeugs und jedes gelesene Dokument zählt als ein Request der Integration, wie bei einer API SDK-Integration. Die Zahlen erscheinen in der Statistik der Integration und in der Nutzungsübersicht.
- Der Assistent erhält nie einen Zugriffsschlüssel einer anderen Integration und sieht keine Zugangsdaten.
Für Entwickler
Die Adresse des Servers lautet https://api.flyo.cloud/mcp/<kennung>; die Kennung ist die der Integration. Der Server spricht das Model Context Protocol in den Versionen 2026-07-28 und 2025-11-25 (und älter), zustandslos und ohne Sessions, mit JSON-Antworten. Die Autorisierung folgt OAuth 2.1 mit PKCE: Der Server verweist mit WWW-Authenticate auf sein Metadaten-Dokument unter /.well-known/oauth-protected-resource/mcp/<kennung>, die Autorisierung übernimmt auth.flyo.cloud (Dynamic Client Registration und Client ID Metadata Documents). Eigene MCP-Clients verbinden sich damit ohne weitere Konfiguration.