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

• Le plan Pro — MCP utilise le même accès que l'API REST.
• Une clé API (Settings → Clés API) avec les scopes que vous voulez accorder à l'assistant. Nous recommandons de commencer en lecture seule (events:read, templates:read, locations:read, emails:read, stats:read) et d'ajouter events:write ou emails:write sur une clé distincte une fois que vous êtes à l'aise avec le fonctionnement de l'assistant.
• Un client MCP capable d'envoyer un en-tête Authorization. La connexion via OAuth n'est pas encore prise en charge : la clé voyage donc comme jeton bearer, Authorization: Bearer ctk_live_….

La limite habituelle de l'API (100 requêtes par minute et par clé) s'applique aussi aux appels MCP.

Configuration

Claude Code

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

Claude Desktop et claude.ai

Les connecteurs personnalisés de claude.ai et de Claude Desktop attendent actuellement OAuth, que Cleartix ne propose pas encore. Utilisez une petite passerelle comme mcp-remote, qui envoie l'en-tête à votre place, dans votre claude_desktop_config.json :

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

Redémarrez ensuite Claude Desktop. La même passerelle fonctionne pour tout autre client qui ne parle que stdio.

Cursor

Ajoutez le serveur dans .cursor/mcp.json de votre projet (ou ~/.cursor/mcp.json pour tous vos projets) :

{
  "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 avec en-têtes personnalisés se configurent de la même manière : URL plus en-tête.

Ce que l'assistant peut faire

Chaque outil exige le scope correspondant sur votre clé ; les outils pour lesquels vous n'avez rien accordé ne sont tout simplement pas disponibles pour l'assistant. Toutes les actions restent limitées à votre organisation, et chaque modification est consignée dans le journal d'audit avec le préfixe de la clé utilisée.

• Événements : list_events, get_event, create_event, update_event, publish_event, check_event_readiness, cancel_event, delete_event
• Types de billets & dates : set_event_ticket_types (remplace la liste complète), set_event_dates
• Codes d'accès, options, pools de capacité & portes : manage_access_codes, manage_addons, manage_capacity_pools, manage_gates
• E-mails d'événement : list_event_emails, set_event_email, preview_event_email, send_event_email
• Modèles : list_templates, get_template, create_template, update_template, delete_template, schedule_from_template, apply_template, save_event_as_template
• Lieux : list_locations, create_location
• Kits de démarrage : list_starter_kits, create_event_from_starter_kit
• Aide pour l'assistant : describe_event_options explique 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 et send_event_email — 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 ou écrire à vos participants par accident. 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. »

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é

1. Privilégiez les scopes de lecture. N'accordez un scope d'écriture que pour la tâche en cours, sur une clé distincte que vous pourrez supprimer ensuite.
2. 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.
3. Renouvelez immédiatement une clé qui se retrouve dans un historique de conversation, une capture d'écran ou un fichier de configuration partagé, et supprimez les clés inutilisées. Le journal d'audit montre exactement ce qu'une clé a fait.
4. Ne collez jamais votre clé dans une demande : placez-la dans la configuration du client, comme ci-dessus.