Faça perguntas de tráfego com um conector do Meta Muse para analytics de site

A maioria dos textos sobre um conector do Meta Muse para analytics de site começa pelo MCP, e essa é a primeira ideia a descartar. O Muse, o agente de consumo que a Meta lançou em 8 de setembro de 2026, não exibe nenhum campo para adicionar um servidor MCP: a Parallel pediu a ele que se conectasse a um servidor Model Context Protocol em 14 de setembro de 2026 e relatou que o Muse "não tem configuração de 'adicionar servidor MCP'". O que ele tem é um Custom Connector, e o que faz um funcionar em uma única mensagem é uma referência de API pública.

Versão curta: diga ao Muse para montar um conector customizado a partir da referência da API da Flowsery, cole um token de workspace flow_ws_ no campo seguro de credencial do Muse e então pergunte "como foi o tráfego na semana passada, separado por canal".

O que é um conector do Meta Muse?

Um conector do Meta Muse é um app ou serviço que você liga ao Muse para o agente ganhar uma habilidade nova, e é assim que a central de ajuda da Meta define a palavra. A Meta entrega dois tipos. Os Connectors vêm de uma lista dentro das Configurações. O artigo da Meta sobre conectores cita apenas Gmail, Apple Health, Android SMS e Google Workspace; a lista mais ampla do lançamento, com Google Calendar e OpenTable, vem do post de Alexandr Wang de 8 de setembro de 2026, e não da documentação da Meta. Os Custom Connectors são os que o próprio Muse monta para um serviço que não está nessa lista, e a Flowsery é um deles.

A frase da própria Meta é o mecanismo inteiro: "Se você quiser se conectar a um serviço ainda não disponível na lista de Connectors, pode pedir ao Muse para criar um Custom Connector. O Muse vai guiar você pelo processo, que pode envolver buscar informações de API no serviço." As credenciais que você entrega vão parar no que a Meta chama de Secure Credentials Store.

Repare no que falta nessa descrição. A Parallel não achou nenhum campo de "adicionar um servidor MCP" no Muse, e o MCP não aparece em nenhum artigo da central de ajuda do agente de consumo até 20 de setembro de 2026. A Meta documenta MCP em detalhe, mas para o Muse Code, seu agente de programação de terminal, que lê servidores de um bloco mcp_servers em um arquivo de configuração. Dois produtos, um nome só. A Flowsery mantém um servidor MCP hospedado em https://mcp.flowsery.com/mcp e ele é a escolha certa para Claude, Cursor ou Codex. Não é o caminho para dentro do Muse.

O Muse consegue ler seu analytics sem um conector?

O Muse lê um painel do jeito que uma pessoa lê, abrindo no navegador dentro da própria máquina virtual na nuvem e entrando na sua conta. Esse caminho funciona e é frágil. A Meta diz que o subagente de navegação enxerga um snapshot da árvore de acessibilidade em vez do DOM bruto e não pode rodar JavaScript na página, então cada número que ele relata é lido de uma tela renderizada, e uma mudança de layout zera o que ele aprendeu na semana passada.

A restrição mais dura é onde a VM fica. Cada usuário do Muse recebe uma máquina virtual dedicada na nuvem da Meta, o que deixa fora de alcance qualquer coisa rodando na sua própria rede. Um servidor MCP no seu notebook é inalcançável. Uma instância de staging atrás de uma VPN também, e qualquer coisa em localhost também. A Parallel relatou isso em 14 de setembro de 2026, e o motivo se generaliza: o que não é alcançável pela internet pública não é alcançável pela nuvem da Meta. Se seu primeiro plano era apontar o Muse para algo na sua máquina, mate esse plano antes de escrever uma linha de configuração.

A API da Flowsery é pública, hospedada e alcançável de qualquer lugar, e é por isso que o caminho do conector ganha do caminho do navegador. https://analytics.flowsery.com/analytics/api/v1 responde a uma requisição vinda da nuvem da Meta do mesmo jeito que responde a uma vinda do seu terminal.

O que você cola no Muse?

O Muse monta um conector funcional da Flowsery a partir de uma mensagem que carrega a URL da referência da API e o estilo de autenticação. A URL base de todos os endpoints v1 é https://analytics.flowsery.com/analytics/api/v1/, e a referência de cada um fica em https://flowsery.com/docs/api-introduction.

