Conectar Minds con Gemini CLI: extensión y configuración MCP
Instala la extensión de Minds con gemini extensions install https://github.com/minds-ai-co/minds-mcp, o añade https://getminds.ai/mcp con gemini mcp add, e inicia sesión en Minds con OAuth. Para Google Antigravity, sigue la guía de Antigravity.
Minds es la plataforma integral para la investigación sintética comercial. Con Gemini CLI encuentras tus Audiences, planificas una Study, revisas el plan de investigación propuesto y lees los resultados desde tu terminal. Gemini CLI se comunica con el servidor MCP de Minds en https://getminds.ai/mcp e inicias sesión con tu cuenta de Minds mediante OAuth.
Requisitos
- Gemini CLI instalado y con sesión iniciada mediante una clave de API de Gemini, Vertex AI o una licencia de Gemini Code Assist Standard o Enterprise. Desde junio de 2026, Gemini CLI ya no atiende cuentas personales de Google; Google remite a los usuarios individuales a Antigravity CLI, consulta Minds en Google Antigravity.
- Una cuenta de Minds. Si no tienes una, puedes registrarte durante la primera conexión.
- Un navegador en el mismo ordenador para el inicio de sesión OAuth, o una clave de API de Minds para entornos sin navegador.
¿Qué opción te conviene?
| Opción | Cuándo | Inicio de sesión |
|---|---|---|
| Extensión de Minds (recomendada) | Quieres Minds y sus instrucciones de investigación en un solo paso. Aparece en la galería de extensiones de Gemini CLI. | OAuth con tu cuenta de Minds |
| Servidor MCP | Gestionas tú mismo los servidores MCP, por proyecto o para tu usuario, o necesitas una clave de API. | OAuth o clave de API de Minds |
| Google Antigravity | Usas Antigravity 2.0, el IDE de Antigravity o Antigravity CLI (agy). | OAuth o clave de API de Minds |
Usa una sola opción por configuración. La extensión y una entrada manual registran un servidor llamado minds, así que conserva solo una de ellas.
Opción A: instalar la extensión de Minds
1. Instalar
gemini extensions install https://github.com/minds-ai-co/minds-mcp
Gemini CLI muestra lo que añade la extensión: el servidor MCP remoto minds en https://getminds.ai/mcp y el archivo de contexto GEMINI.md, que indica al agente que aclare la pregunta de investigación y confirme un plan de estudio antes de iniciar una ejecución. Confirma con Y. Si la carpeta actual aún no es de confianza, Gemini CLI te pide primero que confíes en ella.
2. Comprobar la instalación
gemini extensions list
minds-mcp aparece con el servidor MCP minds. Hasta que inicies sesión, gemini mcp list muestra el servidor como desconectado.
3. Iniciar sesión en Minds
Inicia gemini. La primera vez que se conecta, Gemini CLI abre la página de inicio de sesión de Minds en tu navegador; inicia sesión y elige Allow. Para iniciar el proceso tú mismo, o volver a iniciar sesión más adelante, ejecuta /mcp auth minds en la sesión. Después, /mcp list muestra Minds como conectado, con sus herramientas.
4. Mantenerla actualizada
gemini extensions update minds-mcp
Opción B: añadir Minds como servidor MCP
Añade el servidor para tu usuario, para que esté disponible en cualquier carpeta:
gemini mcp add --scope user --transport http minds https://getminds.ai/mcp
Sin --scope user, Gemini CLI escribe la entrada en .gemini/settings.json del proyecto actual. También puedes editar ~/.gemini/settings.json tú mismo. Para HTTP transmitible usa httpUrl; url selecciona el transporte SSE anterior:
{
"mcpServers": {
"minds": { "httpUrl": "https://getminds.ai/mcp" }
}
}
Inicia gemini e inicia sesión como en el paso 3 de la opción A.
¿OAuth o clave de API?
- OAuth (recomendado): inicias sesión con tu cuenta de Minds. Gemini CLI se registra automáticamente en Minds, así que no necesitas un ID de cliente ni un secreto, y cada persona conecta su propia cuenta.
- Clave de API: para entornos sin navegador, por ejemplo una tarea de CI o una cuenta de servicio compartida. Crea una clave en Settings → API Keys y añádela como encabezado:
gemini mcp add --scope user --transport http --header "Authorization: Bearer minds_YOUR_API_KEY" minds https://getminds.ai/mcp
La clave se guarda en texto plano en settings.json. Mantén ese archivo fuera del control de versiones y prefiere OAuth en ordenadores personales.
Opción C: Google Antigravity
Antigravity tiene su propia configuración: los servidores remotos se definen con serverUrl en ~/.gemini/config/mcp_config.json o .agents/mcp_config.json, y el inicio de sesión se hace en Settings → Customizations → Authenticate. La guía de Antigravity cubre sus tres interfaces.
¿Pasas de Gemini CLI a Antigravity CLI? agy plugin import gemini convierte la extensión de Minds instalada en un plugin de Antigravity con el mismo servidor.
App de Gemini y Gemini Enterprise
Google también documenta conexiones MCP personalizadas en la app de Gemini (cuentas personales en EE. UU.) y en Gemini Enterprise. Todavía no es posible conectar Minds allí. Usa Gemini CLI o Google Antigravity hasta que Minds admita estos conectores.
Cómo funciona Minds en Gemini CLI
- Primero se planifica: antes de ejecutar nada, el agente te presenta el plan de investigación para que lo apruebes. Una Study solo empieza tras tu confirmación.
- Las ejecuciones largas siguen en el servidor: las Studies se ejecutan de forma persistente en Minds y continúan aunque cierres la terminal. Pide más tarde su estado a Gemini CLI.
- Profundiza en Minds: los resultados enlazan a la Study en Minds, donde revisas respuestas individuales, comparas Audiences y exportas resultados.
Las herramientas que puede usar Gemini CLI aparecen en la referencia de herramientas. La visión general de MCP explica la integración en conjunto.
Solución de problemas
Minds aparece como desconectado. Ejecuta /mcp auth minds en una sesión de Gemini CLI y completa el inicio de sesión en el navegador.
La página de inicio de sesión no se abre. Gemini CLI recibe la respuesta de OAuth en un puerto local, así que el navegador debe ejecutarse en el mismo ordenador. Por SSH o en un contenedor, usa una clave de API.
Dos servidores de Minds o herramientas duplicadas. La extensión y una entrada manual están activas a la vez. Elimina una con gemini extensions uninstall minds-mcp o gemini mcp remove minds.
«Not authorized» para una Study o Audience que puedes abrir en Minds. Gemini CLI está conectado a una cuenta de Minds distinta de la propietaria de la Study. Ejecuta de nuevo /mcp auth minds con la cuenta correcta o comparte la Study con la cuenta conectada.
No aparecen las nuevas herramientas de Minds. Reinicia Gemini CLI para que recargue la lista de herramientas y ejecuta gemini extensions update minds-mcp si usas la extensión.
Otros clientes como ChatGPT, Claude y Codex aparecen en la visión general de integraciones.
URL del servidor MCP
https://getminds.ai/mcp
