Connecter Minds à Gemini CLI : extension et configuration MCP
Installez l'extension Minds avec gemini extensions install https://github.com/minds-ai-co/minds-mcp, ou ajoutez https://getminds.ai/mcp avec gemini mcp add, puis connectez-vous à Minds via OAuth. Pour Google Antigravity, suivez le guide Antigravity.
Minds est la plateforme de bout en bout pour la recherche synthétique commerciale. Avec Gemini CLI, vous retrouvez vos Audiences, planifiez une Study, vérifiez le plan de recherche proposé et lisez les résultats depuis votre terminal. Gemini CLI communique avec le serveur MCP de Minds à l'adresse https://getminds.ai/mcp, et vous vous connectez avec votre compte Minds via OAuth.
Prérequis
- Gemini CLI installé et connecté avec une clé API Gemini, Vertex AI ou une licence Gemini Code Assist Standard ou Enterprise. Depuis juin 2026, Gemini CLI ne sert plus les comptes Google personnels ; Google oriente les utilisateurs individuels vers Antigravity CLI, voir Minds dans Google Antigravity.
- Un compte Minds. Si vous n'en avez pas, vous pouvez vous inscrire lors de la première connexion.
- Un navigateur sur le même ordinateur pour la connexion OAuth, ou une clé API Minds pour les environnements sans navigateur.
Quelle option choisir ?
| Option | Quand | Connexion |
|---|---|---|
| Extension Minds (recommandé) | Vous voulez Minds et ses consignes de recherche en une seule étape. Disponible dans la galerie d'extensions Gemini CLI. | OAuth avec votre compte Minds |
| Serveur MCP | Vous gérez vous-même vos serveurs MCP, par projet ou pour votre utilisateur, ou vous avez besoin d'une clé API. | OAuth ou clé API Minds |
| Google Antigravity | Vous utilisez Antigravity 2.0, l'IDE Antigravity ou Antigravity CLI (agy). | OAuth ou clé API Minds |
Utilisez une seule option par configuration. L'extension et une entrée manuelle enregistrent toutes deux un serveur nommé minds ; n'en gardez qu'une.
Option A : installer l'extension Minds
1. Installer
gemini extensions install https://github.com/minds-ai-co/minds-mcp
Gemini CLI indique ce que l'extension ajoute : le serveur MCP distant minds à l'adresse https://getminds.ai/mcp et le fichier de contexte GEMINI.md, qui demande à l'agent de clarifier la question de recherche et de faire valider un plan d'étude avant de lancer une exécution. Confirmez avec Y. Si le dossier actuel n'est pas encore approuvé, Gemini CLI vous demande d'abord de lui faire confiance.
2. Vérifier l'installation
gemini extensions list
minds-mcp apparaît avec le serveur MCP minds. Tant que vous n'êtes pas connecté, gemini mcp list affiche le serveur comme déconnecté.
3. Se connecter à Minds
Lancez gemini. À la première connexion, Gemini CLI ouvre la page de connexion Minds dans votre navigateur ; connectez-vous et choisissez Allow. Pour lancer la connexion vous-même, ou vous reconnecter plus tard, exécutez /mcp auth minds dans la session. /mcp list affiche ensuite Minds comme connecté, avec ses outils.
4. Tenir à jour
gemini extensions update minds-mcp
Option B : ajouter Minds comme serveur MCP
Ajoutez le serveur pour votre utilisateur afin qu'il soit disponible dans tous les dossiers :
gemini mcp add --scope user --transport http minds https://getminds.ai/mcp
Sans --scope user, Gemini CLI écrit l'entrée dans .gemini/settings.json du projet courant. Vous pouvez aussi modifier ~/.gemini/settings.json vous-même. Pour le HTTP en streaming, utilisez httpUrl ; url sélectionne l'ancien transport SSE :
{
"mcpServers": {
"minds": { "httpUrl": "https://getminds.ai/mcp" }
}
}
Lancez gemini et connectez-vous comme à l'étape 3 de l'option A.
OAuth ou clé API ?
- OAuth (recommandé) : vous vous connectez avec votre compte Minds. Gemini CLI s'enregistre automatiquement auprès de Minds, vous n'avez donc besoin ni d'identifiant client ni de secret, et chaque personne connecte son propre compte.
- Clé API : pour les environnements sans navigateur, par exemple une tâche CI ou un compte de service partagé. Créez une clé dans Settings → API Keys et ajoutez-la comme en-tête :
gemini mcp add --scope user --transport http --header "Authorization: Bearer minds_YOUR_API_KEY" minds https://getminds.ai/mcp
La clé est enregistrée en clair dans settings.json. Ne versionnez pas ce fichier et préférez OAuth sur les ordinateurs personnels.
Option C : Google Antigravity
Antigravity a sa propre configuration : les serveurs distants se déclarent avec serverUrl dans ~/.gemini/config/mcp_config.json ou .agents/mcp_config.json, et la connexion passe par Settings → Customizations → Authenticate. Le guide Antigravity couvre les trois interfaces d'Antigravity.
Vous passez de Gemini CLI à Antigravity CLI ? agy plugin import gemini convertit l'extension Minds installée en plugin Antigravity avec le même serveur.
Application Gemini et Gemini Enterprise
Google documente aussi des connexions MCP personnalisées dans l'application Gemini (comptes personnels aux États-Unis) et dans Gemini Enterprise. Minds ne peut pas encore y être connecté. Utilisez Gemini CLI ou Google Antigravity jusqu'à ce que Minds prenne en charge ces connecteurs.
Comment Minds fonctionne dans Gemini CLI
- Planifier d'abord : avant toute exécution, l'agent vous soumet le plan de recherche pour validation. Une Study ne démarre qu'après votre confirmation.
- Les longues exécutions continuent sur le serveur : les Studies s'exécutent durablement chez Minds et continuent si vous fermez le terminal. Demandez plus tard leur statut à Gemini CLI.
- Aller plus loin dans Minds : les résultats renvoient à la Study dans Minds, où vous examinez les réponses individuelles, comparez des Audiences et exportez les résultats.
Les outils que Gemini CLI peut utiliser sont listés dans la référence des outils. La vue d'ensemble MCP explique l'intégration dans son ensemble.
Dépannage
Minds apparaît comme déconnecté. Exécutez /mcp auth minds dans une session Gemini CLI et terminez la connexion dans le navigateur.
La page de connexion ne s'ouvre pas. Gemini CLI reçoit le retour OAuth sur un port local, le navigateur doit donc tourner sur le même ordinateur. Via SSH ou dans un conteneur, utilisez plutôt une clé API.
Deux serveurs Minds ou des outils en double. L'extension et une entrée manuelle sont toutes deux actives. Supprimez-en une avec gemini extensions uninstall minds-mcp ou gemini mcp remove minds.
« Not authorized » pour une Study ou une Audience que vous pouvez ouvrir dans Minds. Gemini CLI est connecté à un autre compte Minds que celui qui possède la Study. Relancez /mcp auth minds avec le bon compte, ou partagez la Study avec le compte connecté.
Les nouveaux outils Minds n'apparaissent pas. Redémarrez Gemini CLI pour recharger la liste des outils, et exécutez gemini extensions update minds-mcp si vous utilisez l'extension.
D'autres clients comme ChatGPT, Claude et Codex figurent dans la vue d'ensemble des intégrations.
URL du serveur MCP
https://getminds.ai/mcp
