AttendBeacon gebruiken met je AI-assistent

#Wat het is

Het Model Context Protocol (MCP) is de manier waarop AI-assistenten de tools van andere software gebruiken. Met de MCP-server van AttendBeacon kan een assistent je evenementen lezen en, als je dat toestaat, een paar veilige wijzigingen doen, met dezelfde sleutels, scopes, limieten en hetzelfde logboek als de REST API.

Het adres: https://attendbeacon.com/mcp (Streamable HTTP)

Eenmaal gekoppeld vraag je in je eigen woorden:

• "Hoe verkoopt Beacon Summit vergeleken met vorige week, en wanneer zijn we in dit tempo uitverkocht?"
• "Wie van Contoso komt er, en zijn ze al ingecheckt?"
• "Wat is er donderdagmiddag in de Main Hall?"
• "Welke sprekers brachten met hun deellinks de meeste tickets binnen?"
• "Voeg een sessie van 30 minuten 'Lightning talks' toe in Room 2 op 13 november om 14:00." (vraagt het eerst voordat er iets verandert)

#Twee manieren om te koppelen

Inloggen (custom connectors van Claude, ChatGPT, Copilot Studio met OAuth): de assistent stuurt je naar AttendBeacon, je logt in als jezelf, kiest de werkruimte en wat de assistent mag, en geeft toestemming. AttendBeacon maakt een sleutel voor die assistent, die je ziet en kunt intrekken onder Integraties › API & MCP.

Een sleutel (Claude Code, VS Code, Copilot Studio met een API-sleutel, en elke andere client): maak een sleutel onder Integraties › API & MCP, begin met AI-assistent (alleen lezen) en geef hem aan de client als Authorization: Bearer abk_... of als X-Api-Key.

Hoe dan ook: een assistent kan niet meer dan de scopes van zijn sleutel toestaan. Begin met alleen lezen; voeg een schrijfscope toe (zoals tickets:write voor kortingscodes) alleen voor wat je hem wilt laten doen.

#Claude

Claude op het web en Claude Desktop (custom connector):

1. Open Settings › Connectors en kies Add custom connector. (Bij een Team- of Enterprise-abonnement voegt een eigenaar hem eerst toe onder Organization settings › Connectors.)
2. Noem hem AttendBeacon en geef het adres https://attendbeacon.com/mcp. Laat de geavanceerde instellingen leeg.
3. Kies Connect, log in bij AttendBeacon, kies de werkruimte en de scopes, en geef toestemming.
4. Zet AttendBeacon in een chat aan in het menu met tools, en stel je vraag.

Claude Code, met een sleutel:

claude mcp add --transport http attendbeacon https://attendbeacon.com/mcp \
  --header "Authorization: Bearer $ATTENDBEACON_KEY"

Of voeg hem toe zonder de header en voer /mcp uit in Claude Code om in plaats daarvan in te loggen.

#ChatGPT

1. Open in ChatGPT Settings › Apps & Connectors en zet onder Advanced settings de Developer mode aan (je abonnement en de beheerder van je werkruimte moeten custom connectors toestaan).
2. Kies Create, noem hem AttendBeacon, geef als adres van de MCP-server https://attendbeacon.com/mcp en kies OAuth als authenticatie.
3. Log in bij AttendBeacon, kies de werkruimte en de scopes, en geef toestemming.
4. Voeg AttendBeacon in een chat toe vanuit het menu met tools.

ChatGPT vraagt om bevestiging vóór elke tool die gegevens wijzigt.

#VS Code en GitHub Copilot

Voeg de server toe aan .vscode/mcp.json in je project (of aan je gebruikersinstellingen). VS Code vraagt één keer om de sleutel en bewaart hem in zijn geheimenopslag:

{
  "inputs": [
    { "type": "promptString", "id": "attendbeacon-key", "description": "AttendBeacon API key", "password": true }
  ],
  "servers": {
    "attendbeacon": {
      "type": "http",
      "url": "https://attendbeacon.com/mcp",
      "headers": { "Authorization": "Bearer ${input:attendbeacon-key}" }
    }
  }
}

Open Copilot Chat in de modus Agent; de tools van AttendBeacon staan onder de knop voor tools.

#Copilot Studio

1. Open in je agent Tools › Add a tool › New tool › Model Context Protocol.
2. Geef als servernaam AttendBeacon, een beschrijving ("Leest en wijzigt onze AttendBeacon-evenementen") en als server-URL https://attendbeacon.com/mcp.
3. Kies als authenticatie API key, type Header, headernaam X-Api-Key. (Of OAuth 2.0 met dynamic discovery, om in plaats daarvan in te loggen.)
4. Maak de verbinding met je sleutel en voeg de tools toe aan de agent.

#Andere clients

Cursor, Windsurf, Gemini CLI en elke client die Streamable HTTP spreekt, koppelen op dezelfde manier: het adres, en de sleutel als header, of het inloggen als de client OAuth ondersteunt.

#De tools

Elke tool antwoordt met compacte JSON in één tekstblok, en de lijsten antwoorden met een pagina en nextCursor om meer op te vragen. Tijden komen in UTC en in de plaatselijke tijd van de locatie, bedragen in de valuta van het evenement.

Tools die gegevens wijzigen, beginnen hun beschrijving met CHANGES DATA en zijn gemarkeerd als niet alleen-lezen, zodat assistenten het je vragen voordat ze ze aanroepen. Geen enkele tool verwijdert iets: een evenement wordt als concept gemaakt, een capaciteit wordt nooit lager gezet dan wat er verkocht is, en een check-in volgt de regels van de deur.

#Wat je in de werkruimte ziet

• Integraties › API & MCP › Activiteit van sleutels toont elke aanroep van een tool, met mcp als kanaal en de naam van de tool, ook de geweigerde, met de reden.
• Wijzigingen staan in het activiteitenoverzicht van de werkruimte als "API key abk_... (naam) via MCP".
• Trek de sleutel of de gekoppelde app in, en de assistent stopt meteen.

#Als iets wordt geweigerd

De tool antwoordt met een fout waarvan de tekst begint met de code van de API, zodat de assistent je kan vertellen wat je moet doen:

• missingScope: de sleutel mist een scope; maak een sleutel die hem wel heeft.
• peopleScope: de vraag gaat over mensen bij naam; de sleutel heeft Persoonsgegevens nodig.
• moduleOff: de organisator heeft die functie voor het evenement uitgezet.
• rateLimited: meer dan 120 aanroepen per minuut, gedeeld met de REST API.

#Voor wie het wil weten

De server is die van de officiële C# SDK, via Streamable HTTP, stateless: elk verzoek staat op zichzelf, dus elke server van AttendBeacon kan het beantwoorden. Hij biedt tools en drie prompts (event_briefing, door_status, sales_update); hij vraagt de client niets terug. Het inloggen is OAuth 2.1 met PKCE en dynamische clientregistratie, zoals de autorisatiespecificatie van MCP beschrijft, aangekondigd op /.well-known/oauth-protected-resource.