Les agents IA et l’API Abilities

HappenBoard peut laisser un assistant IA comme Claude, ChatGPT ou Cursor travailler sur votre agenda. Une fois connecté, l’assistant (on parle aussi d’agent) peut lister vos événements, en créer un, chercher des créneaux libres ou inscrire un participant quand vous le lui demandez dans une conversation.

HappenBoard a pour cela son propre serveur MCP (MCP est le standard qui permet aux assistants IA de se connecter à d’autres outils). Vous collez une adresse dans votre assistant, vous vous connectez avec votre compte WordPress et vous cliquez sur Allow. Aucune clé à copier.

Avant de commencer

• WordPress 6.9 ou plus récent. Les agents IA passent par l’API Abilities, arrivée avec cette version.
• Pour claude.ai, l’application Claude pour ordinateur et ChatGPT : un site avec une adresse publique en HTTPS. Ces assistants se connectent depuis leurs propres serveurs : ils ne peuvent pas joindre un site qui tourne seulement sur votre ordinateur.
• Une structure de permaliens autre que Simple, dans Réglages → Permaliens. Les assistants en ont besoin pour trouver où se connecter.
• Un compte WordPress avec le rôle dont l’assistant a besoin. Il peut faire ce que ce compte peut faire dans HappenBoard, rien de plus.

Activer les agents IA

La fonction est désactivée à l’installation de HappenBoard.

1. Allez dans HappenBoard → Settings → AI agents.
2. Activez Expose HappenBoard to AI agents.
3. Cliquez sur Save.

Deux cartes apparaissent sous l’interrupteur : Connect an AI client et Your connected clients.

Connecter votre assistant

La carte Connect an AI client a un onglet par assistant : Claude, ChatGPT, Cursor et Other. Chaque onglet donne les étapes et le texte à coller, avec un bouton Copy. L’adresse de votre serveur ressemble à ceci :

https://votre-site.fr/wp-json/happenboard/mcp/v1

Copiez-la depuis l’écran plutôt que de la taper. Ensuite, tous les assistants fonctionnent de la même façon : ils ouvrent votre site dans votre navigateur, vous vous connectez si besoin et vous cliquez sur Allow.

Claude (claude.ai et l’application pour ordinateur)

1. Dans claude.ai ou l’application Claude, ouvrez les réglages, puis les connecteurs, et choisissez d’ajouter un connecteur personnalisé.
2. Nommez-le HappenBoard, collez l’adresse de votre serveur et laissez les autres champs vides.
3. Cliquez sur le bouton de connexion. Votre site s’ouvre : connectez-vous si besoin, puis cliquez sur Allow.

Claude Code

Copiez la commande affichée sous l’onglet Claude et lancez-la dans un terminal. Elle ressemble à ceci :

claude mcp add --transport http --scope user HappenBoard "https://votre-site.fr/wp-json/happenboard/mcp/v1"

Tapez ensuite /mcp dans Claude Code, choisissez HappenBoard et connectez-vous. Votre site s’ouvre : cliquez sur Allow. Claude Code tourne sur votre ordinateur : il joint donc aussi un site installé sur votre ordinateur (avec Local, par exemple).

ChatGPT

1. Dans ChatGPT, ouvrez les réglages et trouvez l’écran qui liste vos connecteurs (ou applications). Ajoutez-y un serveur MCP personnalisé. Si l’option n’apparaît pas, activez d’abord le mode développeur dans les réglages avancés.
2. Nommez-le HappenBoard, collez l’adresse de votre serveur, choisissez OAuth si ChatGPT demande comment se connecter, puis enregistrez.
3. Votre site s’ouvre : connectez-vous si besoin, puis cliquez sur Allow.

Cursor

1. Ouvrez le fichier ~/.cursor/mcp.json (créez-le s’il n’existe pas) et collez le bloc de l’onglet Cursor, reproduit ci-dessous. Si le fichier contient déjà "mcpServers", ajoutez seulement l’entrée HappenBoard à l’intérieur.
2. Redémarrez Cursor, ouvrez ses réglages MCP et cliquez sur le bouton de connexion à côté de HappenBoard. Votre site s’ouvre : cliquez sur Allow.

{
    "mcpServers": {
        "HappenBoard": {
            "type": "http",
            "url": "https://votre-site.fr/wp-json/happenboard/mcp/v1"
        }
    }
}

Autres assistants

Tout assistant qui accepte les serveurs MCP distants (parfois appelés Streamable HTTP) peut se connecter. Donnez-lui l’adresse de votre serveur : il se connecte par votre navigateur, de la même façon.

Choisir ce que l’assistant peut faire

Avant la connexion, votre site affiche le nom de l’assistant et le compte WordPress qu’il utilisera. Sous What it may do, choisissez une option :

Cliquez sur Allow pour connecter, ou sur Refuse pour arrêter. L’assistant choisit lui-même son nom et rien ne le vérifie : ne cliquez sur Allow que si vous venez de lancer la connexion vous-même.

La connexion utilise le compte avec lequel vous êtes connecté dans ce navigateur. Pour utiliser un compte séparé, avec un rôle plus limité, connectez-vous d’abord à WordPress avec ce compte.

Ce qu’un assistant peut faire

Ses outils viennent des actions de HappenBoard (appelées abilities), réparties en quatre groupes :

