Flownato MCP

Flownato MCP

Um servidor remoto e somente leitura do Model Context Protocol para pesquisa de UI mobile. Ele dá a assistentes compatíveis com MCP (Claude, Cursor, Codex, Windsurf e outros) acesso à biblioteca do Flownato de telas reais de apps mobile, fluxos de usuário e padrões de UI, com cada resposta vinculada a evidências publicadas de telas.

• Endpoint: https://agent.flownato.com/mcp (Streamable HTTP)
• Autenticação: código de autorização OAuth 2.1 com PKCE. Seu navegador abre o login do Flownato e uma tela de consentimento somente leitura. Sem necessidade de colar chaves de API.
• Acesso: conectar é gratuito e whoami funciona em qualquer conta. As ferramentas de pesquisa na biblioteca exigem uma assinatura Flownato Premium.
• Site: https://www.flownato.com/mcp

O que ele faz

O Flownato registra apps mobile reais (principalmente apps de consumo indianos como Swiggy, Zepto, MakeMyTrip, BookMyShow, Nykaa, além de IKEA e Wikipedia) e publica telas revisadas, jornadas completas e uma taxonomia de padrões de UI. O servidor MCP permite que um assistente pesquise e compare essas evidências em vez de adivinhar como uma interface se parece.

Perguntas típicas que ele pode responder com citações:

• "Como os apps de supermercado lidam com a etapa de escolha de horário de entrega no checkout?"
• "Mostre-me telas de inserção de número de telefone em apps de reserva."
• "Compare a jornada de integração no Cricbuzz e no FanCode."
• "Quais apps usam uma bottom sheet para seleção de loja?"

Ferramentas

Ferramenta	Finalidade
whoami	Informa a assinatura autenticada e o cliente. Funciona em contas gratuitas.
search_ui_library	Encontra exemplos concretos de jornadas para uma pergunta de pesquisa.
search_ui_screens	Busca em nível de tela com correspondência exata de texto da interface.
analyze_ui_pattern	Mede um padrão de tela, elemento de UI, padrão de fluxo ou ação de fluxo em um escopo opcional de app ou categoria.
explore_ui_patterns	Descobre padrões recorrentes quando você ainda não sabe qual analisar.
compare_ui_flows	Compara o mesmo momento de produto entre dois ou três apps nomeados.
inspect_app_library	Resume a cobertura publicada, padrões, elementos e jornadas de um app.
check_ui_presence	Verificações de presença sim/não com escopo e evidências.
inspect_library_coverage	Inventário paginado do que está publicado.
inspect_ui_resources	Recuperação exata vinculada à versão para objetos resourceRef retornados.
get_screen_image	Retorna uma imagem de tela publicada inline depois que outra ferramenta fornece o ID do asset.

Todas as ferramentas são somente leitura. Os resultados citam os identificadores exatos de jornada e etapa a partir dos quais foram construídos, e as contagens de padrões são descritivas, nunca apresentadas como melhores práticas.

Conectar

Claude Desktop, Claude Code, Cursor e a maioria dos clientes aceitam uma entrada de servidor remoto como esta:

{
  "mcpServers": {
    "flownato": {
      "type": "http",
      "url": "https://agent.flownato.com/mcp"
    }
  }
}

Claude Code:

claude mcp add --transport http flownato https://agent.flownato.com/mcp

No primeiro uso, o cliente abre https://api.flownato.com/oauth/authorize no seu navegador. Faça login com sua conta Flownato e aprove o acesso somente leitura. Os tokens têm vida curta e são renovados silenciosamente até você revogar a permissão.

Documentos de descoberta:

• Metadados do recurso protegido: https://agent.flownato.com/.well-known/oauth-protected-resource/mcp
• Metadados do servidor de autorização: https://api.flownato.com/.well-known/oauth-authorization-server

Acesso e limites

Plano	O que o MCP retorna
Conta gratuita	whoami, além de uma resposta estruturada exigindo Premium das ferramentas da biblioteca antes de qualquer consulta ao catálogo
Premium	Todas as onze ferramentas, com limite padrão de segurança de 500 chamadas de ferramenta por dia UTC

Prompts, argumentos e resultados não são armazenados. As URLs de capturas de tela são assinadas e de curta duração, e o endpoint de imagens revalida a assinatura quando a imagem é buscada.

Privacidade e escopo

O servidor lê apenas o catálogo de produtos publicado: versões revisadas e imutáveis com redação de privacidade aplicada. Ele não tem acesso a dados brutos de rastreamento, saída de modelos ou contas de outros usuários. Ele responde a perguntas de pesquisa de UI e design de produto e recusa solicitações não relacionadas.

Origem

Este repositório documenta o serviço hospedado. O servidor em si faz parte do código-fonte privado do produto Flownato (Python, FastAPI) e não é open source.

Links

• Produto: https://www.flownato.com
• Página do MCP: https://www.flownato.com/mcp
• Biblioteca de padrões: https://www.flownato.com/patterns
• Contato: hello@flownato.com