Gidsen

Stel verkeersvragen met een Meta Muse-connector voor webanalyse

Taras Shynkarenko
Taras Shynkarenko
•Bijgewerkt: •13 min leestijd
Een Meta Muse-connector voor webanalyse die verkeersvragen beantwoordt vanuit de Flowsery-APIEen Meta Muse-connector voor webanalyse die verkeersvragen beantwoordt vanuit de Flowsery-API

TL;DR, kort antwoord

13 min leestijd

Parallel meldde op 14 september 2026 dat Muse geen MCP-instelling toont. Vraag Muse om een eigen connector te bouwen op basis van de API-referentie op https://flowsery.com/docs/api-introduction.md, plak een flow_ws_-workspacetoken in de beveiligde credentialprompt en houd de vijf schrijfcalls achter een goedkeuring. Meta beoordeelt eigen connectors niet, en browsersessies van Muse komen in je analytics terecht als menselijke sessies.

De meeste artikelen over een Meta Muse-connector voor webanalyse beginnen bij MCP, en dat is het eerste idee dat je moet loslaten. Muse, de consumentenagent die Meta op 8 september 2026 lanceerde, toont geen veld om een MCP-server toe te voegen: Parallel vroeg het op 14 september 2026 om verbinding te maken met een Model Context Protocol-server en meldde dat Muse "geen instelling 'add MCP server' heeft". Wat het wel heeft is een Custom Connector, en wat die in één bericht laat werken, is een publieke API-referentie.

Kort gezegd: zeg tegen Muse dat hij een eigen connector bouwt op basis van de API-referentie van Flowsery, plak een flow_ws_-workspacetoken in de beveiligde credentialprompt van Muse en vraag dan "hoe deed het verkeer het vorige week, uitgesplitst per kanaal".

Waar het verzoek echt naartoe gaat
Runtimecel van Muse
Sentinel bij uitgaand verkeer
analytics.flowsery.com
GET /overview
De agent stelt de call voor. Sentinel beslist of hij de VM verlaat en wisselt het vervangende token aan de netwerkgrens om voor je echte sleutel.

Wat is een Meta Muse-connector?

Een Meta Muse-connector is een app of dienst die je aan Muse koppelt zodat de agent er een vaardigheid bij krijgt, en zo definieert het helpcentrum van Meta het woord. Meta levert twee soorten. Connectors komen uit een lijst in Settings. Het artikel van Meta over connectors noemt alleen Gmail, Apple Health, Android SMS en Google Workspace; de bredere lijst bij de lancering, inclusief Google Calendar en OpenTable, komt uit de post van Alexandr Wang van 8 september 2026 en niet uit de documentatie van Meta. Custom Connectors zijn de connectors die Muse zelf bouwt voor een dienst die niet op die lijst staat, en Flowsery is er zo een.

De zin van Meta zelf is het hele mechanisme: "Wil je verbinding maken met een dienst die nog niet in de lijst met connectors staat, dan kun je Muse vragen een Custom Connector te maken. Muse begeleidt je door het proces, waarbij mogelijk API-informatie van de dienst wordt opgehaald." De credentials die je overhandigt komen terecht in wat Meta zijn Secure Credentials Store noemt.

Let op wat in die beschrijving ontbreekt. Parallel vond in Muse geen veld "add an MCP server", en op 20 september 2026 komt MCP in geen enkel helpartikel over de consumentenagent voor. Meta documenteert MCP wel uitgebreid, maar voor Muse Code, zijn codeeragent voor de terminal, die servers leest uit een mcp_servers-blok in een instellingenbestand. Twee producten, één naam. Flowsery draait een gehoste MCP-server op https://mcp.flowsery.com/mcp, en die is de juiste keuze voor Claude, Cursor of Codex. Het is niet de route naar Muse.

Kan Muse je analytics lezen zonder connector?

