MCP-koppeling

Laat je AI-assistent je verkoopcijfers zelf opvragen. Je stelt het adres één keer in, en daarna kun je gewoon vragen stellen zonder dat iemand de aanroepen hoeft te schrijven.

Wat het is

Model Context Protocol is een open standaard waarmee een AI-assistent kan ontdekken welke gegevens een systeem aanbiedt, en die kan opvragen. Claude, ChatGPT, Copilot en de meeste ontwikkeltools ondersteunen het.

Voor jou betekent het: je hoeft geen koppeling te bouwen. Je zet ons adres in de instellingen van je assistent, en die weet daarna zelf welke vragen hij aan Avayo kan stellen.

Instellen

POST https://jouwshop.avayo.nl/mcp

De meeste clients werken met een configuratiebestand. In Claude Desktop bijvoorbeeld:

Configuratie

{
  "mcpServers": {
    "avayo": {
      "url": "https://jouwshop.avayo.nl/mcp",
      "headers": { "Authorization": "Bearer JOUW_TOKEN" }
    }
  }
}

Vervang jouwshop door het adres van je eigen ticketshop en JOUW_TOKEN door een token uit Instellingen > API-tokens. Werkt je shop op een eigen domein, gebruik dat dan; het token bepaalt om welk account het gaat.

Maak een apart token aan

Geef de koppeling een eigen token met een omschrijving als "AI-assistent", en vink alleen Verkoopcijfers opvragen aan. Meer heeft je assistent niet nodig. Dan zie je in het overzicht wanneer hij voor het laatst gebruikt is, en kun je hem intrekken zonder je andere koppelingen stil te leggen.

Wat je assistent dan kan

Gereedschap	Waar het voor is
get_sales	Omzet, bestellingen en tickets over een periode, uitgesplitst naar campagne, kanaal, product, evenement of tijd.
get_sales_curve	Het verkoopverloop van een evenement tegen de eventdatum, zodat deze editie naast de vorige te leggen is.
get_attendance	Verkocht tegenover gescand, met het no-showpercentage.
get_availability	Hoe vol elke voorstelling zit: capaciteit, verkocht, vrij en bezettingsgraad. Bij vrije verkoop is er geen capaciteit om tegen af te zetten; die voorstellingen geven leeg terug, geen nul.
list_dimensions	Welke uitsplitsingen er zijn. Je assistent gebruikt dit zelf om te weten wat er kan.

Vragen die daarmee te beantwoorden zijn

Je hoeft geen veldnamen te kennen. Dit werkt gewoon:

Voorbeelden

Waar kwamen mijn kopers vorige maand vandaan?
Loop ik voor of achter op vorig jaar voor het zomerfestival?
Welk verkoopkanaal heeft de meeste no-shows?
Hoeveel omzet per ticketsoort in het derde kwartaal?
Welke voorstellingen zijn bijna vol en welke blijven achter?

Wat je assistent wel en niet ziet

Alleen totalen, geen klantgegevens

De gereedschappen geven groepen en optellingen terug: aantallen, omzet, percentages. Er gaan nooit rijen met namen, e-mailadressen of adressen naar je assistent toe. Dat is met opzet, want die gegevens zouden daarmee bij een andere partij terechtkomen.

Verder geldt: alleen lezen. Er is geen gereedschap waarmee een assistent iets kan wijzigen, aanmaken of verwijderen. En alles blijft binnen je eigen account, want dat ligt vast in het token.

Wil je stoppen, trek het token dan in onder Instellingen > API-tokens. De koppeling werkt vanaf dat moment direct niet meer.

Goed om te weten

Lees het meta-blok	Elk antwoord vertelt op welke datum gerekend is, in welke tijdzone en in welke eenheid. Vraag je assistent daarnaar als een getal je verrast.
Grenzen	Dezelfde als de API: maximaal 731 dagen per vraag, drie uitsplitsingen tegelijk. Vraagt je assistent te veel, dan krijgt hij een uitleg terug en kan hij het opnieuw proberen.
Vertrouw niet blind	Een assistent kan een getal verkeerd uitleggen. De cijfers komen uit dezelfde bron als je backoffice, dus bij twijfel kun je het daar naast leggen.

Wil je liever zelf de aanroepen doen, dan kan dat ook: dezelfde gegevens staan op Analytics API.