Connecter Joinways à Claude (MCP)

Connecter Joinways à Claude (MCP)

Le connecteur MCP Joinways permet à Claude — que vous l'utilisiez sur claude.ai, Claude Desktop, Claude Code ou tout autre client compatible MCP — d'agir directement sur votre workspace Joinways depuis une simple conversation. Vous n'avez plus à basculer entre Joinways et une fenêtre de chat : Claude peut lire vos demandes, rédiger des devis, mettre à jour des événements, envoyer des emails à votre place et vous briefer sur ce qui arrive, le tout en langage naturel.

Cet article explique ce qu'est MCP, ce que le connecteur Joinways permet à Claude de faire, comment l'installer et l'autoriser en moins de trois minutes, et comment en tirer le meilleur parti une fois en place.

En un coup d'œil. Disponible sur tous les plans payants, environ 3 minutes d'installation, authentification de type OAuth, et respect strict de vos permissions Joinways existantes. Claude ne voit et n'agit que sur ce que votre compte peut déjà voir et faire.

Qu'est-ce que MCP ?

MCP (Model Context Protocol) est le standard ouvert qui permet aux modèles comme Claude de se connecter à des outils et données externes. Un connecteur — parfois appelé « serveur MCP » — expose un ensemble de capacités (lire des demandes, lister des événements, envoyer un email, etc.) que Claude peut appeler quand c'est utile pour répondre.

Concrètement :

• Le connecteur tourne côté Joinways. Vous n'installez rien sur votre machine.
• Claude l'appelle via votre session autorisée, donc Joinways voit toujours un utilisateur réel et identifié.
• Chaque appel est tracé dans le journal d'activité Joinways, exactement comme une action manuelle.

Si vous avez utilisé les « Tools » dans ChatGPT, les « Plugins » dans d'anciennes versions de Claude ou les « Actions » dans Notion AI, MCP en est l'équivalent moderne et ouvert — mais plus puissant, puisqu'il permet au modèle d'enchaîner plusieurs étapes dans la même conversation.

Ce que Claude peut faire avec le connecteur Joinways

Une fois le connecteur activé dans Claude, vous pouvez lui demander des choses comme les exemples ci-dessous, et Claude les exécutera en dialoguant avec Joinways pour vous.

Demandes et leads

• « Quelles demandes sont arrivées cette semaine ? » — Claude liste les leads récents, triés par date, avec le type d'événement, la date et le nombre d'invités extraits par l'IA.
• « Qualifie la demande mariage de Camille Martin — la date passe-t-elle dans le château, et quel budget cohérent proposer ? » — Claude vérifie la disponibilité, compare aux événements similaires passés et suggère une fourchette de budget.
• « Rédige une réponse à la demande séminaire d'hier. » — Claude prépare un message personnalisé dans votre ton, prêt à être relu et envoyé.

Événements et calendrier

• « Montre-moi tout ce qui se passe au Château de Beauregard entre le 14 et le 21 juin. » — Claude affiche la vue calendrier filtrée par lieu.
• « Crée un événement pour les 50 ans de Dupont le 12 octobre, 60 invités, dans la Grande Salle. » — Claude crée l'événement avec le bon statut (Option), affecte l'espace et lie le contact.
• « Trouve-moi les événements sans devis signé qui commencent dans les 30 prochains jours. » — Claude liste les dossiers à relancer.

Devis et BEO

• « Construis un devis pour le mariage Martin : 120 invités, dîner deux services, location de salle, DJ. » — Claude assemble les lignes depuis le catalogue et produit un brouillon dans l'onglet Devis.
• « Mets à jour le BEO de samedi — la mariée a demandé une option végétarienne pour la table 4. » — Claude retrouve l'événement, ouvre le BEO et ajoute la note diététique.
• « Envoie une relance polie aux contacts qui n'ont pas encore signé leur devis. » — Claude prépare et met en file un email personnalisé par contact en attente.

Rapports et administration

• « Comment notre taux de conversion se compare-t-il au trimestre dernier ? » — Claude consulte Rapports → Commercial et résume l'évolution.
• « Quels membres de l'équipe n'ont pas encore connecté leur email ? » — Claude liste les manques.
• « Ajoute Sarah Lebrun comme Manager sur le workspace Beauregard. » — Claude ouvre le flux d'invitation et vous confirme avant d'envoyer.

Important — Claude n'agit jamais à l'aveugle. Pour toute opération qui modifie des données (création, mise à jour, suppression, envoi), Claude vous montre un aperçu et demande votre confirmation avant d'exécuter. Les opérations en lecture seule (lister, résumer) peuvent s'exécuter sans confirmation selon les réglages de votre client.