Muse leest een dashboard zoals een mens dat doet: door het te openen in de browser in zijn eigen virtuele machine in de cloud en in te loggen op je account. Die route werkt, maar is breekbaar. Meta zegt dat de browser-subagent een snapshot van de toegankelijkheidsboom ziet in plaats van de ruwe DOM en geen JavaScript in de pagina kan uitvoeren, dus elk getal dat hij rapporteert is afgelezen van een gerenderd scherm, en een gewijzigde lay-out wist wat hij vorige week leerde.

De hardere beperking is waar de VM staat. Elke Muse-gebruiker krijgt een eigen virtuele machine in de cloud van Meta, waardoor alles wat op je eigen netwerk draait buiten bereik ligt. Een MCP-server op je laptop is onbereikbaar. Net als een stagingomgeving achter een VPN, en alles op localhost. Parallel meldde dit op 14 september 2026, en de reden geldt breder: wat niet bereikbaar is vanaf het publieke internet, is niet bereikbaar vanuit de cloud van Meta. Was je eerste plan om Muse op iets op je eigen machine te richten, schrap dat plan dan voordat je één regel configuratie schrijft.

De API van Flowsery is publiek, gehost en overal bereikbaar, en daarom wint de connectorroute van de browserroute. https://analytics.flowsery.com/analytics/api/v1 beantwoordt een verzoek uit de cloud van Meta op dezelfde manier als een verzoek uit je terminal.

Wat plak je in Muse?

Muse bouwt een werkende Flowsery-connector uit één bericht met de URL van de API-referentie en de manier van authenticeren. De basis-URL voor elk v1-endpoint is https://analytics.flowsery.com/analytics/api/v1/, en de referentie voor elk endpoint staat op 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.

De agentspagina van Flowsery met het mcp.json-configuratieblok, de one-liner voor Claude Code en de opmerking dat een Bearer-token headless agents dekt.

De referentie zonder login is het deel dat het werk doet. Het advies van Parallel aan iedereen die wil dat een agent zijn dienst in één bericht oppikt, is een publiek OpenAPI-document of een server-URL die zonder inloggen leesbaar is, want "afgeschermde documentatie maakt van een setup met één bericht een browsersessie". Elke pagina op flowsery.com heeft ook een markdown-tweeling, dus geef Muse https://flowsery.com/docs/api-introduction.md in plaats van de gerenderde pagina als hij om tekst vraagt.

Van plakken naar het eerste antwoord
1
Plak het bericht hierboven in Muse. Muse leest de spec en vraagt daarna hoe de API authenticeert.
2
Maak een workspacetoken aan op flowsery.com/api-tokens. Het begint met flow_ws_. Een prefix flowsery_ is geen echt token; dat zie je alleen in decoratieve screenshots.
3
Zet het in de beveiligde credentialprompt. Muse vraagt erom in een eigen veld. Een token dat je in het gesprek typt, blijft in het gesprek staan.
4
Vraag: "som mijn websites op en geef me dan het overzicht van vorige week tegenover de week ervoor." Twee leescalls, niets geschreven.
Een 400 bij stap 4 betekent dat Muse websiteId heeft overgeslagen. Zeg dat hij eerst GET /websites moet aanroepen en de ID moet meenemen.

Welke calls kun je veilig automatiseren, en welke hebben een mens nodig?

De publieke API van Flowsery documenteert 28 operaties, en 23 daarvan lezen alleen. Vijf wijzigen data, en die vijf zijn het hele toezichtprobleem. Geef de leescalls aan Muse en zet een goedkeuring voor de schrijfacties.

CallWat hij teruggeeftWijzigt data
GET /overviewKerncijfers voor een periodeNee
GET /timeseriesDezelfde cijfers ingedeeld in de tijdNee
GET /realtimeBezoekers die nu op de site zijnNee
GET /pages, /referrers, /campaigns, /hostnamesUitsplitsingen om te vinden waar een daling neerkwamNee
GET /countries, /devices, /browsers, /cities, /regions, /operating-systemsHetzelfde naar geografie, hardware en softwareNee
GET /goalsBehaalde doelen in de periodeNee
GET /issues, GET /issues/{issueId}Door AI gedetecteerde issues met de sessies die ze raaktenNee
GET /websitesDe websites die deze sleutel mag lezenNee
GET /visitors/{visitorId}De activiteitentijdlijn van één bezoekerNee
PATCH /issues/{issueId}Zet een issue op open, in behandeling, opgelost of opgeschortJa
POST /goals, DELETE /goalsRegistreert of verwijdert een doelJa
POST /payments, DELETE /paymentsRegistreert of verwijdert een betaling, verlenging of terugbetalingJa

