Connecter un assistant IA (MCP)
Cleartix dispose d'un serveur MCP à l'adresse https://cleartix.io/api/mcp. MCP (Model Context Protocol) est un standard ouvert qui permet aux assistants IA comme Claude, Cursor ou vos propres agents d'utiliser des outils externes. Une fois connecté, votre assistant peut lister vos événements, préparer un brouillon à partir d'un modèle ou d'un kit de démarrage, remplir les types de billets et les dates, configurer un e-mail d'événement ou lancer le contrôle de préparation, à partir d'une simple demande en langage courant, avec les mêmes règles et limites que le tableau de bord et l'API REST.
Ce qu'il vous faut
- N'importe quel plan Cleartix : MCP est inclus dans Free, Studio et Pro. (L'API REST elle-même nécessite Studio ou Pro.)
- Un compte Cleartix membre de l'organisation. Dans claude.ai, Claude Desktop et ChatGPT, il suffit de vous connecter quand le connecteur vous le demande ; vous choisissez l'organisation et les scopes sur l'écran de consentement. Aucune clé API n'est nécessaire.
- Uniquement pour les outils en ligne de commande (Claude Code, Cursor, vos propres agents) qui ne peuvent pas ouvrir une fenêtre de connexion : une clé API (Settings → Clés API) avec les scopes que vous voulez accorder à l'assistant, envoyée sous la forme
Authorization: Bearer ctk_live_….
Quelle que soit la méthode, nous recommandons de commencer en lecture seule (events:read, templates:read, locations:read, emails:read, orders:read, attendees:read, stats:read) et d'ajouter events:write, emails:write, orders:write (remboursements, annulations de commandes et comptabilisation des virements), tickets:write (renvoi de billets) ou checkin:write (check-in et annulation de check-in) une fois que vous êtes à l'aise avec le fonctionnement de l'assistant. Cinq scopes supplémentaires débloquent les outils les plus récents : waitlist:write (consulter et nettoyer la liste d'attente d'un événement), team:write (lister, inviter, changer le rôle et retirer des membres de l'équipe, et affecter des scanners aux portes), privacy:write (exporter ou anonymiser tout ce que vous détenez sur un client), audit:read (lire le journal d'audit) et billing:read (votre plan, la consommation mensuelle d'événements et vos factures). La limite habituelle de l'API (100 requêtes par minute) s'applique aussi aux appels MCP.
Configuration
claude.ai et Claude Desktop
- Ouvrez Settings → Connectors (claude.ai) ou Settings → Connectors → Add custom connector (Claude Desktop) et choisissez Add custom connector.
- Donnez-lui un nom comme Cleartix et saisissez
https://cleartix.io/api/mcpcomme URL. Laissez l'identifiant et le secret OAuth vides, Cleartix enregistre le connecteur automatiquement. - Cliquez sur Connect. Une fenêtre Cleartix s'ouvre : connectez-vous si ce n'est pas déjà fait, choisissez l'organisation dans laquelle l'assistant peut travailler, cochez les scopes à accorder, puis Approuver.
- De retour dans Claude, activez le connecteur pour votre conversation et demandez par exemple : « Lesquels de mes événements ne sont pas encore prêts à être publiés ? ».
L'accès reste valable tant que vous l'utilisez ; après 30 jours sans utilisation, l'assistant vous demande de vous reconnecter. Vous pouvez y mettre fin à tout moment via Révoquer l'accès.
ChatGPT
Dans ChatGPT, ouvrez Settings → Connectors → Create (mode développeur), saisissez https://cleartix.io/api/mcp comme URL du serveur MCP, choisissez OAuth comme authentification et enregistrez. Le même écran de connexion et de consentement Cleartix apparaît ; approuvez-le et le connecteur est prêt à l'emploi dans vos conversations.
Claude Code
Claude Code peut se connecter de la même manière, ajoutez le serveur sans en-tête et lancez /mcp pour vous identifier :
claude mcp add --transport http cleartix https://cleartix.io/api/mcp
Si vous préférez un identifiant fixe (par exemple en CI ou sur une machine partagée), transmettez plutôt une clé API dans l'en-tête :
claude mcp add --transport http cleartix https://cleartix.io/api/mcp \
--header "Authorization: Bearer ctk_live_…"
Ouvrez une nouvelle session et demandez par exemple : « Lesquels de mes événements ne sont pas encore prêts à être publiés ? ».
Cursor et autres clients
Ajoutez le serveur dans .cursor/mcp.json de votre projet (ou ~/.cursor/mcp.json pour tous vos projets). Cursor peut se connecter via OAuth si vous omettez les en-têtes ; ajoutez le bloc headers pour utiliser une clé API à la place :
{
"mcpServers": {
"cleartix": {
"url": "https://cleartix.io/api/mcp",
"headers": { "Authorization": "Bearer ctk_live_…" }
}
}
}
Les autres clients qui prennent en charge les serveurs MCP Streamable HTTP se configurent de la même manière : URL plus, s'ils ne peuvent pas se connecter, l'en-tête Authorization. Les clients qui ne parlent que stdio peuvent passer par une passerelle comme mcp-remote.
Ce que l'assistant peut faire
Chaque outil exige le scope correspondant, ceux cochés sur l'écran de consentement ou accordés à la clé API ; les outils pour lesquels vous n'avez rien accordé ne sont tout simplement pas disponibles pour l'assistant. Toutes les actions restent limitées à l'organisation que vous avez approuvée, et chaque modification est consignée dans le journal d'audit avec l'assistant ou la clé utilisée.
- Événements :
list_events,get_event,create_event,update_event,publish_event,unpublish_event(retire un événement de la vente, tant que personne n'a commandé),check_event_readiness,cancel_event,delete_event,get_upload_url(l'assistant récupère une URL d'envoi à courte durée de vie, téléverse lui-même l'image, puis l'associe à l'événement ou au modèle) - Types de billets & dates :
list_ticket_types,create_ticket_type,update_ticket_type,delete_ticket_type,reorder_ticket_types,set_event_dates(remplace la liste complète des dates) - Codes d'accès, options, pools de capacité & portes :
list_/create_/update_/delete_access_code(s),…_addon(s),…_capacity_pool(s),…_gate(s),get_live_gate_counts - Codes de réduction :
list_discount_codes(tous les codes, ou seulement ceux utilisables sur un événement),get_discount_code,create_discount_code,update_discount_code(active ou désactive aussi un code),delete_discount_code, voir Codes de réduction - E-mails d'événement :
list_event_emails,set_event_email,preview_event_email,send_event_email - Mise en page du billet (Studio/Pro) :
get_ticket_layout,set_ticket_layout,get_event_ticket_layout,set_event_ticket_layout(sponsors ou publicité dans le tiers inférieur des billets PDF, voir Sponsors et publicité sur vos billets) - Modèles :
list_templates,get_template,create_template,update_template,delete_template,schedule_from_template(avecdryRun: true, il montre seulement les dates prévues et le contrôle du plafond mensuel, sans rien créer),apply_template,save_event_as_template - Commandes & ventes :
list_orders(filtre par événement, statut, mode de paiement, e-mail de l'acheteur, texte libre ou période),get_order(y compris la communication ou le numéro de facture avec lequel l'acheteur doit payer),get_event_sales(billets vendus, check-ins et chiffre d'affaires par type de billet, sans données de participants),refund_order,cancel_order(uniquement pour les paiements en ligne encore ouverts) - Rapprochement des virements :
match_bank_transactions(confronte les paiements entrants d'un extrait de compte, retranscrits d'une capture d'écran, d'un PDF ou d'un export CSV, aux commandes en attente d'un virement ou du paiement d'une facture et propose une commande par ligne, sans rien comptabiliser),mark_orders_paid(comptabilise jusqu'à 50 commandes approuvées comme payées en une fois et envoie les billets),mark_order_paid(une seule commande). Voir Comptabiliser les virements. - Participants & billets :
list_attendees,find_tickets(recherche support par e-mail, nom, identifiant de billet ou de commande sur tous les événements),resend_ticket(régénère les billets et renvoie la confirmation à l'acheteur) - Billets invités & transferts :
issue_guest_tickets(billets gratuits pour la presse, les sponsors, les VIP ou les bénévoles, une commande à 0 € qui consomme de la capacité comme une vente et envoie les billets par e-mail),update_ticket_holder(modifie les données de participant d'un billet),transfer_ticket(transmet un billet à quelqu'un d'autre : nouveau code QR, le destinataire reçoit un lien pour l'accepter) - Check-in :
get_ticket_status(si un billet peut être scanné, avec son historique de scans),check_in_ticket,undo_check_in - Confidentialité (RGPD) :
export_customer_data(tout ce que vous détenez sur une adresse e-mail, pour une demande d'accès),anonymize_customer(efface de manière irréversible l'identité de la personne des commandes, billets, passes et consentements, pour une demande d'effacement) - Liste d'attente :
list_waitlist,remove_waitlist_entry - Équipe & scanners :
list_team,invite_member,update_member_role,remove_member,revoke_invite,resend_invite,assign_scanner_to_gate,unassign_scanner_from_gate - Audit & facturation :
list_audit_log(qui a modifié quoi et quand, y compris ce que les assistants et les intégrations API ont changé),get_billing_status(votre plan, le plafond mensuel d'événements et la part déjà utilisée),list_invoices - Boutique (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, pour les catégories de produits, l'ordre du catalogue et les paramètres de la boutique (ouverte ou fermée, textes, affichage des catégories, image d'en-tête) ; les widgets, y compris les widgets boutique, vialist_widgets,get_widget,create_widget,update_widget,delete_widget - Lieux :
list_locations,create_location - Images :
import_image(Cleartix télécharge une URL d'image publique et la stocke, pour l'image d'en-tête ou pour des nœudsimagedans la description, avecwidthetalignpour la mise en page),get_upload_url - Kits de démarrage :
list_starter_kits,create_event_from_starter_kit - Aide pour l'assistant :
describe_event_optionsexplique chaque champ et les fonctionnalités que votre plan autorise, pour que l'assistant n'essaie pas d'utiliser quelque chose que votre abonnement n'inclut pas.
Les outils destructifs, 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 et remove_member, exigent une confirmation explicite : l'assistant doit d'abord vous demander et transmettre confirm: true, si bien qu'une demande vague ne peut jamais annuler un événement, rembourser de l'argent ou écrire à vos participants par accident. Les remboursements sont enregistrés au nom de la personne qui les a demandés : refund_order ne fonctionne donc que si l'assistant s'est connecté via le connecteur (OAuth) ; avec une simple clé API, le remboursement est refusé et vous le traitez dans le tableau de bord. Les erreurs portent les mêmes codes que l'API (par exemple EVENT_LIMIT_REACHED), pour que l'assistant puisse expliquer le problème et proposer une solution.
Exemples de demandes
- « Crée un brouillon pour notre soirée quiz du 14 novembre à partir du kit de démarrage quiz et montre-moi le contrôle de préparation. »
- « Planifie le modèle "Yoga du mardi" tous les mardis d'octobre à 19h00. »
- « Quels événements à venir ont moins de 20 billets vendus ? »
- « Ajoute un type de billet early bird à 12 € au concert de printemps, limité à 50 billets. »
- « Configure l'e-mail de rappel du marché d'hiver pour qu'il mentionne le parking gratuit, puis montre-moi un aperçu. »
- « La commande 1234 a-t-elle été payée ? Renvoie les billets à l'acheteur. »
- « Combien de billets la soirée quiz a-t-elle vendus par type ? »
- « Voici une capture de mon extrait de compte : comptabilise les virements, mais montre-moi d'abord ce que tu veux comptabiliser. »
- « Enregistre l'arrivée du billet de Jan Peeters à l'entrée. »
- « Donne aux 3 sponsors de cette liste un billet VIP gratuit chacun et envoie-les-leur. »
- « Exporte tout ce que nous détenons sur jan@example.be pour une demande RGPD. »
Quoi que l'assistant propose, rien ne se passe tant que l'outil n'est pas exécuté. Vous pouvez toujours lui demander d'abord le plan.
Rester en sécurité
- Privilégiez les scopes de lecture. N'accordez un scope d'écriture que pour la tâche en cours ; vous pourrez révoquer l'accès (ou supprimer la clé) ensuite.
- Relisez avant de publier. Laissez l'assistant créer des brouillons, vérifiez-les dans le tableau de bord et publiez vous-même, ou demandez d'abord le contrôle de préparation.
- Révoquez les accès que vous n'utilisez plus, et renouvelez immédiatement une clé API qui se retrouve dans un historique de conversation, une capture d'écran ou un fichier de configuration partagé. Le journal d'audit montre exactement ce qu'un assistant a fait.
- Ne collez jamais une clé API dans une demande : connectez-vous via le connecteur, ou placez la clé dans la configuration du client, comme ci-dessus.
Révoquer l'accès
Chaque assistant connecté via le flux de connecteur figure sous Settings → API → Assistants IA connectés, avec la personne qui a accordé l'accès, ses scopes et sa dernière utilisation. Cliquez sur Révoquer pour mettre fin à son accès immédiatement, l'assistant devra se reconnecter et être approuvé à nouveau. Les autorisations apparaissent aussi dans le journal d'audit, à l'approbation comme à la révocation.
Les assistants qui utilisent une clé API se gèrent sous Settings → Clés API : supprimez ou renouvelez la clé à cet endroit.
À noter : MCP est disponible sur tous les plans et utilise les mêmes scopes et la même limite que l'API REST (qui, elle, nécessite Studio ou Pro). Les assistants hébergés (claude.ai, Claude Desktop, ChatGPT) se connectent avec votre compte Cleartix ; les outils en ligne de commande peuvent toujours utiliser une clé API dans l'en-tête Authorization.
Dernière mise à jour: 11 novembre 2026