MCP-server
Koppel Claude, ChatGPT of een andere compatibele AI-assistent aan je Fullmetrix-gegevens en bevraag je winkel vanuit de assistent die je al gebruikt.
Met de Fullmetrix MCP-server kan je vertrouwde AI-assistent, zoals Claude of ChatGPT, je Fullmetrix-gegevens lezen. Na de koppeling stel je je vragen in Claude of ChatGPT, bijvoorbeeld "Welke producten verkochten het best in september?", en de assistent haalt het antwoord uit je cijfers.
MCP staat voor Model Context Protocol. Het is een open standaard die bepaalt hoe een AI-assistent verbinding maakt met een gegevensbron. Elke MCP-compatibele assistent kan dus op dezelfde manier met Fullmetrix verbinden.
De toegang is alleen-lezen. De assistent kan je gegevens lezen, maar niets wijzigen in Fullmetrix, in je winkel of in je advertentieaccounts.
Liever in Fullmetrix blijven?
De AI-assistent die in Fullmetrix is ingebouwd, doet hetzelfde werk zonder de app te verlaten, en voegt grafieken en deelbare rapporten toe. De MCP-server is er voor wanneer je wilt werken vanuit de assistent die je al gebruikt.
Het serveradres
Elke client gebruikt hetzelfde adres.
https://app.fullmetrix.com/api/mcpDe server draait via HTTP, in de modus die MCP-clients "Streamable HTTP" noemen. Je kunt op twee manieren verbinden.
- Met je Fullmetrix-account. De client stuurt je naar een Fullmetrix-pagina waar je de toegang goedkeurt. Dit is de aanbevolen methode, zonder sleutel om te kopiëren.
- Met een API-sleutel, voor clients die geen aanmeldpagina kunnen openen. Zie hieronder.
Voordat je begint
Je hebt een Fullmetrix-account nodig met minstens één organisatie waarvan de winkel is gekoppeld en gesynchroniseerd. De assistent leest de gegevens van je organisaties, dus er moeten gegevens zijn om te lezen.
De MCP-toegang maakt deel uit van je Fullmetrix-abonnement, zonder extra kosten. Het gebruik van Claude of ChatGPT wordt nog steeds gefactureerd door hun makers, volgens je plan bij hen.
Claude koppelen
De Fullmetrix-vermelding openen
Fullmetrix Analytics staat in de Claude-directory. Open de pagina, of zoek Fullmetrix in Claude, in het gedeelte connectoren van je instellingen.
De connector toevoegen
Klik op de knop om toe te voegen. Claude opent een Fullmetrix-pagina. Log in indien nodig en geef toegang zoals beschreven in het volgende gedeelte.
Een vraag stellen
Controleer in een nieuw gesprek of de Fullmetrix-connector aanstaat en stel je vraag.
Afhankelijk van je Claude-abonnement kan het toevoegen van connectoren beperkt zijn tot bepaalde abonnementen of tot de beheerder van je teamwerkruimte. Het adres https://app.fullmetrix.com/api/mcp werkt nog steeds als aangepaste connector als je het liever handmatig toevoegt.
ChatGPT koppelen
ChatGPT accepteert MCP-servers als aangepaste app, ook wel connector genoemd.
De instellingen voor apps openen
Open in ChatGPT de instellingen en daarna het onderdeel met apps en connectors. Afhankelijk van je plan moet je voor het toevoegen van een aangepaste app eerst de ontwikkelaarsmodus inschakelen in de geavanceerde instellingen.
De app aanmaken
Maak een nieuwe app aan. Geef hem de naam Fullmetrix, plak het adres https://app.fullmetrix.com/api/mcp en kies OAuth-authenticatie. Bevestig.
De toegang goedkeuren
ChatGPT opent de Fullmetrix-pagina. Meld je aan als dat nodig is en keur de toegang daarna goed.
Fullmetrix gebruiken in een gesprek
Voeg in een gesprek de Fullmetrix-app toe via het menu met tools en stel dan je vraag.
De menu's van ChatGPT veranderen vaak. Kun je de optie niet vinden, zoek dan in de ChatGPT-help naar "custom connector" of "MCP".
Een andere MCP-client koppelen
Cursor, Visual Studio Code, Windsurf en de meeste MCP-compatibele tools stel je in met het serveradres. Declareer in het MCP-configuratiebestand van je tool een externe server, zo.
{
"mcpServers": {
"fullmetrix": {
"url": "https://app.fullmetrix.com/api/mcp"
}
}
}De exacte sleutelnamen kunnen per tool verschillen. Raadpleeg de documentatie ervan. Bij het eerste gebruik opent de tool de Fullmetrix-autorisatiepagina in je browser.
Verbinden met een API-sleutel
Ondersteunt je client geen aanmelding met een account, gebruik dan een API-sleutel. Maak hem aan in Instellingen, op het tabblad API-sleutels, zoals beschreven in Publieke API. Voeg hem daarna toe aan de header Authorization van de verzoeken van de client.
{
"mcpServers": {
"fullmetrix": {
"url": "https://app.fullmetrix.com/api/mcp",
"headers": {
"Authorization": "Bearer fmx_YOUR_KEY"
}
}
}
}Een sleutel geeft toegang tot één organisatie, die waarin je hem hebt aangemaakt. Aanmelden met je account geeft toegang tot al je organisaties.
De autorisatiepagina
Wanneer een client met je account verbindt, toont Fullmetrix de pagina Connect an external application. Ben je niet aangemeld bij Fullmetrix, dan komt eerst de aanmeldpagina.
De pagina beschrijft waar de applicatie om vraagt.
- Read analytics data, dus het bekijken van je winkels, klanten, producten, bestellingen, campagnes, kosten en gegevens van gekoppelde diensten.
- Access authorized organizations. Alleen organisaties waar je in Fullmetrix al toegang toe hebt, zijn beschikbaar.
Een melding herinnert je eraan dat de toegang alleen-lezen is. Klik op Authorize access om te bevestigen, of op Deny om te annuleren. Je wordt daarna automatisch teruggebracht naar je client.
Verschijnt de melding "The authorization could not be completed. Please try again.", start de verbinding dan opnieuw vanuit je client.
Welke organisaties beschikbaar zijn
Aanmelden met je account geeft toegang tot de organisaties die je in Fullmetrix ziet. Dat zijn de organisaties van je bedrijf als je beheerder bent, en die waartoe een beheerder je toegang heeft gegeven. De assistent ziet nooit een organisatie die je zelf niet kunt zien. Zie Team en rollen om deze toegangen te beheren.
Heb je meerdere organisaties, noem dan de winkel of organisatie in je vraag. Anders bevraagt de assistent de eerste uit de lijst.
De beschikbare tools
Een MCP-client ontdekt tools, dus acties die hij kan aanroepen. Fullmetrix biedt er drie aan, allemaal alleen-lezen.
| Tool | Wat het doet |
|---|---|
describe_data | Beschrijft de beschikbare gegevens en de diensten die aan je organisaties zijn gekoppeld. De assistent roept hem aan vóór zijn eerste vraag |
query_data | Leest je winkelgegevens in Fullmetrix, zoals bestellingen, orderregels, producten, varianten, categorieën, klanten, contacten, winkelwagens, kortingscodes, terugbetalingen, abonnementen en het surfgedrag van bezoekers. Hij leest ook de configuratiegegevens van je Fullmetrix-account |
platform_query | Bevraagt een gekoppelde dienst, uit Google Ads, Meta Ads, TikTok Ads, ChatGPT Ads, Google Analytics 4, Search Console en Crisp. Heb je meerdere accounts bij dezelfde dienst, dan bevraagt hij ze allemaal, tenzij je er een noemt |
Je roept deze tools niet zelf aan. Je stelt een vraag in gewone taal en de assistent kiest de tools en de zoekopdrachten.
De cijfers komen uit dezelfde gegevens als je rapporten. Vraag de assistent om de regels uit je rapportinstellingen toe te passen, bijvoorbeeld door geannuleerde bestellingen uit te sluiten, zodat hij precies op je cijfers uitkomt.
Voorbeeldvragen
- Wat was mijn omzet in september, vergeleken met september vorig jaar?
- Wat zijn mijn 10 best verkopende producten dit kwartaal, met hun omzet?
- Vergelijk mijn Meta Ads-uitgaven en mijn verkopen dag per dag over de laatste 30 dagen.
- Welke zoekopdrachten in Search Console brengen de meeste klikken naar mijn productpagina's?
- Vat de verzoeken samen die deze week op Crisp zijn binnengekomen.
De toegang afsluiten
Verwijder voor een verbinding met een account de Fullmetrix-connector in de instellingen van je client, of dat nu Claude, ChatGPT of een andere is.
Open voor een verbinding met een API-sleutel Instellingen, het tabblad API-sleutels, en klik naast de sleutel op Herroepen. De client verliest direct de toegang.