PATCH /issues/{issueId} is de call die de strengste goedkeuring nodig heeft. Een issue als opgeschort markeren haalt het uit de standaardlijst, en de standaardlijst is degene die iedereen echt opent. Een agent die op eigen oordeel je issue-backlog opruimt, maakt de backlog kleiner zonder er iets in te repareren. De standaardinstellingen van Muse dekken hier een deel van af: Meta zegt dat Muse veel belangrijke acties niet zonder goedkeuring uitvoert, en dat veel connectors zo worden ingesteld dat de agent alleen data ophaalt.

Een gesloten hangslot aan een houten deur, als beeld voor het bewaren van het workspacetoken in een beveiligde credentialprompt in plaats van in de chat.

Goedkeuringsopties, van smal naar breed
1
Allow once. Eén call, daarna vraagt Muse het opnieuw. De juiste keuze voor elke schrijfactie.
2
Allow for this task. De goedkeuring geldt voor de taak die Muse op dat moment uitvoert.
3
Allow for this site. De goedkeuring geldt voor de site, wat de taak ook is.
4
Always allow. Geen prompts meer. Houd dit weg bij PATCH, POST en DELETE.
Deny is de vijfde optie, voor een schrijfactie waar je niet om vroeg.

Waar gaat het workspacetoken naartoe?

Het workspacetoken gaat in de beveiligde credentialprompt van Muse, nooit in de chat. Meta bewaart credentials van connectors en OAuth-tokens op je eigen VM, en de engineeringpost is specifiek over de isolatie: "ze worden opgeslagen in een aparte, geïsoleerde container in je VM, niet in andere diensten van Meta." De code van de agent heeft alleen een vervanger. Sentinel, het aparte onderdeel aan de hostkant dat elk netwerkverzoek autoriseert dat de VM verlaat, zet de echte credential in op de netwerkgrens.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Maak het token aan op https://flowsery.com/api-tokens. Het begint met flow_ws_. Een workspacetoken dekt elke website in de workspace, dus elke call heeft websiteId of domain nodig om er één aan te wijzen. Laat je de selector weg, dan geeft de API een 400 Website ID or domain is required terug, omdat een workspacetoken op zichzelf niet uitkomt op één website. Een selector die bij geen enkele website past, geeft 404 Website not found.

Meta beoordeelt eigen connectors niet, en ook niet hoe ze je gegevens gebruiken, en zegt dat in gewone taal op zijn eigen helppagina. Parallel voegt een bevinding toe die nergens in de documentatie van Meta staat: de code van een eigen connector draait in de eigen runtimecel van de agent en krijgt niet de extra scheiding van rechten die Meta toepast op ingebouwde connectors, waarvan de logica buiten die cel draait in workers met gescheiden rechten en expliciete allowlists voor credentials. Dat is een waarneming van Parallel, geen verklaring van Meta, en het is de reden om Muse een afgebakend token te geven dat je kunt verwijderen in plaats van een credential die alles opent.

Kun je de eigen bezoeken van Muse onderscheiden van echte bezoekers?

Geen enkele analysetool kan de eigen bezoeken van Muse scheiden van menselijke. Op 20 september 2026 is er geen gepubliceerde user agent-string voor Muse, geen gepubliceerd IP-bereik en geen robots.txt-token, en de eigen securitypost van Meta zegt dat wanneer Muse op internet surft "het zal verschijnen als jouw activiteit". Browsersessies van Muse komen in je analytics terecht als gewone menselijke sessies, zonder enige markering.

