Passer au contenu principal

Connecter Smartsupp à Google Gemini

Connectez votre compte Smartsupp à Google Gemini et exploitez vos données de chat en direct à l’aide de requêtes en langage naturel.

Écrit par Michal Jindra

Connectez Smartsupp à Google Gemini et exploitez vos données de chat en direct sur simple demande. Au lieu de parcourir le tableau de bord, vous saisissez une phrase simple — Gemini trouve les informations, les résume ou effectue l’action pour vous.

Gemini ne dispose pas de section dédiée aux connecteurs dans son application web (contrairement à ChatGPT ou Claude), la connexion passe donc par Gemini CLI — une application officielle gratuite de Google qui s’exécute dans le terminal. Ne vous inquiétez pas si vous n’avez jamais utilisé de terminal : la configuration se résume à quelques commandes à copier-coller et ne doit être effectuée qu’une seule fois.

Nous avons divisé cet article en plusieurs sections :


Avant de commencer

Vous aurez besoin de :

  • Node.js 20 ou une version ultérieure installé sur votre ordinateur. Vérifiez en exécutant node -v dans votre terminal, ou téléchargez-le sur nodejs.org.

  • Un compte Google pour créer une clé API Gemini gratuite. Contrairement à ChatGPT, vous n’avez pas besoin d’un forfait payant.

  • Vos identifiants de connexion Smartsupp — pendant la configuration, vous vous connecterez à votre compte Smartsupp pour approuver la connexion.

🟡 Prérequis : Le serveur MCP Smartsupp est disponible avec le forfait Plus et les forfaits supérieurs.


Configurer la connexion

1. Installez Gemini CLI. Ouvrez votre terminal (sur Mac : l’application Terminal, sur Windows : PowerShell) et exécutez :

npm install -g @google/gemini-cli

2. Créez votre clé API Gemini. Accédez à Google AI Studio, connectez-vous avec votre compte Google et cliquez sur Créer une clé API. Copiez la clé — vous en aurez besoin à l’étape suivante.

3. Enregistrez la clé API. Exécutez cette commande dans votre terminal (remplacez your-key-here par la clé que vous avez copiée) :

mkdir -p ~/.gemini && echo 'GEMINI_API_KEY=your-key-here' >> ~/.gemini/.env

4. Ajoutez la connexion Smartsupp. Ouvrez le fichier ~/.gemini/settings.json dans un éditeur de texte de votre choix (créez-le s’il n’existe pas) et collez :

{  "mcpServers": {    "smartsupp": {      "command": "npx",      "args": ["mcp-remote", "https://mcp.smartsupp.com/mcp"],      "timeout": 30000    }  },  "security": {    "auth": { "selectedType": "gemini-api-key" }  }}

5. Lancez Gemini. Exécutez gemini dans votre terminal. Si Gemini vous demande comment vous souhaitez vous connecter, choisissez Utiliser une clé API Gemini.

6. Vérifiez la connexion. Dans Gemini, saisissez /mcp. Vous devriez voir :

🟢 smartsupp – Ready (19 tools)


​7. Autorisez la connexion. La première fois que vous posez une question sur vos données Smartsupp, une page de connexion Smartsupp s’ouvre dans votre navigateur. Connectez-vous pour approuver l’accès — vous approuvez la connexion en vous connectant, et Gemini ne voit jamais votre mot de passe Smartsupp.

⚠️ Remarque : L’autorisation utilise automatiquement le compte Smartsupp auquel vous êtes actuellement connecté dans votre navigateur. Si vous gérez plusieurs comptes Smartsupp, vérifiez bien que vous êtes connecté au bon compte avant d’autoriser l’accès.

8. Vérifiez que tout fonctionne. Essayez une requête simple, par exemple "Lister tous les opérateurs de mon compte Smartsupp." Si Gemini vous répond avec la liste de vos opérateurs, la connexion est opérationnelle.


Ce que vous pouvez faire

Une fois connecté, Gemini peut lire vos données Smartsupp et gérer votre boîte de réception selon vos instructions. Il vous suffit d’écrire ce dont vous avez besoin sous forme d’une phrase ordinaire :

  • "Résumer les conversations d’hier et mettre en évidence celles qui nécessitent encore une réponse."

  • "Quelles conversations sont encore ouvertes ?"

  • "Combien de nouvelles conversations avons-nous eues la semaine dernière par rapport à la semaine précédente ?"

Cas d’utilisation courants (avec des exemples de requêtes) :

⚠️ Les réponses et les actions sont réelles. Un message que vous envoyez par l’intermédiaire de votre assistant IA arrive dans le chat du client, et la clôture, l’attribution ou l’ajout de tags modifie la boîte de réception pour toute votre équipe. Lisez ce que votre assistant s’apprête à faire avant qu’il ne passe à l’action, surtout lorsqu’il intervient sur de nombreuses conversations à la fois.

💡 Plus d’exemples de requêtes, ce qui reste dans Smartsupp et la façon dont vos données sont traitées : Gérer votre boîte de réception Smartsupp depuis votre assistant IA.


Bon à savoir

  • Gemini utilise vos données Smartsupp réelles. Vous approuvez l’accès en vous connectant (OAuth) — Gemini ne voit jamais votre mot de passe.

  • La lecture (vues d’ensemble, statistiques, contacts) est entièrement disponible. Les actions (réponses, tags, attributions) ne sont effectuées que lorsque vous les demandez — et Gemini vous demande de confirmer avant de les exécuter.

  • Changer de compte Smartsupp : fermez Gemini, supprimez le dossier ~/.mcp-auth (exécutez rm -rf ~/.mcp-auth), relancez Gemini et connectez-vous avec l’autre compte.


Dépannage

  • Erreur 401 lorsque vous commencez à discuter : Gemini CLI lit le fichier .env dans le dossier depuis lequel vous l’exécutez. Si ce dossier possède son propre .env sans GEMINI_API_KEY, la clé n’est pas détectée. Ajoutez aussi la clé à ce fichier, ou lancez Gemini depuis votre dossier personnel.

  • smartsupp affiche Déconnecté : saisissez /mcp auth smartsupp dans Gemini. Si cela ne résout pas le problème, supprimez ~/.mcp-auth et réessayez.

  • npm install échoue avec une erreur de permissions (EACCES) : ignorez l’installation et exécutez Gemini directement avec npx @google/gemini-cli.


Et ensuite ?

💡 Besoin d’aide supplémentaire ? Contactez notre Équipe d’assistance — nous serons ravis de vous aider !

Avez-vous trouvé la réponse à votre question ?