Outils & développeurs

Connecter Joinways à Claude (MCP)

Interrogez et pilotez vos données Joinways depuis Claude grâce au connecteur MCP, pour des analyses et actions en langage naturel.

Le connecteur MCP (Model Context Protocol) permet à un assistant comme Claude d'accéder à vos données Joinways pour répondre à des questions et exécuter des actions, en langage naturel. Au lieu de cliquer dans l'interface, vous demandez « Combien d'événements ce mois-ci ? » ou « Crée un devis pour ce client » et l'assistant interroge ou agit sur votre espace à votre place. C'est une fonction avancée, pensée pour les utilisateurs à l'aise avec les outils d'IA.

Cet article explique ce que le connecteur apporte concrètement, comment l'installer en toute sécurité, ce que vous pouvez demander ou faire faire, et les précautions à prendre puisqu'il donne accès à vos données. L'objectif : tirer parti de l'assistant sans jamais perdre le contrôle de votre espace.

Prérequis

  • Un compte Joinways avec accès aux Paramètres de votre espace de travail.
  • Un assistant compatible MCP (par exemple Claude) où renseigner la configuration du connecteur.
  • Le droit de générer des identifiants de connexion ; cette opération est généralement réservée aux administrateurs.
  • Une aisance de base avec les outils d'IA et la notion de connecteur ou d'intégration.

Ce que vous allez apprendre

  • Comprendre ce qu'apporte le connecteur MCP.
  • Le configurer en toute sécurité.
  • Connaître les questions et actions possibles.
  • Gérer et révoquer les identifiants de connexion.
  • Adopter les bons usages et éviter les pièges.

À quoi ça sert

Le connecteur transforme votre assistant en interface de pilotage de Joinways en langage naturel. Vous posez une question ou donnez une instruction ; l'assistant lit ou modifie vos données via le connecteur, puis vous restitue la réponse.

  • Poser des questions sur vos événements et devis en langage naturel.
  • Préparer des analyses rapides sans export manuel.
  • Déclencher certaines actions depuis votre assistant.

Configurer le connecteur