• Events & calendar : événements, lieux, organisateurs, catégories et étiquettes, règles de répétition, météo et flux de calendrier.
• Appointment booking : types de rendez-vous, disponibilités des hôtes, créneaux libres, création ou déplacement de rendez-vous.
• Attendees & RSVPs : listes de participants, inscription d’une personne, modification ou déplacement d’une inscription.
• Configuration & diagnostics : vue d’ensemble du site, état du système et vos réglages, qu’il peut lire mais pas modifier.

Rien ne peut être supprimé via MCP. Les outils qui suppriment ou sont difficiles à défaire sont écartés, et vous faites ces actions vous-même dans WordPress :

• supprimer un événement, un lieu, un organisateur ou un type de rendez-vous ;
• annuler un rendez-vous ;
• importer des événements en CSV ;
• remplacer les disponibilités hebdomadaires d’un hôte.

Avec HappenBoard Pro, ceux-ci sont écartés aussi :

• supprimer un type de billet, un champ personnalisé ou une ressource partagée ;
• créer ou supprimer un webhook ;
• approuver ou refuser un événement proposé par un visiteur ;
• récupérer à la demande les changements de Google Agenda ou d’Outlook ;
• exporter des badges.

Une inscription, c’est différent : une connexion Read and change peut changer le statut d’un participant, comme l’écran des participants, et Cancelled fait partie des statuts. Avec HappenBoard Pro, elle peut aussi annuler une date d’un événement récurrent, puis la rétablir. Choisissez Read only si l’assistant ne doit rien modifier.

Dépliez la liste des outils sur la carte Connect an AI client pour voir chaque outil et s’il lit ou modifie des données. Chaque assistant ne reçoit que les outils que son compte peut utiliser. HappenBoard Pro ajoute des outils pour les billets, les commandes, le check-in, les champs personnalisés et plus encore. L’assistant IA de création d’événements de Pro, qui remplit le formulaire d’événement à partir d’une phrase, est une fonction distincte.

Comment votre site reste protégé

• L’assistant est soumis aux mêmes rôles et permissions que les écrans d’administration. Rien ne fonctionne sans connexion. Un compte qui ne peut pas exporter les participants voit leurs noms et statuts, pas leurs e-mails.
• Des limites s’appliquent par utilisateur : 300 lectures par minute, 60 modifications par minute et 600 par heure.
• Une connexion Read only se voit refuser toute modification, même si l’assistant demande un outil par son nom.
• Un assistant inutilisé pendant 30 jours doit se reconnecter.

Vos formulaires publics d’inscription et de réservation ne sont pas concernés. Ils gardent leur propre protection contre le spam.

Déconnecter un assistant

Your connected clients liste les assistants connectés à votre compte, chacun avec Read only ou Read and change et sa date de dernière utilisation. Cliquez sur Disconnect pour en couper un immédiatement.

Pour le reconnecter plus tard, relancez la connexion depuis l’assistant. Inutile de le supprimer puis de l’ajouter à nouveau. Une ligne indiquant qu’elle a été créée pour une ancienne adresse du site (après un changement de domaine, par exemple) demande une nouvelle connexion.

Lire la vérification de la configuration

En bas de la carte Connect an AI client, Setup check affiche Everything is ready ou le nombre de points à vérifier. Dépliez-le pour voir chaque vérification, marquée OK, Check, Problem ou Not checked. Cliquez sur Check again après une correction.

Si votre site n’est pas en HTTPS

La connexion par le navigateur demande le HTTPS. Sur un site public sans HTTPS, claude.ai et ChatGPT ne peuvent pas se connecter. Claude Code et Cursor le peuvent, avec un mot de passe d’application :

1. Cliquez sur Create an application password sur la carte Connect an AI client.
2. Copiez la commande (Claude Code) ou le bloc pour ~/.cursor/mcp.json (Cursor). Le mot de passe y est déjà inséré.
3. Copiez-le avant de quitter la page : il ne sera plus affiché.

Dès que votre site passe en HTTPS, l’écran revient à la connexion par le navigateur.

Voir ce qu’un assistant a fait

La liste Agent activity, en bas de l’écran, enregistre chaque modification qu’un assistant a faite ou tentée. Chaque ligne affiche When, Acting as (le compte utilisé), Ability et Outcome. Ouvrez Arguments pour voir ce qu’il a envoyé, mots de passe et clés remplacés par [redacted].

Le filtre Outcome retrouve vite les refus, et Refresh charge les nouvelles entrées. Seules les modifications sont enregistrées, pas les lectures. Les entrées sont conservées 90 jours.

Couper l’accès

Désactivez Expose HappenBoard to AI agents et cliquez sur Save. Chaque assistant perd l’accès dès sa requête suivante. Rien n’est supprimé, et le journal reste.

Importer une sauvegarde des réglages règle aussi cet interrupteur sur la valeur enregistrée dans le fichier. En cas d’urgence, ou pour bloquer les agents sur tous les sites d’un réseau, ajoutez cette ligne dans wp-config.php. Elle l’emporte sur l’interrupteur :

define( 'HAPPENBOARD_DISABLE_ABILITIES', true );

Pour aller plus loin

• Rôles et permissions : choisir le rôle du compte utilisé par votre assistant.
• Santé et maintenance : l’état du système, qu’un assistant peut aussi consulter.
• Hooks agents et abilities : modifier la liste des abilities ou les limites dans le code.