De situatie is erger dan een simpele afwezigheid, want er bestaan wel twee crawleridentiteiten van Meta, en geen van beide is Muse. Het overzicht van AI-user agents voor 2026 op nohacks.co, bijgewerkt op 8 augustus 2026, noemt meta-externalagent/1.1 en waarschuwt om die niet te verwarren met facebookexternalhit. Beide zijn crawlers. Muse is een browsersessie die een agent stuurt namens een ingelogde persoon. Wie op 20 september 2026 een "user agent-string van Muse" publiceert, heeft die verzonnen, en een filter op basis van een verzonnen string schrapt echt verkeer uit je rapporten.

Wat gepubliceerd is, en wat niet
Gedocumenteerd
  • Muse draait in een cloud-VM per gebruiker met een eigen browser
  • Meta: surfen "zal verschijnen als jouw activiteit"
  • meta-externalagent/1.1 en facebookexternalhit bestaan, en beide zijn crawlers
Nergens gepubliceerd
  • Een user agent-string voor Muse
  • Een IP-bereik voor de VM's van Muse
  • Een robots.txt-token voor Muse
  • Een manier om een site af te melden voor surfende agents
Gecontroleerd op 20 september 2026. Beschouw elke leverancierslijst die de rechterkolom invult als giswerk.

Uit dat gat volgen twee dingen, en het tweede is een afleiding, geen documentatie. Ten eerste raakt een connector je site helemaal niet. Als Muse GET /overview aanroept, gaat dat naar de API, laadt het geen pagina en gaat er geen tracker af, dus de connectorroute houdt je cijfers schoon terwijl de browserroute ze stilletjes opblaast. Ten tweede, en dit is mijn lezing van hoe de browser-subagent zich gedraagt, niet iets wat Meta of Flowsery publiceert: een agentsessie in een replay ziet er anders uit dan een mens. Rechtstreeks naar een diepe URL, geen aarzeling bij het scrollen, geen dwalende cursor, geen rage clicks, weg. Flowsery neemt sessies op, dus het patroon blijft zichtbaar, ook als de user agent je niets vertelt. Bouw daar geen filter op. Bouw er een vermoeden op, en open dan de replay om het te controleren.

Wat kost een Muse-connector voor Flowsery?

Een Meta Muse-connector voor Flowsery kost aan geen van beide kanten iets. Muse is gratis tot je een wekelijkse gebruikslimiet bereikt, en de Engelstalige abonnementspagina van Meta noemt op 20 september 2026 een Power-abonnement van USD 20 per maand voor 500 miljoen Muse-tokens per week en een Max-abonnement van USD 100 per maand voor 3 miljard. Parallel meldt dat eigen connectors van datzelfde wekelijkse tegoed gebruikmaken, zonder aparte kosten.

Flowsery heeft de publieke API in beide abonnementen. Team kost $250 per maand en omvat 5 teamleden, 2 websites en 3 maanden bewaring van replays. Pro kost $500 per maand en omvat 10 teamleden, onbeperkt veel websites en 12 maanden bewaring van replays. Beide bewaren analytics 3 jaar, en beide beginnen met een gratis proefperiode van 14 dagen zonder creditcard.

Geografie is de echte drempel. Muse werd op 8 september 2026 in de Verenigde Staten gelanceerd en kwam naar Canada in dezelfde week dat Meta het connectorplatform openstelde. Canada kreeg Muse op iOS en web, met Android daar op 20 september 2026 nog in afwachting; in de VS draait het op iOS, Android, muse.ai en sinds 17 september 2026 op macOS. Voor een abonnement heb je een Meta-account nodig en moet je 18 zijn, of meerderjarig volgens de regels waar je woont. Zit je team op 20 september 2026 buiten dat gebied, dan verandert geen enkel Flowsery-abonnement daar iets aan.

Een hand die een stekker uit een stopcontact trekt, als beeld voor het verwijderen van het token als uitknop die de toegang van de connector afsnijdt.

Hoe trek je de toegang van een Muse-connector tot Flowsery in?

Verwijder het token op flowsery.com/api-tokens. Dat is de intrekking die standhoudt, want die snijdt de connector af bij de API, wat Muse ook nog op zijn VM heeft opgeslagen.

