FreeStudioPro

Een AI-assistent koppelen (MCP)

Cleartix heeft een MCP-server op https://cleartix.io/api/mcp. MCP (Model Context Protocol) is een open standaard waarmee AI-assistenten zoals Claude, Cursor of je eigen agents externe tools kunnen gebruiken. Eenmaal gekoppeld kan je assistent je evenementen opvragen, een nieuw concept maken op basis van een template of starterkit, tickettypes en datums invullen, een event-e-mail instellen of de readiness-check uitvoeren, vanuit een gewone vraag in mensentaal, met dezelfde regels en limieten als het dashboard en de REST API.

Wat je nodig hebt

  • Eender welk Cleartix-plan: MCP zit inbegrepen in Free, Studio en Pro. (De REST API zelf vereist Studio of Pro.)
  • Een Cleartix-account dat lid is van de organisatie. In claude.ai, Claude Desktop en ChatGPT meld je je gewoon aan wanneer de connector daarom vraagt; je kiest de organisatie en de scopes op het toestemmingsscherm. Een API-sleutel is niet nodig.
  • Enkel voor commandoregeltools (Claude Code, Cursor, eigen agents) die geen aanmeldvenster kunnen openen: een API-sleutel (Settings → API-sleutels) met de scopes die je de assistent wilt geven, meegestuurd als Authorization: Bearer ctk_live_….

Hoe je ook koppelt, we raden aan om alleen-lezen te starten (events:read, templates:read, locations:read, emails:read, orders:read, attendees:read, stats:read) en pas events:write, emails:write, orders:write (terugbetalingen, bestellingen annuleren en overschrijvingen als betaald boeken), tickets:write (tickets opnieuw versturen) of checkin:write (inchecken en check-ins ongedaan maken) toe te voegen zodra je vertrouwd bent met hoe de assistent werkt. Vijf extra scopes ontgrendelen de nieuwere tools: waitlist:write (de wachtlijst van een evenement bekijken en opschonen), team:write (teamleden opvragen, uitnodigen, van rol veranderen en verwijderen, en scanners aan gates toewijzen), privacy:write (alles wat je over een klant bewaart exporteren of anonimiseren), audit:read (de auditlog lezen) en billing:read (je plan, het maandelijkse eventverbruik en je facturen). De gebruikelijke API-limiet (100 requests per minuut) geldt ook voor MCP-oproepen.

Instellen

claude.ai en Claude Desktop

  1. Open Settings → Connectors (claude.ai) of Settings → Connectors → Add custom connector (Claude Desktop) en kies Add custom connector.
  2. Geef hem een naam zoals Cleartix en vul https://cleartix.io/api/mcp in als URL. Laat OAuth client ID en secret leeg, Cleartix registreert de connector automatisch.
  3. Klik op Connect. Er opent een Cleartix-venster: meld je aan als dat nog niet zo is, kies de organisatie waarin de assistent mag werken, vink de scopes aan die je wilt toekennen en klik op Goedkeuren.
  4. Terug in Claude schakel je de connector in voor je chat en vraag je bijvoorbeeld: "Welke van mijn evenementen zijn nog niet klaar om te publiceren?".

De toegang blijft geldig zolang je ze gebruikt; na 30 dagen zonder gebruik vraagt de assistent je opnieuw om aan te melden. Je kunt ze op elk moment beëindigen onder Toegang intrekken.

ChatGPT

Open in ChatGPT Settings → Connectors → Create (developer mode), vul https://cleartix.io/api/mcp in als MCP-server-URL, kies OAuth als authenticatie en sla op. Hetzelfde Cleartix-aanmeld- en toestemmingsscherm verschijnt; keur het goed en de connector is klaar voor gebruik in je chats.

Claude Code

Claude Code kan zich op dezelfde manier aanmelden, voeg de server toe zonder header en voer /mcp uit om in te loggen:

claude mcp add --transport http cleartix https://cleartix.io/api/mcp

Verkies je een vaste credential (bijvoorbeeld in CI of op een gedeelde machine), geef dan een API-sleutel mee als header:

claude mcp add --transport http cleartix https://cleartix.io/api/mcp \
  --header "Authorization: Bearer ctk_live_…"

Start een nieuwe sessie en vraag bijvoorbeeld: "Welke van mijn evenementen zijn nog niet klaar om te publiceren?".

Cursor en andere clients

Voeg de server toe aan .cursor/mcp.json in je project (of ~/.cursor/mcp.json voor al je projecten). Cursor kan zich via OAuth aanmelden als je de headers weglaat; voeg het headers-blok toe om in plaats daarvan een API-sleutel te gebruiken:

{
  "mcpServers": {
    "cleartix": {
      "url": "https://cleartix.io/api/mcp",
      "headers": { "Authorization": "Bearer ctk_live_…" }
    }
  }
}

Andere clients die Streamable HTTP-MCP-servers ondersteunen, stel je op dezelfde manier in: URL plus, als ze zich niet kunnen aanmelden, de Authorization-header. Clients die enkel stdio spreken, kunnen een brug zoals mcp-remote gebruiken.