Installer le connecteur

L'installation se passe en deux endroits : dans Joinways vous générez l'URL du connecteur une seule fois ; dans votre client Claude vous ajoutez cette URL et autorisez la connexion.

Étape 1 — Générer l'URL du connecteur dans Joinways

1. Ouvrez Paramètres → Intégrations → API.
2. Joinways vous affiche une URL unique de la forme https://mcp.joinways.com

Étape 2 — Ajouter le connecteur dans Claude

Le chemin exact dépend du client Claude que vous utilisez.

• Claude Desktop — ouvrez Réglages → Connecteurs → Ajouter un connecteur personnalisé, collez l'URL et identifiez-vous sur Joinways quand la popup OAuth apparaît.
• Claude.ai — ouvrez Réglages → Connecteurs → Ajouter un serveur MCP, collez l'URL, nommez-le « Joinways » et autorisez.
• Claude Code — dans votre projet, lancez claude mcp add joinways <url> et acceptez l'invite d'autorisation. Le connecteur est ensuite disponible sur cette machine dans toutes vos sessions Claude Code.

Après autorisation, envoyez un prompt de test rapide pour confirmer que tout est branché :

« Salut Claude, peux-tu confirmer que tu vois mon workspace Joinways et lister mes trois prochains événements ? »

Si Claude répond avec une liste réelle, c'est en place.

Étape 3 — Permissions et visibilité

Le connecteur hérite de votre rôle Joinways :

• Admin — lecture/écriture complètes sur l'ensemble du workspace.
• Manager — lecture/écriture sur les lieux attribués, lecture seule ailleurs.
• Member — lecture/écriture uniquement sur les événements dont vous êtes propriétaire.

Si vous ne pouvez pas faire une action dans l'interface Joinways, Claude ne pourra pas la faire non plus via le connecteur. C'est volontaire : la couche MCP n'élève jamais les permissions.

Bonnes pratiques

• Soyez précis dans vos prompts. « Liste mes leads » fonctionne, mais « Montre-moi les leads reçus cette semaine, triés par date d'événement, avec le budget extrait par l'IA » donne une réponse beaucoup plus utile.
• Utilisez Claude pour les tâches répétitives. Le tri quotidien de l'inbox, la rédaction des relances, les mises à jour groupées et les reportings hebdo sont les usages qui font gagner le plus de temps.
• Un connecteur par workspace. Si vous gérez plusieurs workspaces, ajoutez-en un par workspace. Nommez-les clairement (« Joinways – Château », « Joinways – Domaine ») pour éviter les confusions.
• Auditez régulièrement. Paramètres → Intégrations → MCP → Activité liste chaque action effectuée par Claude via le connecteur. Une revue mensuelle suffit.
• Combinez avec les calendriers. Si Google Calendar ou Outlook Calendar est aussi synchronisé, Claude peut répondre à des questions du type « Suis-je libre samedi soir ? » en croisant les deux sources.