Aan de kant van Muse staan connectors onder Settings en dan Connectors, en daar koppel je elke connector in de lijst los. Meta zegt expliciet dat loskoppelen de uitwisseling van data stopt en niet wist wat Muse er al van heeft geleerd. De forget-skill van Muse heeft hetzelfde voorbehoud: Meta geeft toe dat verwijderen alleen ervoor kan zorgen dat de agent zich nog steeds herinnert wat hij leerde. Muse resetten verwijdert al je Muse-data.

Twee uitknoppen, en wat elk ervan stopt
Het flow_ws_-token verwijderen
  • Elke call van Muse begint te mislukken bij de API
  • Werkt of Muse de credential nog heeft of niet
  • Werkt direct zodra je het verwijdert
Loskoppelen in Muse
  • Stopt de uitwisseling van data
  • Laat staan wat Muse al heeft geleerd
  • Geldt voor connectors in de lijst; hoe je een connector verwijdert die Muse zelf bouwde, is niet gedocumenteerd
Trek eerst in bij de API. Zie het loskoppelen in Muse als opruimwerk achteraf.

Wat Meta op 20 september 2026 niet documenteert, is hoe je een connector verwijdert die Muse voor zichzelf bouwde. Het helpcentrum behandelt het loskoppelen van connectors uit de lijst in Settings en houdt daar op. Tot dat gat dicht is, behandel je het Flowsery-token als uitknop en houd je het beperkt tot de websites die je wilt blootstellen.

Veelgestelde vragen

Ondersteunt Meta Muse MCP?

Parallel meldde op 14 september 2026 dat Muse geen MCP-instelling toont, en op 20 september 2026 komt MCP in geen enkel helpartikel over de consumentenagent voor. Meta documenteert MCP voor Muse Code, zijn aparte codeeragent voor de terminal, waar servers in een mcp_servers-blok in een instellingenbestand staan. De gehoste MCP-server van Flowsery op https://mcp.flowsery.com/mcp bedient Claude, Cursor en Codex, en Muse krijgt in plaats daarvan de REST-API.

Wat ziet Muse over mijn bezoekers?

Muse ziet de identiteitsdata die je naar Flowsery stuurt. Flowsery is cookievrij, slaat geen IP-adressen op en zet geen identifiers over sites heen, maar GET /visitors/{visitorId} geeft voor elke bezoeker die je hebt geïdentificeerd een profile-blok terug met userId, name en email, naast de activiteitentijdlijn van die bezoeker. GET /realtime/map toont de bezoekers die nu actief zijn met hun stad en huidige URL, en GET /issues/{issueId} geeft de opname-ID's terug van de sessies die een issue raakte; al het andere in de API is geaggregeerd. Een workspacetoken stelt verkeer, omzet, behaalde doelen en de issues die Flowsery in sessie-opnames detecteert bloot, over elke website in die workspace. Houd het token beperkt tot de workspace die je wilt delen.

Waarom krijgt Muse een 400 op een website die hij wel ziet?

Een Flowsery-workspacetoken dekt elke website in de workspace, dus elke call heeft websiteId of domain nodig om er één aan te wijzen. Laat je de selector weg, dan krijg je een 400 Website ID or domain is required, omdat een workspacetoken op zichzelf niet uitkomt op één website. Een selector die bij geen enkele website past, geeft in plaats daarvan 404 Website not found. Zeg tegen Muse dat hij eerst GET /websites aanroept en de ID meeneemt in elke call daarna.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Kan Muse zelf issues in Flowsery sluiten?

PATCH /issues/{issueId} is de enige call die de status van een issue verandert, en het setupbericht hierboven zegt tegen Muse dat hij niets schrijft zonder het eerst te vragen. De goedkeuringsflow van Meta ondersteunt dat: prompts verschijnen in de interface van de client en niet in het gesprek, en bieden Allow once, Allow for this task, Allow for this site, Always allow en Deny. Kies Allow once voor alles wat schrijft.