Wat de assistent kan doen

Elke tool vereist de bijbehorende scope, die je aanvinkte op het toestemmingsscherm of aan de API-sleutel gaf; tools waarvoor je geen scope hebt gegeven, zijn simpelweg niet beschikbaar voor de assistent. Alle acties blijven beperkt tot de organisatie die je goedkeurde, en elke wijziging wordt in het auditlog vastgelegd met de assistent of sleutel die ze uitvoerde.

  • Evenementen: list_events, get_event, create_event, update_event, publish_event, unpublish_event (haalt een evenement weer uit de verkoop, zolang niemand besteld heeft), check_event_readiness, cancel_event, delete_event, get_upload_url (de assistent vraagt een kortstondige upload-URL op, uploadt de afbeelding zelf en koppelt ze daarna aan het evenement of de template)
  • Tickettypes & datums: list_ticket_types, create_ticket_type, update_ticket_type, delete_ticket_type, reorder_ticket_types, set_event_dates (vervangt de volledige lijst datums)
  • Toegangscodes, add-ons, capaciteitspools & gates: list_/create_/update_/delete_access_code(s), …_addon(s), …_capacity_pool(s), …_gate(s), get_live_gate_counts
  • Kortingscodes: list_discount_codes (alle codes, of alleen die bruikbaar zijn op één evenement), get_discount_code, create_discount_code, update_discount_code (zet een code ook aan of uit), delete_discount_code, zie Kortingscodes
  • Event-e-mails: list_event_emails, set_event_email, preview_event_email, send_event_email
  • Ticketlayout (Studio/Pro): get_ticket_layout, set_ticket_layout, get_event_ticket_layout, set_event_ticket_layout (sponsors of reclame in het onderste derde van PDF-tickets, zie Sponsors en reclame op je tickets)
  • Templates: list_templates, get_template, create_template, update_template, delete_template, schedule_from_template (met dryRun: true toont hij enkel de geplande datums en de controle op de maandlimiet, zonder iets aan te maken), apply_template, save_event_as_template
  • Bestellingen & verkoop: list_orders (filteren op evenement, status, betaalmethode, e-mail van de koper, vrije tekst of periode), get_order (inclusief de mededeling of het factuurnummer waarmee de koper moet betalen), get_event_sales (verkochte tickets, check-ins en omzet per tickettype, zonder deelnemersgegevens), refund_order, cancel_order (enkel voor online betalingen die nog openstaan)
  • Overschrijvingen afpunten: match_bank_transactions (legt de inkomende betalingen van een rekeninguittreksel, overgetikt van een screenshot, PDF of CSV-export, naast de bestellingen die op een overschrijving of factuurbetaling wachten en stelt per lijn een bestelling voor, zonder iets te boeken), mark_orders_paid (boekt tot 50 goedgekeurde bestellingen in één keer als betaald en verstuurt de tickets), mark_order_paid (één bestelling). Zie Overschrijvingen boeken.
  • Deelnemers & tickets: list_attendees, find_tickets (support-opzoeking op e-mail, naam, ticket- of bestel-ID over alle evenementen heen), resend_ticket (maakt de tickets opnieuw aan en mailt de bevestiging opnieuw naar de koper)
  • Gasttickets & overdrachten: issue_guest_tickets (gratis tickets voor pers, sponsors, vips of vrijwilligers, een bestelling van € 0 die capaciteit verbruikt zoals een verkoop en de tickets mailt), update_ticket_holder (past de deelnemersgegevens op een ticket aan), transfer_ticket (draagt een ticket over aan iemand anders: nieuwe QR-code, de ontvanger krijgt een link om het te aanvaarden)
  • Check-in: get_ticket_status (of een ticket gescand kan worden, plus de scanhistoriek), check_in_ticket, undo_check_in
  • Privacy (GDPR): export_customer_data (alles wat je over een e-mailadres bewaart, voor een inzageverzoek), anonymize_customer (wist onomkeerbaar de identiteit van de persoon uit bestellingen, tickets, passes en toestemmingen, voor een verzoek tot wissing)
  • Wachtlijst: list_waitlist, remove_waitlist_entry
  • Team & scanners: list_team, invite_member, update_member_role, remove_member, revoke_invite, resend_invite, assign_scanner_to_gate, unassign_scanner_from_gate
  • Audit & facturatie: list_audit_log (wie wat wanneer wijzigde, ook wat assistenten en API-integraties hebben gewijzigd), get_billing_status (je plan, de maandelijkse eventlimiet en hoeveel ervan al gebruikt is), list_invoices
  • Shop (Studio/Pro): list_products, create_product, update_product, delete_product, add_product_image, remove_product_image, list_shipping_methods, create_shipping_method, update_shipping_method, delete_shipping_method, list_shipments, mark_order_shipped, get_product_sales , get_product, reorder_products, reorder_product_images, get_product_file_upload_url, attach_product_file, list_product_categories, create_product_category, update_product_category, delete_product_category, reorder_product_categories, get_shop_settings, update_shop_settings, set_shop_header_image, voor productcategorieën, de volgorde van de catalogus en de shopinstellingen (open of dicht, teksten, weergave categorieën, headerafbeelding); widgets, ook shopwidgets, via list_widgets, get_widget, create_widget, update_widget, delete_widget
  • Locaties: list_locations, create_location
  • Afbeeldingen: import_image (Cleartix haalt een publieke afbeeldings-URL op en slaat ze op, voor de hoofdafbeelding of voor image-nodes in de beschrijving, met width en align voor de layout), get_upload_url
  • Starterkits: list_starter_kits, create_event_from_starter_kit
  • Hulp voor de assistent: describe_event_options legt elk veld uit en welke functies je abonnement toelaat, zodat de assistent niet iets probeert dat niet in je plan zit.