Build a custom connector for Flowsery Analytics from the API reference at
https://flowsery.com/docs/api-introduction.md. The reference is public, so
read it directly without logging in.
 
Base URL: https://analytics.flowsery.com/analytics/api/v1
Full spec: GET https://flowsery.com/openapi.json, no auth needed.
Auth: an "Authorization: Bearer <token>" header. I will paste the token into
the secure credential prompt, not into this chat. It starts with flow_ws_.
 
Do not write anything yet. Call GET /websites first, list the website IDs you
can see, then list the operations you can run.

A referência sem autenticação é a parte que faz o trabalho. O conselho da Parallel para quem quer que um agente aprenda seu serviço em uma mensagem é um documento OpenAPI público ou uma URL de servidor que se leia sem login, porque "documentação fechada transforma uma configuração de uma mensagem em uma sessão de navegador". Toda página em flowsery.com também tem uma gêmea em markdown, então entregue ao Muse https://flowsery.com/docs/api-introduction.md em vez da página renderizada quando ele pedir texto.

Quais chamadas dá para automatizar e quais precisam de uma pessoa?

A API pública da Flowsery documenta 27 operações e 22 delas apenas leem. Cinco alteram dados, e essas cinco são todo o problema de supervisão. Entregue as leituras ao Muse e coloque uma aprovação na frente das escritas.

PATCH /issues/{issueId} é a chamada que precisa da aprovação mais apertada. Marcar um problema como suspended o tira da lista padrão, e a lista padrão é a que todo mundo realmente abre. Um agente arrumando seu backlog de problemas por conta própria encolhe o backlog sem consertar nada dentro dele. Os padrões do Muse cobrem parte disso: a Meta diz que o Muse não executa muitas ações importantes sem aprovação, e que muitos conectores são configurados para o agente apenas buscar dados.

Para onde vai o token de workspace?

O token de workspace vai para o campo seguro de credencial do Muse, nunca para o chat. A Meta guarda credenciais de conector e tokens OAuth na sua própria VM, e o post de engenharia é específico sobre o isolamento: "eles ficam armazenados em um contêiner isolado separado na sua VM, e não em outros serviços da Meta." O código do agente segura apenas um substituto. O Sentinel, o componente separado do lado do host que autoriza cada requisição de rede que sai da VM, troca pela credencial real na fronteira de rede.

Crie o token em https://flowsery.com/api-tokens. Ele começa com flow_ws_. Um token de workspace cobre todos os sites do workspace, então cada chamada precisa de websiteId ou domain para nomear um. Deixe o seletor de fora e a API devolve um 404 Website not found, porque um token de workspace não resolve sozinho para um único site.

A Meta não revisa conectores customizados nem o que eles fazem com suas informações, e ela diz isso em texto claro na própria página de ajuda. A Parallel acrescenta uma constatação que não está em nenhuma documentação da Meta: o código de um conector customizado roda dentro da própria célula de runtime do agente e não recebe a separação extra de privilégios que a Meta aplica aos conectores nativos, cuja lógica roda fora dessa célula, em workers com privilégios separados e listas explícitas de credenciais permitidas. Isso é observação da Parallel, não declaração da Meta, e é o motivo para dar ao Muse um token restrito que você possa apagar em vez de uma credencial que abre tudo.

Dá para separar as visitas do próprio Muse das de visitantes reais?

Nenhuma ferramenta de analytics separa as visitas do próprio Muse das humanas. Até 20 de setembro de 2026 não há user agent publicado do Muse, nem faixa de IP publicada, nem token de robots.txt, e o próprio post de segurança da Meta diz que quando o Muse navega na internet "ele vai aparecer como atividade sua". As sessões de navegação do Muse caem no seu analytics como sessões humanas comuns, sem nada que as marque.

A situação é pior que uma ausência simples, porque existem duas identidades de crawler da Meta e nenhuma delas é o Muse. A referência de user agents de IA de 2026 no nohacks.co, atualizada em 8 de agosto de 2026, lista meta-externalagent/1.1 e alerta para não confundi-lo com facebookexternalhit. Os dois são crawlers. O Muse é uma sessão de navegador conduzida por um agente em nome de uma pessoa logada. Quem publicar um "user agent do Muse" até 20 de setembro de 2026 inventou, e um filtro construído sobre uma string inventada apaga tráfego real dos seus relatórios.

