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

• Het Pro-plan — MCP gebruikt dezelfde toegang als de REST API.
• Een API-sleutel (Settings → API-sleutels) met de scopes die je de assistent wilt geven. We raden aan om alleen-lezen te starten (events:read, templates:read, locations:read, emails:read, stats:read) en pas events:write of emails:write toe te voegen op een aparte sleutel zodra je vertrouwd bent met hoe de assistent werkt.
• Een MCP-client die een Authorization-header kan meesturen. Aanmelden via OAuth wordt nog niet ondersteund, dus de sleutel reist mee als bearer-token: Authorization: Bearer ctk_live_….

De gebruikelijke API-limiet (100 requests per minuut per sleutel) geldt ook voor MCP-oproepen.

Instellen

Claude Code

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?".

Claude Desktop en claude.ai

Custom connectors in claude.ai en Claude Desktop verwachten momenteel OAuth, wat Cleartix nog niet aanbiedt. Gebruik een kleine brug zoals mcp-remote, die de header voor je meestuurt, in je claude_desktop_config.json:

{
  "mcpServers": {
    "cleartix": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://cleartix.io/api/mcp",
        "--header", "Authorization: Bearer ctk_live_…"
      ]
    }
  }
}

Herstart Claude Desktop daarna. Dezelfde brug werkt voor elke andere client die enkel stdio spreekt.

Cursor

Voeg de server toe aan .cursor/mcp.json in je project (of ~/.cursor/mcp.json voor al je projecten):

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

Andere clients die Streamable HTTP-MCP-servers met eigen headers ondersteunen, stel je op dezelfde manier in: URL plus header.

Wat de assistent kan doen

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

• Evenementen: list_events, get_event, create_event, update_event, publish_event, check_event_readiness, cancel_event, delete_event
• Tickettypes & datums: set_event_ticket_types (vervangt de volledige lijst), set_event_dates
• Toegangscodes, add-ons, capaciteitspools & gates: manage_access_codes, manage_addons, manage_capacity_pools, manage_gates
• Event-e-mails: list_event_emails, set_event_email, preview_event_email, send_event_email
• Templates: list_templates, get_template, create_template, update_template, delete_template, schedule_from_template, apply_template, save_event_as_template
• Locaties: list_locations, create_location
• 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 en send_event_email — vereisen expliciete bevestiging: de assistent moet het je eerst vragen en confirm: true meegeven, zodat een vage vraag nooit per ongeluk een evenement annuleert of je deelnemers mailt. 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."

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, op een aparte sleutel die je nadien kunt 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. Roteer een sleutel meteen als hij in een chatlog, screenshot of gedeeld configuratiebestand terechtkomt, en verwijder sleutels die je niet meer gebruikt. Het auditlog toont precies wat een sleutel heeft gedaan.
4. Plak je sleutel nooit in een prompt: zet hem in de clientconfiguratie zoals hierboven.