Destructieve tools: cancel_event, delete_event, delete_template, send_event_email, refund_order, cancel_order, mark_order_paid, mark_orders_paid, undo_check_in, issue_guest_tickets, transfer_ticket, anonymize_customer, remove_waitlist_entry en remove_member, vereisen expliciete bevestiging: de assistent moet het je eerst vragen en confirm: true meegeven, zodat een vage vraag nooit per ongeluk een evenement annuleert, geld terugbetaalt of je deelnemers mailt. Terugbetalingen worden geregistreerd op naam van wie ze aanvroeg, dus refund_order werkt alleen als de assistent zich via de connector (OAuth) heeft aangemeld; met een gewone API-sleutel wordt de terugbetaling geweigerd en regel je ze in het dashboard. Fouten dragen dezelfde codes als de API (bijvoorbeeld EVENT_LIMIT_REACHED), zodat de assistent kan uitleggen wat er misging en een oplossing kan voorstellen.

Voorbeeldvragen

  • "Maak een concept voor onze quizavond op 14 november op basis van de quiz-starterkit en toon me de readiness-check."
  • "Plan de template 'Yoga op dinsdag' voor elke dinsdag van oktober om 19:00."
  • "Welke komende evenementen hebben minder dan 20 tickets verkocht?"
  • "Voeg een early-bird-tickettype van € 12 toe aan het lenteconcert, beperkt tot 50 tickets."
  • "Stel de herinneringsmail van de wintermarkt zo in dat ze het gratis parkeren vermeldt, en toon me een preview."
  • "Is bestelling 1234 betaald? Stuur de tickets opnieuw naar de koper."
  • "Hoeveel tickets heeft de quizavond per type verkocht?"
  • "Hier is een screenshot van mijn rekeninguittreksel: punt de overschrijvingen af en toon me eerst wat je wilt boeken."
  • "Check het ticket van Jan Peeters in aan de deur."
  • "Geef de 3 sponsors op deze lijst elk een gratis vip-ticket en stuur ze op."
  • "Exporteer alles wat we over jan@example.be bewaren voor een GDPR-verzoek."

Wat de assistent ook voorstelt, het gebeurt pas als de tool effectief draait. Je kunt altijd eerst om het plan vragen.

Veilig blijven

  1. Kies liefst leesscopes. Geef de assistent enkel een write-scope voor de taak van dat moment; nadien kun je de toegang intrekken (of de sleutel verwijderen).
  2. Controleer voor je publiceert. Laat de assistent evenementen als concept achterlaten, bekijk ze in het dashboard en publiceer zelf, of vraag eerst de readiness-check.
  3. Trek toegang in die je niet meer gebruikt, en roteer een API-sleutel meteen als hij in een chatlog, screenshot of gedeeld configuratiebestand terechtkomt. Het auditlog toont precies wat een assistent heeft gedaan.
  4. Plak nooit een API-sleutel in een prompt: meld je aan via de connector, of zet de sleutel in de clientconfiguratie zoals hierboven.

Toegang intrekken

Elke assistent die zich via de connector-flow heeft aangemeld, staat onder Settings → API → Gekoppelde AI-assistenten, met wie de toegang gaf, de scopes en wanneer ze het laatst gebruikt werd. Klik op Intrekken om de toegang onmiddellijk te beëindigen, de assistent moet zich dan opnieuw aanmelden en goedgekeurd worden. Toekenningen verschijnen ook in het auditlog, zowel bij goedkeuring als bij intrekking.

Assistenten die een API-sleutel gebruiken, beheer je onder Settings → API-sleutels: verwijder of roteer daar de sleutel.

Let op: MCP is beschikbaar op elk plan en gebruikt dezelfde scopes en limiet als de REST API (die zelf Studio of Pro vereist). Gehoste assistenten (claude.ai, Claude Desktop, ChatGPT) melden zich aan met je Cleartix-account; commandoregeltools kunnen nog steeds een API-sleutel als Authorization-header gebruiken.

Laatst bijgewerkt: 11 november 2026

Klaar om te starten?

Maak gratis een ClearTix-account aan en verkoop vandaag nog je eerste tickets.

Een AI-assistent koppelen (MCP) | Helpcentrum