Intégrations

Utiliser AttendBeacon avec votre assistant IA

Connectez Claude, ChatGPT, GitHub Copilot ou Copilot Studio à votre espace de travail via le serveur MCP d’AttendBeacon, et posez vos questions sur vos événements avec vos propres mots.

De quoi s’agit-il

Le Model Context Protocol (MCP) est la façon dont les assistants IA utilisent les outils d’autres logiciels. Le serveur MCP d’AttendBeacon permet à un assistant de consulter vos événements et, si vous l’y autorisez, d’effectuer quelques modifications sans risque, avec les mêmes clés, autorisations, limites et journal que l’API REST.

L’adresse : https://attendbeacon.com/mcp (Streamable HTTP)

Une fois connecté, posez vos questions avec vos propres mots :

« Comment se vend Beacon Summit par rapport à la semaine dernière, et quand serons-nous complets à ce rythme ? »
« Qui vient de chez Contoso, et sont-ils déjà arrivés ? »
« Qu’est-ce qui se passe dans le Main Hall jeudi après-midi ? »
« Quels intervenants ont apporté le plus de billets avec leurs liens de partage ? »
« Ajoute une session de 30 minutes “Lightning talks” en Room 2 le 13 novembre à 14 h 00. » (l’assistant demande avant de modifier quoi que ce soit)

Deux façons de se connecter

Par connexion (connecteurs personnalisés de Claude, ChatGPT, Copilot Studio avec OAuth) : l’assistant vous envoie vers AttendBeacon, vous vous connectez en votre nom, choisissez l’espace de travail et ce que l’assistant peut faire, puis vous l’autorisez. AttendBeacon crée une clé pour cet assistant, que vous voyez et pouvez révoquer sous Intégrations › API & MCP.

Par clé (Claude Code, VS Code, Copilot Studio avec une clé API, et tout autre client) : créez une clé sous Intégrations › API & MCP en partant de Assistant IA (lecture seule), et donnez-la au client sous la forme Authorization: Bearer abk_... ou X-Api-Key.

Dans les deux cas, un assistant ne peut rien faire de plus que ce que permettent les autorisations de sa clé. Commencez en lecture seule ; n’ajoutez une autorisation d’écriture (comme tickets:write pour les codes de réduction) que pour ce que vous voulez lui confier.

Claude

Claude sur le web et Claude Desktop (connecteur personnalisé) :

Ouvrez Settings › Connectors (Paramètres › Connecteurs) et choisissez Add custom connector. (Dans un forfait Team ou Enterprise, un propriétaire l’ajoute d’abord sous Organization settings › Connectors.)
Nommez-le AttendBeacon et indiquez l’adresse https://attendbeacon.com/mcp. Laissez les paramètres avancés vides.
Choisissez Connect, connectez-vous à AttendBeacon, choisissez l’espace de travail et les autorisations, puis autorisez l’accès.
Dans une conversation, activez AttendBeacon dans le menu des outils, et posez votre question.

Claude Code, avec une clé :

Shell

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

Ou ajoutez-le sans l’en-tête et lancez /mcp dans Claude Code pour vous connecter à la place.

ChatGPT

Dans ChatGPT, ouvrez Settings › Apps & Connectors (Paramètres › Applications et connecteurs) et, sous Advanced settings, activez Developer mode (votre forfait et l’administrateur de votre espace de travail doivent autoriser les connecteurs personnalisés).
Choisissez Create, nommez-le AttendBeacon, indiquez l’adresse du serveur MCP https://attendbeacon.com/mcp et OAuth comme authentification.
Connectez-vous à AttendBeacon, choisissez l’espace de travail et les autorisations, puis autorisez l’accès.
Dans une conversation, ajoutez AttendBeacon depuis le menu des outils.

ChatGPT demande une confirmation avant chaque outil qui modifie des données.

VS Code et GitHub Copilot

Ajoutez le serveur à .vscode/mcp.json dans votre projet (ou à vos paramètres utilisateur). VS Code demande la clé une seule fois et la conserve dans son stockage de secrets :

JSON

{
  "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}" }
    }
  }
}

Ouvrez Copilot Chat en mode Agent ; les outils d’AttendBeacon se trouvent sous le bouton des outils.

Copilot Studio

Dans votre agent, ouvrez Tools › Add a tool › New tool › Model Context Protocol (Outils › Ajouter un outil › Nouvel outil › Model Context Protocol).
Indiquez le nom de serveur AttendBeacon, une description (« Consulte et met à jour nos événements AttendBeacon ») et l’URL du serveur https://attendbeacon.com/mcp.
Comme authentification, choisissez API key, type Header, nom d’en-tête X-Api-Key. (Ou OAuth 2.0 avec découverte dynamique, pour vous connecter à la place.)
Créez la connexion avec votre clé, et ajoutez les outils à l’agent.

Autres clients

Cursor, Windsurf, Gemini CLI et tout client qui parle Streamable HTTP se connectent de la même façon : l’adresse, et la clé dans un en-tête, ou la connexion si le client prend en charge OAuth.

Les outils