La configuration consiste à générer des identifiants côté Joinways, puis à les renseigner côté assistant. Une fois la connexion établie, l'assistant peut interroger et agir sur votre espace dans la limite des droits accordés.

  1. Allez dans Paramètres puis Intégrations / Outils.
  2. Générez les identifiants de connexion MCP.
  3. Renseignez-les dans la configuration MCP de votre assistant (ex. Claude).
  4. Testez la connexion par une question simple (par exemple le nombre d'événements à venir).
  5. Conservez les identifiants en lieu sûr, comme des secrets.
⚠️ À savoir : ce connecteur donne accès à vos données. Conservez les identifiants comme des secrets et révoquez-les en cas de doute.

Référence : ce que vous pouvez demander et faire

Voici, en une ligne chacune, les grandes familles de questions et d'actions que l'assistant peut traiter via le connecteur.

  • Consulter et compter — événements, devis, entreprises, personnes, tâches et prospects de votre espace.
  • Rechercher — retrouver un élément par mots-clés via une recherche globale.
  • Événements — lister, consulter le détail, créer, mettre à jour et changer le statut d'un événement.
  • Devis — lister, consulter, créer, dupliquer, télécharger un devis et modifier ses lignes ou son statut.
  • Entreprises et personnes — lister, rechercher, créer et mettre à jour vos contacts et sociétés.
  • Tâches — lister, créer, mettre à jour et supprimer des tâches de suivi.
  • Prospects (leads) — lister, consulter, changer le statut et convertir un prospect en événement.
  • Disponibilité des lieux — vérifier les disponibilités, bloquer ou débloquer des dates, lister les conflits.
  • Analyses — obtenir des indicateurs commerciaux, comptables et d'événements sans export manuel.
  • E-mails — générer un brouillon d'e-mail ou envoyer un e-mail lié à un événement.
  • Catalogue — lister, créer, mettre à jour et supprimer des éléments de catalogue.
  • Notes d'événement — ajouter et lister des notes rattachées à un événement.
  • Équipe et staff — lister les membres de l'équipe et le personnel affecté à un événement.
  • BEO et journées — consulter le déroulé (BEO) et les journées d'un événement.
  • Notifications — lister vos notifications récentes.
  • Modèles et connexions e-mail — lister les modèles d'e-mail et les connexions de messagerie disponibles.

Comment ça marche

Quand vous formulez une demande, l'assistant la traduit en appels au connecteur Joinways. Pour une question, il lit les données et compose une réponse ; pour une action, il appelle l'outil correspondant (création de devis, mise à jour de statut, etc.). Les identifiants déterminent l'espace ciblé et le périmètre des droits ; rien n'est accessible au-delà de ce que ces identifiants autorisent.

Vous restez l'arbitre : relisez les réponses et confirmez les actions sensibles avant de les valider, surtout lorsqu'elles créent ou modifient des enregistrements.

Cas particuliers

  • Identifiant partagé : si plusieurs personnes utilisent le même identifiant, vous perdez la traçabilité ; préférez des identifiants distincts par personne quand c'est possible.
  • Action involontaire : une instruction ambiguë peut déclencher une création non voulue ; reformulez ou annulez l'action côté Joinways.
  • Identifiant compromis : en cas de doute (fuite, appareil perdu), révoquez immédiatement l'identifiant et régénérez-en un nouveau.
  • Données sensibles : l'assistant voit ce que le connecteur expose ; limitez son usage aux contextes de confiance.

Bonnes pratiques

  • Limitez l'accès aux personnes de confiance.
  • Révoquez immédiatement un identifiant compromis.
  • Vérifiez les actions sensibles avant exécution.
  • Testez d'abord en lecture (questions, analyses) avant d'autoriser des actions d'écriture.
  • Conservez les identifiants hors des messages et fichiers partagés.
  • Relisez systématiquement le récapitulatif d'une action d'écriture avant de la confirmer.

Dépannage

Problème : l'assistant ne voit pas vos données. Cause : les identifiants sont absents ou mal renseignés côté assistant. Solution : régénérez les identifiants dans Paramètres puis Intégrations / Outils et recollez-les soigneusement dans la configuration MCP.

Problème : une action a échoué ou n'a rien fait. Cause : la demande était ambiguë ou les droits ne couvrent pas cette action. Solution : reformulez précisément la demande et vérifiez que l'identifiant utilisé dispose des droits nécessaires.

Problème : vous craignez une fuite d'identifiant. Cause : credential exposé dans un message ou un appareil non sécurisé. Solution : révoquez-le immédiatement, générez-en un nouveau, et mettez à jour la configuration de l'assistant.

Exemple concret

Un responsable de salle veut un point rapide le lundi matin. Depuis Claude relié au connecteur, il demande « Combien d'événements confirmés cette semaine et quel chiffre d'affaires prévu ? ». L'assistant interroge Joinways, compte les événements et restitue les indicateurs commerciaux, sans qu'il ait à ouvrir l'interface ni à exporter quoi que ce soit.

Dans la foulée, il demande « Crée une tâche de relance pour le devis du mariage Martin ». L'assistant crée la tâche dans Joinways ; il vérifie la confirmation avant de passer à la suite.

Autre exemple

En préparation d'un devis, le gérant demande à l'assistant de vérifier la disponibilité de la grande salle pour une date donnée. Le connecteur interroge la disponibilité du lieu et signale qu'elle est libre ; le gérant enchaîne avec « Crée un devis pour ce client avec une location de salle ».

L'assistant crée le devis et ses lignes via le connecteur ; le gérant le télécharge ensuite pour relecture avant envoi.

FAQ

Faut-il être développeur ?

Pas nécessairement, mais une aisance avec les outils d'IA et la configuration MCP aide.

Quel assistant puis-je connecter ?

Tout assistant compatible MCP, par exemple Claude, où vous renseignez la configuration du connecteur.

Que puis-je demander à l'assistant ?

Consulter et compter vos événements, devis, entreprises, personnes, tâches et prospects, et obtenir des analyses en langage naturel.

Quelles actions puis-je déclencher ?

Créer ou mettre à jour des événements, devis, contacts et tâches, vérifier des disponibilités ou générer des e-mails, selon vos droits.

Le connecteur peut-il modifier mes données ?

Oui, pour les actions d'écriture autorisées ; relisez et confirmez les actions sensibles avant de valider.

Comment révoquer l'accès ?

Révoquez l'identifiant depuis Paramètres puis Intégrations / Outils ; l'assistant perd alors l'accès immédiatement.

Mes identifiants sont-ils des secrets ?

Oui. Traitez-les comme des mots de passe : ne les partagez pas et régénérez-les en cas de doute.

L'assistant accède-t-il à plusieurs espaces ?

L'accès est limité à l'espace ciblé par les identifiants et au périmètre des droits associés ; rien au-delà n'est visible.

Voir aussi

  • Clés API
  • Sécurité et accès

Prêt à centraliser vos demandes événementielles ?