Duas coisas seguem dessa lacuna, e a segunda é inferência, não documentação. Primeira: um conector não encosta no seu site. O Muse chamando GET /overview bate na API, não carrega página nenhuma e não dispara rastreador nenhum, então a rota do conector mantém seus números limpos enquanto a rota do navegador os infla em silêncio. Segunda, e esta é a minha leitura de como o subagente de navegação se comporta, não algo que a Meta ou a Flowsery publiquem: uma sessão de agente em uma gravação não se parece com uma pessoa. Direto para uma URL profunda, sem hesitação de rolagem, sem deriva do ponteiro, sem cliques de raiva, e some. A Flowsery grava sessões, então o formato continua observável mesmo quando o user agent não diz nada. Não construa um filtro sobre isso. Construa um palpite, depois abra a gravação e confira.

Quanto custa um conector do Muse para a Flowsery?

Um conector do Meta Muse para a Flowsery não custa nada dos dois lados. O Muse é gratuito até você bater um limite semanal de uso, e a página de assinaturas em inglês da Meta lista um plano Power a USD 20 por mês por 500 milhões de tokens do Muse por semana e um plano Max a USD 100 por mês por 3 bilhões, até 20 de setembro de 2026. A Parallel relata que conectores customizados consomem esse mesmo medidor semanal, sem cobrança separada.

A Flowsery inclui a API pública nos dois planos. O Team custa $250 por mês e cobre 5 integrantes de equipe, 2 sites e retenção de gravações de 3 meses. O Pro custa $500 por mês e cobre 10 integrantes de equipe, sites ilimitados e retenção de gravações de 12 meses. Os dois guardam analytics por 3 anos, e os dois começam com 14 dias de teste gratuito, sem cartão.

A geografia é a barreira de verdade. O Muse foi lançado nos Estados Unidos em 8 de setembro de 2026 e chegou ao Canadá na mesma semana em que a Meta abriu a plataforma de conectores. O Canadá recebeu o Muse em iOS e web, com Android ainda pendente por lá até 20 de setembro de 2026; nos Estados Unidos ele roda em iOS, Android, muse.ai e, desde 17 de setembro de 2026, macOS. Assinar exige uma conta Meta e 18 anos, ou a maioridade onde você mora. Se sua equipe está fora dessa área até 20 de setembro de 2026, nenhum plano da Flowsery muda a resposta.

Como revogar o acesso de um conector do Muse à Flowsery?

Apague o token em flowsery.com/api-tokens. Essa é a revogação que se sustenta, porque ela corta o conector na API, independentemente do que o Muse ainda tenha salvo na VM dele.

Do lado do Muse, os conectores ficam listados e são gerenciados em Configurações e depois Connectors, e qualquer conector listado se desconecta por ali. A Meta é explícita em dizer que desconectar para a troca de dados e não apaga o que o Muse já aprendeu com ela. A skill de esquecimento do Muse carrega a mesma ressalva, com a Meta admitindo que apagar sozinho pode deixar o agente ainda lembrando do que aprendeu. Resetar o Muse apaga todos os seus dados do Muse.

O que a Meta não documenta, até 20 de setembro de 2026, é como remover um conector que o Muse montou para si mesmo. A central de ajuda cobre a desconexão de conectores pela lista das Configurações e para por aí. Até essa lacuna fechar, trate o token da Flowsery como a chave de desligar e mantenha-o restrito aos sites que você aceita expor.

Perguntas frequentes

O Meta Muse suporta MCP?

A Parallel relatou em 14 de setembro de 2026 que o Muse não exibe nenhuma configuração de MCP, e o MCP não aparece em nenhum artigo da central de ajuda do agente de consumo até 20 de setembro de 2026. A Meta documenta MCP para o Muse Code, seu agente separado de programação de terminal, onde os servidores ficam em um bloco mcp_servers em um arquivo de configuração. O servidor MCP hospedado da Flowsery em https://mcp.flowsery.com/mcp atende Claude, Cursor e Codex, e o Muse fica com a API REST.

O que o Muse vê sobre os meus visitantes?

O Muse vê os dados de identidade que você manda para a Flowsery. A Flowsery funciona sem cookies, não guarda endereços IP e não define identificadores entre sites, mas GET /visitors/{visitorId} devolve um bloco profile com userId, name e email de qualquer visitante que você tenha identificado, junto com a linha do tempo de atividade desse visitante. GET /realtime/map lista os visitantes ativos agora com a cidade e a URL atual, e GET /issues/{issueId} devolve os IDs de gravação das sessões que um problema atingiu; todo o resto da API é agregado. Um token de workspace expõe tráfego, receita, objetivos concluídos e os problemas que a Flowsery detecta nas gravações de sessão, em todos os sites daquele workspace. Mantenha o token restrito ao workspace que você aceita compartilhar.