Curieux de voir comment les autres l'utilisent ? Les workflows les plus populaires sont le briefing du lundi matin (« Qu'est-ce qui arrive cette semaine, qu'est-ce qui est encore en option ? »), l'inbox zéro (« Réponds à toutes les demandes d'hier avec une première réponse personnalisée ») et la relance de devis (« Relance les contacts dont le devis a été envoyé il y a plus de 14 jours »).

Dépannage

Claude dit qu'il ne voit pas mes données Joinways

Réautorisez le connecteur : dans votre client Claude, supprimez le serveur MCP Joinways puis ré-ajoutez-le avec l'URL prise dans Paramètres → Intégrations → MCP. La plupart des problèmes « je ne vois rien » viennent d'un token périmé.

Claude effectue des actions que je n'ai pas validées

Cela ne devrait pas arriver pour les opérations en écriture. Si c'est le cas, vérifiez les réglages connecteur de votre client — certains clients ont une option « toujours autoriser » que vous avez peut-être activée. Basculez-la en « demander avant chaque action ».

L'URL MCP est cassée ou expirée

Les tokens sont régénérés quand un admin clique sur Révoquer dans Paramètres → Intégrations → API. Générez une nouvelle URL et reconfigurez votre client.

Claude ne trouve pas un événement précis

Donnez-lui assez de contexte : un nom, une date ou un lieu. Si votre workspace contient plusieurs événements aux titres similaires, Claude vous demandera de désambiguïser.

Le mode lecture seule bloque les écritures

Vous êtes en mode restreint, c'est voulu. Ouvrez Paramètres → Intégrations → API, modifiez le connecteur et accordez les permissions d'écriture pour les capacités nécessaires.

Questions fréquentes

Le connecteur est-il gratuit ?

Oui, sur tous les plans payants. L'essai gratuit l'inclut également.

Anthropic voit-il mes données Joinways ?

Anthropic traite les requêtes nécessaires aux réponses de Claude, mais vos données ne sont pas utilisées pour entraîner les modèles dans un contexte professionnel. Consultez la politique de confidentialité d'Anthropic pour le détail. Côté Joinways, seuls les appels nécessaires à votre demande sont effectués.

Plusieurs membres de mon équipe peuvent-ils utiliser le même connecteur ?

Chaque membre ajoute le connecteur avec son propre compte Joinways, ce qui préserve les permissions individuelles. Vous ne partagez pas un token unique.

Le connecteur fonctionne-t-il hors-ligne ?

Non. Claude comme le connecteur Joinways requièrent une connexion internet.

Va-t-il créer des événements ou envoyer des emails sans moi ?

Non. Chaque action en écriture est précédée d'un aperçu et d'une confirmation, sauf si vous avez explicitement basculé votre client en mode « toujours autoriser ».

Quelles langues Claude comprend-il pour les prompts Joinways ?

Toutes les grandes langues, dont le français, l'anglais, l'espagnol, l'allemand et l'italien. La langue de l'interface Joinways n'a pas besoin de correspondre à la langue que vous utilisez avec Claude.

Puis-je utiliser le connecteur dans Claude Code ?

Oui. Une fois enregistré via claude mcp add joinways <url>, toutes les sessions Claude Code sur cette machine peuvent l'utiliser. C'est particulièrement puissant pour les développeurs qui construisent des automatisations au-dessus de Joinways.

Voir aussi

• Guide de démarrage rapide — configurez d'abord votre workspace Joinways si ce n'est pas déjà fait.
• Connexions email (Gmail / Outlook) — nécessaire si vous voulez que Claude rédige des réponses depuis votre adresse.
• Rapports & performance — les métriques que Claude utilise pour ses résumés.
• Sécurité & accès — interaction entre rôles, permissions et connecteur.

Résumé rapide : connecter Joinways à Claude via MCP

Voici la synthèse opérationnelle pour mettre en place et utiliser le connecteur MCP Joinways avec Claude.

---

1. Informations clés

• Endpoint MCP : https://mcp.joinways.app
• Nom du serveur : joinways
• Version : 1.0.0
• Transport : Streamable HTTP
• Auth supportées :
  • OAuth 2.1 (PKCE) — recommandé
  • Jeton d’accès personnel (PAT) — Authorization: Bearer jw_...
• Scopes : mcp.read, mcp.write
• Quota : 60 requêtes/min par token (burst 120/min)
• Timeout par requête : 60 s
• Plan requis : Joinways Pro (ou essai Pro)
• Résidence des données : UE (Francfort)

---

2. Capacités de Claude avec Joinways

Claude peut, en langage naturel, lire et agir sur votre workspace Joinways :

• Leads & demandes :
  • Lister les demandes récentes
  • Qualifier un lead (disponibilité, budget cohérent)
  • Rédiger des réponses personnalisées
  • Convertir un lead en événement confirmé
• Événements & calendrier :
  • Lister/filtrer les événements par date, lieu, statut
  • Créer des événements (option, confirmé, etc.)
  • Trouver les événements à relancer (sans devis signé, etc.)
  • Ajouter des notes internes horodatées
• Devis & BEO :
  • Créer des devis à partir du catalogue
  • Modifier les lignes de devis, mettre à jour le statut
  • Mettre à jour les BEO (timing, diététique, etc.)
  • Préparer des relances de devis
• Emails :
  • Lire les fils d’emails liés à un événement
  • Générer des brouillons
  • Envoyer des emails depuis votre Gmail/Outlook connecté
• Analytics & administration :
  • Consulter les rapports commerciaux, événements, comptabilité
  • Comparer périodes (taux de conversion, revenu moyen par mariage, etc.)
  • Lister les membres d’équipe, vérifier qui a connecté son email

Sécurité d’action : toute opération en écriture (création, mise à jour, suppression, envoi) est prévisualisée et nécessite votre confirmation dans le client, sauf si vous avez explicitement activé un mode « toujours autoriser ».

---

3. Inventaire des outils MCP Joinways

Événements (8)

• list_events
• get_event
• create_event
• update_event