Guide de connexion · MCP Ekklo

Connecter Ekklo à Claude ou ChatGPT

Retrouvez vos clients, programmes, plans nutritionnels et rendez-vous depuis votre assistant, grâce au connecteur MCP de votre espace coach.

Avant de commencer

Connectez-vous à votre compte coach Ekklo et à votre compte Claude ou ChatGPT. L’accès MCP et le volume d’appels dépendent de votre offre Ekklo ; retrouvez vos droits et votre consommation dans l’espace Intégrations de votre compte. L’abonnement et les règles de votre assistant sont gérés par son éditeur.

Quel accès donnez-vous à l’assistant ?

Le consentement Ekklo donne accès à la lecture ekklo:read et à la modification ekklo:write des données accessibles à votre compte coach. Cela couvre notamment vos clients, leur suivi, vos programmes, la nutrition et les données de votre activité. L’écran de connexion présente ces droits avant validation.

L’assistant peut utiliser des outils qui créent, modifient ou suppriment des données, ou qui envoient des messages. Les demandes de confirmation dépendent aussi des permissions réglées dans votre assistant. Pour commencer, utilisez les exemples de consultation ci-dessous et vérifiez l’espace connecté.

Les informations renvoyées sont accessibles à l’assistant choisi. Consultez la politique de confidentialité Ekklo et celle de votre assistant pour connaître le traitement des données.

Une adresse, deux façons de se connecter

Copiez cette adresse complète dans le champ « URL du serveur MCP » de votre assistant :

Serveur MCP Ekklohttps://api.prod.ekklo.com/api/v1/mcp

Dans Claude

  1. Ouvrez Personnaliser / Customize, puis Connecteurs / Connectors.
  2. Ajoutez un connecteur personnalisé nommé « Ekklo » avec l’adresse ci-dessus.
  3. Si un choix d’authentification apparaît, choisissez OAuth et l’enregistrement automatique du client. Ekklo prend en charge ce mode ; aucun secret à recopier.
  4. Cliquez sur Connecter, identifiez-vous dans Ekklo, vérifiez le compte et les droits, puis validez si vous souhaitez accorder cet accès. Dans le chat, activez Ekklo depuis le menu +, puis Connecteurs.
Consulter le guide officiel Claude

Dans ChatGPT

  1. Ouvrez Plugins, puis + et Ajouter un serveur MCP personnalisé.
  2. Nommez-le « Ekklo », entrez l’adresse ci-dessus et choisissez OAuth. Suivez les étapes de création et d’installation du plugin.
  3. Connectez le plugin à votre compte Ekklo. Vérifiez le compte et les droits sur l’écran Ekklo avant d’autoriser l’accès.
  4. Ouvrez un nouveau chat, tapez @ et sélectionnez votre plugin Ekklo.
Consulter le guide officiel ChatGPT

Les intitulés peuvent varier selon votre compte. Dans un espace d’entreprise, l’administrateur peut devoir autoriser l’ajout d’un connecteur. Un connecteur personnalisé se configure par son adresse ; sa présence dans un catalogue public est un sujet distinct.

Trois demandes pour vérifier la connexion

Copiez une demande dans le chat où Ekklo est activé. Remplacez NOM_DU_PROGRAMME par un titre de votre espace. Ces exemples demandent uniquement une consultation.

  1. Vérifie la connexion à mon compte Ekklo et indique quel espace coach est connecté.
  2. Retrouve le programme « NOM_DU_PROGRAMME » dans Ekklo et résume ses séances avec un lien vers la source. Si tu ne le trouves pas, dis-le.
  3. Affiche mes prochains rendez-vous Ekklo, sans les modifier.

Si plusieurs résultats correspondent, précisez le client ou le titre avant de continuer. Pour une liste partielle, demandez la page suivante. Si aucun résultat n’est trouvé, vérifiez le nom et l’espace connecté ; un résultat absent ne doit pas être remplacé par une donnée inventée.

Quotas et limites

Les appels MCP utilisent le quota API/MCP de votre offre Ekklo, distinct des missions Pacco dans l’application. Consultez la consommation de votre compte et la page tarifs pour les volumes actuels. Une limite de fréquence peut aussi interrompre une série d’appels trop rapprochés. Les limites d’usage de Claude ou ChatGPT s’appliquent en parallèle.

La connexion ne fonctionne pas ?

Je ne vois pas l’option pour ajouter un serveur MCP

Vérifiez les règles de votre compte ou de votre espace d’entreprise dans l’assistant. Consultez son guide officiel ci-dessus ou demandez à votre administrateur d’autoriser les connecteurs personnalisés.

Le connecteur affiche « Connecter » ou « Reconnecter »

L’installation du plugin ne termine pas à elle seule la connexion à Ekklo. Relancez Connecter, terminez le parcours Ekklo et revenez dans l’assistant. Une fenêtre de consentement expirée demande un nouveau parcours de connexion.

Le serveur est introuvable ou refuse la connexion

Vérifiez que l’adresse est exactement celle indiquée dans ce guide, avec /api/v1/mcp à la fin. Choisissez OAuth pour la connexion à votre compte. Si le problème persiste, notez le message et l’heure de l’erreur pour le support.

L’assistant ne trouve pas mes données ou n’utilise pas Ekklo

Vérifiez que le connecteur est activé dans la conversation. Commencez par la demande de vérification du compte, puis donnez un nom de client ou de programme précis. Dans ChatGPT, ouvrez un nouveau chat après une actualisation du plugin. Lorsqu’un lien vers une source est proposé, ouvrez-le avec le même compte coach Ekklo.

J’ai une erreur d’accès, de quota ou « 429 »

Pour une erreur d’accès, vérifiez le compte connecté et ses droits MCP dans Ekklo. Pour un quota mensuel atteint, consultez votre consommation et votre offre. Pour une limite de fréquence, attendez le délai indiqué avant de réessayer. Après une opération de modification interrompue, vérifiez son résultat dans Ekklo avant de la demander à nouveau.

Je veux retirer l’accès de mon assistant

Dans Ekklo, ouvrez Intégrations, retrouvez la connexion de l’assistant et révoquez son accès. Vous pouvez également déconnecter Ekklo dans les paramètres des connecteurs ou plugins de l’assistant. Désactiver Ekklo dans un seul chat ne révoque pas la connexion de votre compte.

Besoin d’aide ? Écrivez à support@ekklo.com avec le nom de l’assistant, le message affiché et l’heure du problème. Gardez vos mots de passe et jetons d’accès hors du message.