Outil	Ce qu’il fait	Requis pour s’abonner	Modifie des données
`whoami`	L’espace de travail auquel la connexion accède, ce que la clé peut faire et ses limites.	—	Non
`find_events`	Liste les événements de l’espace de travail avec leurs dates, leur statut, les billets et les entrées.	`events:read`	Non
`get_event_summary`	Un événement en un coup d’œil : inscriptions par rapport à la capacité, entrées, programme et chiffre d’affaires.	`events:read`	Non
`search_attendees`	Trouve des participants par nom, adresse, entreprise ou référence de commande.	`attendees:read` `people:read`	Non
`get_agenda`	Le programme dans l’ordre chronologique, à l’heure du lieu, avec les salles, les parcours et les intervenants.	`program:read`	Non
`list_speakers`	Les intervenants tels que la page de l’événement les présente.	`program:read`	Non
`list_sponsors`	Les sponsors et exposants par niveau, avec leur stand.	`sponsors:read`	Non
`get_check_in_counts`	Qui est arrivé, la dernière heure et les comptages de chaque entrée.	`checkins:read`	Non
`get_sales_pace`	Billets et chiffre d’affaires par jour, cette semaine par rapport à la précédente, et où mène ce rythme.	`orders:read`	Non
`get_budget_summary`	Recettes, coûts et résultat : budgétés, engagés, réels et prévisionnels.	`finance:read`	Non
`list_cfp_submissions`	Les propositions reçues par l’appel à propositions et leur statut.	`cfp:read`	Non
`get_share_kit_leaderboard`	Les intervenants et sponsors qui ont apporté le plus de billets avec leur lien ou leur code.	`sharekit:read`	Non
`list_ticket_types`	Les types de billets avec leur prix, leur capacité et ce qu’il en reste.	`tickets:read`	Non
`create_draft_event`	Ajoute un nouvel événement en brouillon. Rien n’est publié et personne ne reçoit d’e-mail.	`events:write`	Oui
`add_session`	Ajoute une session au programme ; les participants la voient aussitôt si l’événement est publié.	`program:write`	Oui
`create_discount_code`	Crée un code de réduction, valable immédiatement.	`tickets:write`	Oui
`update_ticket_capacity`	Modifie le nombre de places d’un type de billet, jamais en dessous de ce qui est déjà pris.	`tickets:write`	Oui
`check_in_attendee`	Enregistre l’arrivée d’une personne à une entrée, selon les règles du scanner.	`checkins:write`	Oui

Prompt	Ce qu’il fait
`event_briefing`	Un point rapide sur un événement : inscriptions, ventes, programme et ce qui demande de l’attention.
`door_status`	Le jour J : qui est arrivé, à quel rythme, et quelles entrées sont chargées.
`sales_update`	Les ventes de billets cette semaine par rapport à la précédente, et où l’événement va arriver.

Chaque outil répond en JSON compact dans un seul bloc de texte, et les listes renvoient une page avec nextCursor pour demander la suite. Les heures sont données en UTC et à l’heure locale du lieu, les montants dans la devise de l’événement.

Les outils qui modifient des données commencent leur description par CHANGES DATA, et sont marqués comme n’étant pas en lecture seule : les assistants vous demandent donc votre accord avant de les appeler. Aucun ne supprime quoi que ce soit : un événement est créé en brouillon, une capacité n’est jamais fixée en dessous de ce qui est vendu, une arrivée suit les règles de l’entrée.

Ce que vous voyez dans l’espace de travail

Intégrations › API & MCP › Activité des clés liste chaque appel d’outil, avec mcp comme canal et le nom de l’outil, y compris les appels refusés et leur raison.
Les modifications apparaissent dans le journal d’activité de l’espace de travail sous la forme « API key abk_... (nom) via MCP ».
Révoquez la clé, ou l’application connectée, et l’assistant s’arrête immédiatement.

Quand quelque chose est refusé

L’outil répond par une erreur dont le texte commence par le code de l’API, pour que l’assistant puisse vous dire quoi faire :

missingScope : il manque une autorisation à la clé ; créez une clé qui la possède.
peopleScope : la question porte sur des personnes nommées ; la clé a besoin de Données personnelles.
moduleOff : l’organisateur a désactivé cette fonctionnalité pour l’événement.
rateLimited : plus de 120 appels par minute, partagés avec l’API REST.

Pour les curieux

Le serveur repose sur le SDK C# officiel, en Streamable HTTP et sans état : chaque requête est indépendante, et n’importe quel serveur d’AttendBeacon peut y répondre. Il propose des outils et trois prompts (event_briefing, door_status, sales_update) ; il ne demande rien en retour au client. La connexion repose sur OAuth 2.1 avec PKCE et l’enregistrement dynamique des clients, comme le décrit la spécification d’autorisation MCP, annoncée à /.well-known/oauth-protected-resource.

Les guides et ce site sont dans votre langue. Les descriptions propres à la référence de l’API restent en anglais, la langue de l’API elle-même.

#De quoi s’agit-il

#Deux façons de se connecter

#Claude

#ChatGPT

#VS Code et GitHub Copilot

#Copilot Studio

#Autres clients

#Les outils

#Ce que vous voyez dans l’espace de travail

#Quand quelque chose est refusé

#Pour les curieux