Overleeft de connector een wijziging in de Flowsery-API?

Meta publiceert daar op 20 september 2026 geen antwoord op, en de opgeslagen skill bevat de lijst met calls die Muse tijdens de setup leerde. De API-referentie van Flowsery blijft publiek op https://flowsery.com/docs/api-introduction, dus de reparatie is één bericht: zeg tegen Muse dat hij de referentie opnieuw leest en zijn connector bijwerkt. Draai daarna opnieuw de controle met GET /websites om te bevestigen dat hij nog authenticeert.

Waar lees ik de API voordat ik dit allemaal instel?

Flowsery documenteert de REST-API op https://flowsery.com/docs/api-introduction, met een markdown-tweeling op https://flowsery.com/docs/api-introduction.md die de pagina als platte markdown teruggeeft. Het overzicht voor agents staat op https://flowsery.com/features/agents, met als tweeling https://flowsery.com/features/agents.md. Lees die en bepaal dan welke endpoints de connector mag aanraken.

Welk Flowsery-abonnement heb ik nodig voor een Muse-connector?

Allebei goed, want de publieke API zit in beide abonnementen. Team kost $250 per maand met 5 teamleden, 2 websites en 3 maanden bewaring van replays, en Pro kost $500 per maand met 10 teamleden, onbeperkt veel websites en 12 maanden bewaring van replays. Kies op basis van hoeveel websites Muse moet bereiken. Beide beginnen met een gratis proefperiode van 14 dagen zonder creditcard.

Is Meta Muse beschikbaar buiten de Verenigde Staten?

Muse werd op 8 september 2026 in de Verenigde Staten gelanceerd en kwam naar Canada in dezelfde week dat Meta het connectorplatform openstelde. Canada kreeg Muse op iOS en web, met Android daar op 20 september 2026 nog in afwachting; in de VS draait het op iOS, Android, muse.ai en sinds 17 september 2026 op macOS. Zit je team buiten dat gebied, dan verandert geen enkel Flowsery-abonnement daar iets aan.

Waar bewaart Muse mijn Flowsery-token?

In de Secure Credentials Store van Meta, die de engineeringpost beschrijft als een aparte, geïsoleerde container in je VM. De code van de agent heeft alleen een vervanger, en Sentinel zet de echte credential in op de netwerkgrens. Het token verwijderen op flowsery.com/api-tokens snijdt de toegang af, wat Muse ook nog heeft opgeslagen.

Kan ik verkeer van Muse uit mijn analytics filteren?

Nee, en elk filter dat je vindt is een gok. Meta publiceert geen user agent-string, geen IP-bereik en geen robots.txt-token voor Muse, en zegt dat surfen zal verschijnen als jouw activiteit. Een connectorcall naar de API laadt geen pagina en activeert geen tracker, dus alleen browsersessies voegen bezoeken toe die menselijk lijken. Open de replay om een verdacht bezoek te controleren.

Dezelfde vragen werken vanuit de altijd actieve agent van OpenAI via een OpenAI dots-plugin voor webanalyse, en vanuit Cue, de app van Manus, via een Manus Cue-connector voor webanalyse.

Maak een workspacetoken aan en geef Muse de spec, of lees eerst de API-referentie.

Bronnen: het helpartikel van Meta over Muse-connectors, How we built safety into Muse, het artikel van Parallel over eigen integraties in Muse (14 september 2026), het overzicht van AI-user agents voor 2026 (bijgewerkt op 8 augustus 2026) en de API-referentie van Flowsery. Gecontroleerd op 20 september 2026.

Was dit artikel nuttig?

Laat ons weten wat je ervan vindt!

Zie ons vaker in Google

Met één klik markeer je Flowsery als voorkeursbron, zodat onze artikelen hoger staan in je Topverhalen, AI-modus en AI-overzichten.

Voordat je gaat...

Flowsery

Flowsery

Analytics voor je website, met omzet voorop

Volg elke bezoeker, bron en conversie in realtime. Eenvoudig, krachtig en zonder cookies.

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Gerelateerde artikelen