Por que o Muse recebe um 404 em um site que ele consegue ver?

Um token de workspace da Flowsery cobre todos os sites do workspace, então cada chamada precisa de websiteId ou domain para nomear um. Deixar o seletor de fora devolve um 404 Website not found, porque um token de workspace não resolve sozinho para um único site. Diga ao Muse para chamar GET /websites primeiro e levar o ID adiante em todas as chamadas seguintes.

O Muse pode fechar problemas na Flowsery sozinho?

PATCH /issues/{issueId} é a única chamada que muda o status de um problema, e a mensagem de configuração acima manda o Muse não escrever nada sem perguntar antes. O fluxo de aprovação da Meta sustenta isso: os avisos aparecem na interface do cliente, e não dentro da conversa, e oferecem Allow once, Allow for this task, Allow for this site, Always allow e Deny. Escolha Allow once para qualquer coisa que escreva.

O conector sobrevive a uma mudança na API da Flowsery?

A Meta não publica resposta para isso até 20 de setembro de 2026, e a skill salva guarda a lista de chamadas que o Muse aprendeu na configuração. A referência da API da Flowsery continua pública em https://flowsery.com/docs/api-introduction, então o conserto é uma mensagem: diga ao Muse para reler a referência e atualizar o conector. Rode de novo o teste do GET /websites depois, para confirmar que ele ainda autentica.

Onde eu leio a API antes de montar tudo isso?

A Flowsery documenta a API REST em https://flowsery.com/docs/api-introduction, com uma gêmea em markdown em https://flowsery.com/docs/api-introduction.md que devolve a página como markdown puro. A visão geral voltada a agentes fica em https://flowsery.com/features/agents, com gêmea em https://flowsery.com/features/agents.md. Leia essas páginas e então decida em quais endpoints o conector pode encostar.

Qual plano da Flowsery preciso para um conector do Muse?

Qualquer um, porque a API pública está incluída nos dois planos. O Team custa $250 por mês com 5 membros, 2 sites e 3 meses de retenção de replays, e o Pro custa $500 por mês com 10 membros, sites ilimitados e 12 meses de retenção. Escolha pelo número de sites que o Muse deve alcançar. Os dois começam com um teste gratuito de 14 dias, sem cartão.

O Meta Muse está disponível fora dos Estados Unidos?

O Muse foi lançado nos Estados Unidos em 8 de setembro de 2026 e incluiu o Canadá na mesma semana em que a Meta abriu a plataforma de conectores. O Canadá recebeu o Muse em iOS e web, com Android ainda pendente por lá em 20 de setembro de 2026; nos Estados Unidos ele roda em iOS, Android, muse.ai e, desde 17 de setembro de 2026, macOS. Se a sua equipe está fora dessa área, nenhum plano da Flowsery muda a resposta.

Onde o Muse guarda meu token da Flowsery?

No Secure Credentials Store da Meta, que o artigo de engenharia descreve como um contêiner isolado e separado dentro da sua VM. O código do agente guarda só um substituto, e o Sentinel coloca a credencial real na fronteira da rede. Apagar o token em flowsery.com/api-tokens corta o acesso, não importa o que o Muse ainda tenha salvo.

Dá para filtrar o tráfego do Muse do meu analytics?

Não, e qualquer filtro que você encontrar é palpite. A Meta não publica user agent do Muse, faixa de IP nem token de robots.txt, e diz que a navegação vai aparecer como atividade sua. Uma chamada do conector à API não carrega página nem dispara rastreador, então só as sessões de navegador somam visitas com cara de humano. Abra o replay para conferir uma visita suspeita.

Crie um token de workspace e entregue a especificação ao Muse, ou leia antes a referência da API.

Fontes: artigo de ajuda da Meta sobre os conectores do Muse, How we built safety into Muse, análise da Parallel sobre integrações customizadas do Muse (14 de setembro de 2026), a referência de user agents de IA de 2026 (atualizada em 8 de agosto de 2026) e a referência da API da Flowsery. Verificado em 20 de setembro de 2026.