Passer au contenu principal

Connecter Smartsupp à Google Gemini

Associez votre compte Smartsupp à Google Gemini et exploitez les données de votre chat en direct grâce à des requêtes en langage naturel.

Écrit par Michal Jindra

Connectez Smartsupp à Google Gemini et exploitez vos données de chat en direct en toute simplicité, simplement en posant votre question. Au lieu de parcourir le tableau de bord, saisissez votre demande en langage courant — Gemini trouve, résume ou exécute ce dont vous avez besoin.

Gemini n’a pas de section « connecteurs » dans son application web (contrairement à ChatGPT ou Claude), la connexion se fait donc via Gemini CLI — l’application officielle et gratuite de Google, à utiliser dans le terminal. Pas d’inquiétude si vous n'avez encore jamais utilisé de terminal : l’installation se limite à quelques commandes à copier-coller, et ne s’effectue qu’une seule fois.

Nous avons organisé l'article en plusieurs parties :


Avant de commencer

Pour commencer, il vous faut :

  • Node.js 20 ou version ultérieure installé sur votre ordinateur. Pour vérifier, saisissez node -v dans le terminal ou téléchargez-le depuis nodejs.org.

  • Un compte Google afin de créer gratuitement une clé API Gemini. Contrairement à ChatGPT, aucun abonnement payant n’est nécessaire.

  • Vos identifiants Smartsupp — au cours de la configuration, connectez-vous à votre compte Smartsupp pour autoriser l’accès.

🟡 Exigence : Le serveur MCP de Smartsupp est accessible avec l’offre Plus ou supérieure.


Configurer la connexion

1. Installer Gemini CLI. Ouvrez le terminal (sur Mac : application Terminal, sur Windows : PowerShell) puis lancez :

npm install -g @google/gemini-cli

2. Créer la clé API Gemini. Accédez à Google AI Studio, connectez-vous à votre compte Google puis cliquez sur Créer une clé API. Copiez la clé pour l’étape suivante.

3. Enregistrer la clé API. Saisissez cette commande dans le terminal (remplacez your-key-here par votre clé copiée) :

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

4. Ajouter la connexion Smartsupp. Ouvrez le fichier ~/.gemini/settings.json dans votre éditeur de texte préféré (créez-le s’il n’existe pas) et collez le contenu suivant :

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

5. Démarrer Gemini. Saisissez gemini dans le terminal. Si vous êtes invité à choisir un mode de connexion, sélectionnez Utiliser une clé API Gemini.

6. Vérifier la connexion. Dans Gemini, tapez /mcp. Le message suivant doit s’afficher :

🟢 smartsupp – Prêt (19 outils)


​7. Autoriser la connexion. Lors de la première demande sur vos données Smartsupp, une page de connexion Smartsupp s’ouvre dans votre navigateur. Connectez-vous pour approuver l’accès — vous autorisez la connexion en validant votre session, et Gemini n’accède jamais à votre mot de passe Smartsupp.

⚠️ Remarque : L’autorisation utilise automatiquement le compte Smartsupp sur lequel vous êtes connecté dans votre navigateur. Si vous gérez plusieurs comptes Smartsupp, assurez-vous d’être sur le bon profil avant de valider.

8. Confirmer le bon fonctionnement. Effectuez un essai, par exemple « Lister tous les agents de mon compte Smartsupp. » Si Gemini vous répond avec la liste, la connexion est active.


Ce que vous pouvez faire

Une fois la connexion établie, Gemini consulte vos données Smartsupp et gère votre boîte de réception selon vos instructions. Il suffit d’écrire naturellement ce dont vous avez besoin :

  • « Résumez les conversations d’hier et mettez en avant celles en attente de réponse. »

  • « Quelles conversations sont encore ouvertes ? »

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

Voici quelques usages fréquents, accompagnés de suggestions de requêtes :

⚠️ Les réponses et actions sont effectives. Un message envoyé depuis votre assistant IA sera transmis au chat client, et toute action de clôture, d'attribution ou d’étiquetage impactera la boîte de réception de toute votre équipe. Lisez attentivement les propositions de l'assistant avant validation, surtout lors d’actions multiples.

💡 Plus d’exemples de requêtes, ce qui reste dans Smartsupp et le traitement de vos données : Travailler avec la boîte de réception Smartsupp depuis l’assistant IA.


Bon à savoir

  • Gemini traite vos données Smartsupp réelles. Vous validez l’accès via la connexion (OAuth) — Gemini n’obtient jamais votre mot de passe.

  • La lecture (rapports, statistiques, contacts) est totalement disponible. Les actions (répondre, étiqueter, attribuer) ne sont réalisées que sur demande — et Gemini sollicite votre confirmation avant chaque exécution.

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


Dépannage

  • Erreur 401 lors de l’ouverture du chat : Gemini CLI utilise le fichier .env du dossier en cours. Si ce dossier possède un .env sans la variable GEMINI_API_KEY, la clé n’est pas prise en compte. Ajoutez la clé dans ce fichier, ou lancez Gemini depuis votre dossier personnel.

  • Smartsupp affiche Déconnecté : tapez /mcp auth smartsupp dans Gemini. Si besoin, supprimez ~/.mcp-auth puis réessayez.

  • npm install échoue avec une erreur de permission (EACCES) : ignorez l'installation et lancez Gemini directement avec npx @google/gemini-cli.


Et ensuite ?

💡 Vous avez besoin d’aide ? Contactez notre équipe d’assistance — nous sommes là pour vous accompagner !

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