Authentification de l’API Fluos

Fluos propose deux modes d’authentification : les sessions de navigateur pour le produit, et OAuth pour l’API vidéo payante, la CLI et le MCP.

Sessions produit

Fluos ne stocke jamais de mot de passe. Les utilisateurs se connectent avec Google, Apple ou un code à usage unique envoyé par e-mail. Voir Premiers pas.

Les routes produit authentifiées (/dashboard et la plupart des gestionnaires /api/*) attendent un cookie de session du navigateur connecté. Les appels non authentifiés reçoivent :

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

API vidéo payante et MCP (OAuth)

Les agents de code se connectent à /api/v1/mcp/app et à la famille /api/v1/videos avec un jeton d’accès OAuth de type Bearer. Découverte :

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

Portées : profile, email. Les hôtes MCP doivent utiliser l’identifiant de client OAuth public de Fluos, vZg47Po1X1v3rHtU (sans secret). Les appels non authentifiés renvoient 401 accompagné de WWW-Authenticate. Les plans Gratuits reçoivent 402 / PLAN_REQUIRED.

La CLI lit le même jeton depuis FLUOS_API_TOKEN après npx fluos login.

Les routes vidéo authentifient dans le gestionnaire, afin que les clients OAuth puissent mener la découverte à son terme sans session de navigateur.

Points d’accès publics

Ceux-ci ne nécessitent pas de 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, pages marketing
• GET /api/v1/search et GET /api/search
• GET/POST /api/v1/mcp (MCP de la documentation uniquement)
• Négociation de contenu sur les pages publiques (Accept: text/markdown ou application/json)

Connecteurs d’espace de travail

Les connexions à Figma, Notion, Google Drive, Slack et Linear sont autorisées depuis Skills et connecteurs dans un espace de travail Fluos, via l’écran OAuth propre à chaque fournisseur. Cette démarche est initiée par l’utilisateur dans le produit. Voir Connecteurs.

Le MCP de la documentation public, à l’adresse /api/v1/mcp, est une surface de découverte distincte et non authentifiée. La création de vidéos passe par le MCP vidéo payant, à l’adresse /api/v1/mcp/app. Voir OAuth et accès.