fluos Dokumentation

Fluos-API-Authentifizierung

Browser-Sessions für das Dashboard und OAuth für die kostenpflichtige Video-API, die CLI und MCP.

Fluos kennt zwei Arten der Authentifizierung: Browser-Sessions für das Produkt und OAuth für die kostenpflichtige Video-API, die CLI und MCP.

Produkt-Sessions

Fluos speichert nie ein Passwort. Nutzer melden sich mit Google, Apple oder einem einmaligen E-Mail-Code an. Siehe Erste Schritte.

Authentifizierte Produkt-Routen (/dashboard und die meisten /api/*-Handler) erwarten ein Session-Cookie aus dem angemeldeten Browser. Nicht authentifizierte Aufrufe erhalten:

{ "error": "Unauthorized", "code": "unauthorized" }

Kostenpflichtige Video-API und MCP (OAuth)

Coding-Agents verbinden sich mit /api/v1/mcp/app und der /api/v1/videos-Familie über ein OAuth-Zugriffstoken vom Typ Bearer. Discovery:

  • /.well-known/oauth-protected-resource/mcp
  • /.well-known/oauth-authorization-server

Scopes: profile, email. MCP-Hosts finden die Anmeldung über diese Dokumente und registrieren ihren eigenen OAuth-Client, sodass keine Client-ID nötig ist. Hosts, die sich nicht registrieren können, können die öffentliche Client-ID von Fluos verwenden: vZg47Po1X1v3rHtU (ohne Secret). Nicht authentifizierte Aufrufe liefern 401 samt WWW-Authenticate. Kostenlos-Tarife erhalten 402 / PLAN_REQUIRED.

Die CLI liest dasselbe Token nach npx fluos login aus FLUOS_API_TOKEN.

Video-Routen authentifizieren im Handler, damit OAuth-Clients die Discovery ohne Browser-Session abschließen können.

Öffentliche Endpunkte

Diese erfordern keine Session:

  • /openapi.json, /api/v1/openapi.json, /llms.txt, /llms-full.txt, /ai.txt
  • /sitemap.xml, /robots.txt, /feed.xml
  • /docs, /docs/developers, /cli, /mcp, Marketing-Seiten
  • GET /api/v1/search und GET /api/search
  • GET/POST /api/v1/mcp (nur Docs-MCP)
  • Content-Negotiation auf öffentlichen Seiten (Accept: text/markdown oder application/json)

Workspace-Connectors

Verbindungen zu Figma, Notion, Google Drive, Slack und Linear werden auf der Seite Plugins in einem Fluos-Workspace über den jeweiligen OAuth-Bildschirm des Anbieters autorisiert. Dieser Ablauf wird im Produkt von den Nutzern selbst gestartet. Siehe Plugins und Connectors.

Das öffentliche Docs-MCP unter /api/v1/mcp ist eine eigenständige, nicht authentifizierte Discovery-Schnittstelle. Für die Videoerstellung dient das kostenpflichtige Video-MCP unter /api/v1/mcp/app. Siehe OAuth und Zugriff.

Auf dieser Seite

Produkt-SessionsKostenpflichtige Video-API und MCP (OAuth)Öffentliche EndpunkteWorkspace-Connectors