fluos Documentação

Autenticação da API do Fluos

Sessões de navegador para o painel e OAuth para a API de vídeo paga, a CLI e o MCP.

O Fluos tem duas formas de autenticação: sessões de navegador para o produto e OAuth para a API de vídeo paga, a CLI e o MCP.

Sessões do produto

O Fluos nunca armazena uma senha. Os usuários entram com Google, Apple ou um código único por e-mail. Veja Primeiros passos.

As rotas autenticadas do produto (/dashboard e a maioria dos handlers de /api/*) esperam um cookie de sessão do navegador com login. Chamadas não autenticadas recebem:

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

API de vídeo paga e MCP (OAuth)

Agentes de código se conectam a /api/v1/mcp/app e à família /api/v1/videos com um token de acesso OAuth do tipo Bearer. Descoberta:

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

Escopos: profile, email. Hosts de MCP devem usar o client ID OAuth público do Fluos, vZg47Po1X1v3rHtU (sem segredo). Chamadas não autenticadas retornam 401 mais WWW-Authenticate. Planos gratuitos recebem 402 / PLAN_REQUIRED.

A CLI lê o mesmo token de FLUOS_API_TOKEN depois de npx fluos login.

As rotas de vídeo autenticam dentro do handler, para que clientes OAuth consigam concluir a descoberta sem uma sessão de navegador.

Endpoints públicos

Estes não exigem sessão:

  • /openapi.json, /api/v1/openapi.json, /llms.txt, /llms-full.txt, /ai.txt
  • /sitemap.xml, /robots.txt, /feed.xml
  • /docs, /docs/developers, /cli, /mcp, páginas de marketing
  • GET /api/v1/search e GET /api/search
  • GET/POST /api/v1/mcp (somente o MCP de documentação)
  • Negociação de conteúdo nas páginas públicas (Accept: text/markdown ou application/json)

Conectores do espaço de trabalho

As conexões com Figma, Notion, Google Drive, Slack e Linear são autorizadas em Habilidades e Conectores dentro de um espaço de trabalho do Fluos, pela tela de OAuth de cada provedor. Esse fluxo é iniciado pelo usuário, dentro do produto. Veja Conectores.

O MCP de documentação público, em /api/v1/mcp, é uma superfície de descoberta separada e sem autenticação. A criação de vídeos usa o MCP de vídeo pago, em /api/v1/mcp/app. Veja OAuth e acesso.

Nesta página

Sessões do produtoAPI de vídeo paga e MCP (OAuth)Endpoints públicosConectores do espaço de trabalho