Connecter Gemini CLI à votre studio

De quoi s’agit-il

Gemini CLI est l’outil Gemini de Google qui s’exécute dans le terminal de votre ordinateur. Grâce au connecteur d’IA, il consulte les données de votre studio (ventes, clients, agenda, finances) lorsque vous lui posez une question, avec les autorisations de l’utilisateur associé à la clé. Il ne fait que consulter les données : il ne modifie rien dans le système.

Quand l’utiliser

Vous utilisez déjà Gemini dans le terminal et souhaitez poser des questions sur l’activité du studio sans ouvrir le système.
Vous souhaitez croiser les chiffres du système avec d’autres tâches que Gemini effectue pour vous.

Avant de commencer

Munissez-vous de l’adresse du connecteur, que vous avez copiée en suivant l’article Connecter votre IA, et d’une clé API autorisant son utilisation comme connecteur d’IA. Gemini CLI doit être installé sur votre ordinateur. Vous pouvez aussi vous connecter avec votre compte système : sans l’en-tête de la clé, saisissez /mcp auth heya dans Gemini CLI et connectez-vous sur la page qui s’ouvre.

Étape par étape

Étape 1 — Ajouter le connecteur

Dans le terminal, exécutez la commande ci-dessous en remplaçant l’adresse par celle que vous avez copiée dans Copier l’adresse et hk_... par votre clé :

gemini mcp add --transport http --header "Authorization: Bearer hk_..." heya https://seu-dominio/mcp

Pour l’utiliser dans tous les dossiers de l’ordinateur, ajoutez -s user. Si vous préférez modifier le fichier de configuration (~/.gemini/settings.json), ajoutez ce bloc :

{
  "mcpServers": {
    "heya": {
      "httpUrl": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

Utilisez httpUrl, et non url : dans Gemini CLI, url correspond à l’ancien format de connexion et ne fonctionne pas avec le connecteur.

Étape 2 — Vérifier la connexion

Ouvrez Gemini CLI et saisissez /mcp. Le connecteur heya doit apparaître comme CONNECTED, avec les outils listar_areas, buscar_ferramentas et executar_consulta.

Étape 3 — Poser une question

Posez par exemple la question suivante : « Quelles dépenses arrivent à échéance cette semaine dans le studio ? »

Et ensuite

Gemini trouve la requête adaptée à votre question, l’exécute et vous répond avec les chiffres du système.
La date de Dernière utilisation est mise à jour dans l’onglet API Key.
Pour révoquer l’accès, révoquez la clé dans l’onglet API Key : Gemini perdra l’accès dans un délai de 30 secondes.

Erreurs fréquentes et questions

Q : Gemini fonctionne-t-il dans le navigateur (gemini.google.com) ? R : Pas encore. Gemini dans le navigateur demande une connexion spécifique au lieu d’une clé API. Utilisez Gemini CLI.

Q : /mcp affiche DISCONNECTED. Que faire ? R : Vérifiez que vous avez utilisé httpUrl (et non url), que l’adresse se termine par /mcp et que vous avez collé la clé en entier, avec Bearer suivi d’une espace.

Q : Gemini indique que la clé doit autoriser son utilisation comme connecteur d’IA. Pourquoi ? R : La clé a été créée sans cette option. Modifiez-la dans l’onglet API Key et cochez Autoriser l’utilisation comme connecteur d’IA.

Q : Mon Gemini CLI est devenu Antigravity CLI. Est-ce que la procédure s’applique ? R : Google a remplacé Gemini CLI par Antigravity CLI pour certains comptes. Cherchez l’option permettant d’ajouter un serveur MCP par HTTP avec un en-tête : l’adresse et l’en-tête Authorization: Bearer hk_... restent les mêmes.

Q : Puis-je enregistrer la clé dans un fichier du projet ? R : Évitez de le faire. Le fichier .gemini/settings.json du dossier du projet est souvent ajouté au contrôle de version, ce qui exposerait la clé. Préférez le fichier de votre compte utilisateur (~/.gemini/settings.json).