10-0. Exploration : MCP, Google Sheets et Gemini Enterprise

Ce guide répond à :

1. Qu'est-ce que MCP, et qu'apporte un serveur MCP Google Sheets par rapport aux agents du projet 09 ?
2. Par quels chemins Gemini Enterprise peut-il utiliser un serveur MCP ? Lequel choisir ?
3. Qui appelle qui, avec quel jeton ? Qu'est-ce qui empêche un accès non voulu ?
4. Qu'est-ce qui a été vérifié en vrai, et qu'est-ce qui reste à faire sur votre projet ?

Les guides suivants (10-1 à 10-10) font chaque étape, pas à pas.

Sommaire

1. MCP en 2 minutes
2. Les 4 chemins vers Gemini Enterprise
3. Lequel choisir ?
4. Les jetons : qui prouve quoi
5. Ce que contient ce dossier
6. Ce qui a été vérifié, et ce qui reste à faire
7. L'ordre des guides
8. Sources

1. MCP en 2 minutes

Au projet 09, chaque outil (lire_emails, sheets_ecrire…) était une fonction Python dans l'agent. Pour qu'un autre agent, Claude, Gemini CLI ou Gemini Enterprise lui-même utilise les mêmes outils, il faudrait les recopier.

MCP (Model Context Protocol) est un standard ouvert qui met les outils dans un serveur à part. Tout client MCP peut alors :

• demander tools/list : « quels outils as-tu ? » (nom, description, paramètres, et indications lecture ou destructif) ;
• demander tools/call : « exécute read_range avec {spreadsheet_id, range_a1} ».

  Gemini Enterprise (connecteur) ─┐
  Agent ADK (A2A / Agent Runtime) ─┼── MCP, JSON-RPC sur HTTPS ──▶ serveur MCP « sheets-mcp » ──▶ API Google Sheets
  Claude, Gemini CLI, Inspector  ─┘     (Streamable HTTP, /mcp)      Cloud Run, PRIVÉ             (jeton de l'utilisateur)

Les mots à connaître :

• Outil (tool), qui s'appelle action dans Gemini Enterprise : une fonction que le modèle peut appeler.
• Streamable HTTP : le transport réseau de MCP, une URL qui finit en /mcp. Gemini Enterprise n'accepte que celui-là (l'ancien SSE est refusé).
• Annotations : readOnlyHint (lecture) et destructiveHint (écrase ou supprime). Gemini Enterprise demande une confirmation avant chaque action, sauf pour celles marquées en lecture seule.

Un 2e serveur, Google Slides (20 outils), suit exactement les mêmes chemins : 10-13.

Notre serveur Sheets a 17 outils : il peut lire, chercher, écrire, ajouter des lignes, effacer, créer des classeurs, gérer les onglets, mettre en forme, et appeler toute l'API Sheets avec batch_update. Chaque appel se fait avec le jeton de l'utilisateur : il ne voit et ne modifie que ce que ses droits Drive permettent.

2. Les 4 chemins vers Gemini Enterprise

                         ┌──────────────── chemin 1 : connecteur natif (actions) ────────────────┐
 Utilisateur ─▶ App GE ──┤                                                                       ├─▶ sheets-mcp ─▶ Sheets
   (chat)    (projet app)└─ chemin 2 : agent « Assistant Google Sheets » (A2A / Agent Runtime) ─┘   (projet des agents)
                         └──────────── chemin 3 : sheetsmcp.googleapis.com (Google, preview) ───────────────────▶ Sheets
                                                    chemin 4 : Agent Registry = le catalogue (déclare sheets-mcp)

3. Lequel choisir ?

Notre recommandation pour Acme :

• Chemin 1 pour tout le monde. Activez d'abord les 6 outils de lecture, puis les écritures, une fois les usages observés.
• Chemin 2 pour les assistants métier.
• Chemin 4 dans tous les cas.

Les chemins 1 et 2 partagent le même serveur et le même client OAuth.

4. Les jetons : qui prouve quoi

À chaque appel au serveur MCP, deux jetons voyagent, avec deux rôles différents :

Ensuite, le serveur appelle Google Sheets avec le jeton de l'utilisateur. Le compte du serveur n'a aucun rôle.

• Chemin 1 : Gemini Enterprise met lui-même les deux en-têtes pour une URL *.run.app (documentation Google).
• Chemin 2 : c'est l'agent qui les met. Son code (header_provider) ajoute son propre jeton d'identité, et transmet le jeton de l'utilisateur que l'app lui a confié.

5. Ce que contient ce dossier

10-mcp-google-sheets-gemini-enterprise/
├── mcp_server/              le serveur MCP (17 outils, vérification du jeton, journal d'audit) + Dockerfile
├── agent/                   l'agent ADK « Assistant Google Sheets » : sheets_agent/, main.py (A2A), carte.py
├── config/10-mcp.env        la configuration (projet, région, app, clients OAuth, domaines)
├── scripts/                 config.sh, deployer.sh (toutes les étapes), fiche.py, gen_toolspec.py, deployer_agent_runtime.py
├── terraform/               la même chose en Terraform (Cloud Build, Cloud Run, Agent Runtime, IAM, Agent Registry)
├── tests/                   test_server.py (simulé), test_reel.py, test_agent_chaine.py, appel_a2a.py, appel_runtime.py
└── docs/                    10-0 … 10-10 (ce guide et les suivants)

Repris et amélioré depuis 04-mcp-server-cloud-run-registry/sheets-mcp (le serveur) et le projet 09 (A2A, Agent Runtime, OAuth, Cloud Build sans Docker).

6. Ce qui a été vérifié, et ce qui reste à faire

Vérifié en vrai (13 et 14 octobre 2026). Deux projets de test : second-project (agents) et main-project (app). Ils n'ont pas d'organisation et pas d'app Gemini Enterprise.

Problèmes réels trouvés et corrigés en déployant (ils n'apparaissaient pas en local) :

1. Image de l'agent : McpToolset ne s'importait pas, parce que google-adk n'installe pas le paquet mcp. Il est maintenant dans agent/requirements.txt.
2. Agent Registry : chaque outil doit avoir son inputSchema. gen_toolspec.py l'ajoute maintenant, en JSON compact, sous les 10 Ko.
3. Terraform sur un projet neuf : il faut l'API Cloud Resource Manager active avant Terraform. C'est une commande (10-3, 2.1 bis), et le numéro du projet est maintenant donné et non plus lu.
4. Locale fr_FR : les formules utilisent ; et , (10-1, partie 6).
5. fastmcp 4.x : le cache maison du serveur du dossier 04 était en conflit avec la bibliothèque. C'est corrigé.

Ce qui ne se vérifie que chez Acme (organisation et app) :

• les règles d'organisation ;
• le client OAuth « Interne » ;
• le connecteur dans l'app ;
• l'ajout de l'agent ;
• le premier « Autoriser ».

La liste exacte, projet par projet, est dans le README.

7. L'ordre des guides

8. Sources

• Custom MCP Server dans Gemini Enterprise
• Enregistrer des serveurs MCP dans Agent Registry
• ADK : configuration avancée des outils MCP (header_provider)
• Serveur MCP Google Sheets (officiel, preview)
• Produits Google avec serveur MCP
• API Google Sheets v4