Introduction à Gemini CLI et aux Serveurs MCP

Ce guide complet explique comment installer l'outil en ligne de commande **Gemini CLI** sur Windows et comment l'étendre avec des **serveurs MCP (Model Context Protocol)**, en se concentrant sur le plus puissant d'entre eux pour l'écosystème Google : **`ggsrun`**.

Étape 1 : Prérequis Indispensables

• Node.js (v20+): Télécharger
• Git: Télécharger
• Go: Télécharger
• Google Cloud SDK: Installer

Étape 2 : Installation de Gemini CLI

Ouvrez une Invite de commandes (CMD) ou PowerShell et exécutez :

npm install -g @google/gemini-cli

Étape 3 : Authentification Principale

Cette authentification via Google Cloud est la base pour que les outils puissent agir en votre nom.

gcloud auth application-default login

Suivez les instructions qui s'ouvrent dans votre navigateur.

Étape 4 : Intégrer Google Workspace avec le MCP `ggsrun`

Le MCP `ggsrun` est un outil communautaire qui sert de pont entre Gemini CLI et les API Google Workspace. C'est la méthode la plus fiable et la plus complète.

4.1 Créer les Accès (ID Client OAuth)

`ggsrun` a besoin de sa propre autorisation pour agir en votre nom. Vous devez créer un "ID client OAuth 2.0".

1. Allez dans la Google Cloud Console > APIs & Services > Identifiants.
2. Cliquez sur + CRÉER DES IDENTIFIANTS et choisissez ID client OAuth.
3. Sélectionnez Application de bureau et donnez-lui un nom.
4. Cliquez sur CRÉER, puis sur TÉLÉCHARGER LE JSON. Renommez le fichier téléchargé en `client_secret.json`.

4.2 Activer les APIs Google Workspace

C'est une étape cruciale. Vous devez activer chaque API que vous souhaitez utiliser sur votre projet Google Cloud.

1. Allez à la Bibliothèque d'APIs de Google Cloud.
2. Recherchez et activez ("Enable") les APIs dont vous avez besoin :
   • Google Drive API
   • Google Docs API
   • Google Sheets API
   • Google Calendar API
   • Gmail API

4.3 Installer et Autoriser `ggsrun`

# 1. Cloner le dépôt
git clone https://github.com/tanaikech/ggsrun.git

# 2. Naviguer dans le dossier
cd ggsrun

# 3. Installer l'outil
go install .

Placez votre fichier `client_secret.json` dans le dossier `ggsrun` cloné, puis exécutez la commande d'autorisation :

ggsrun auth

Suivez les instructions dans le navigateur pour autoriser `ggsrun` à accéder à vos données.

4.4 Configurer `settings.json`

Enfin, ajoutez ce serveur à votre fichier `settings.json`. Il servira de point d'entrée unique pour toutes les commandes Workspace.

"workspace": {
  "command": "ggsrun",
  "args": ["{{prompt}}"],
  "auth": true
}

Étape 5 : Exemples d'Utilisation

Une fois le serveur `workspace` configuré, lancez `gemini` et vérifiez son statut avec `/mcp`. Voici ce que vous pouvez faire.

@workspace drive list the last 3 files in my Drive
@workspace drive create a new folder named "Projets Gemini"

@workspace sheets create a spreadsheet named "Budget Q4" with headers "Item,Cost,Date"

@workspace docs create a document titled "Meeting Notes" with the content "Attendees: Stéphane"

@workspace calendar create an event for "Team Sync" tomorrow at 10am for 1 hour

@workspace gmail create a draft to "test@example.com" with subject "Hello" and body "This is a test"

Conclusion

Grâce au serveur MCP `ggsrun`, vous avez transformé votre Gemini CLI en une puissante interface de contrôle pour Google Workspace. Vous pouvez désormais gérer vos documents, e-mails, fichiers et événements en utilisant des commandes en langage naturel, le tout depuis votre terminal.