Herramientasgemini
Gemini MCP: conecta herramientas con permisos mínimos
Conecta Gemini CLI a un servidor MCP con un ejemplo acotado. Aprende a comprobar permisos, probar la conexión y evitar exponer datos de trabajo.
- Autor: humAIns
- 8 min de lectura
índice · 8 apartados
MCP permite que Gemini CLI descubra y use herramientas que ofrece otro programa, por ejemplo, una búsqueda local o una consulta a un servicio. Para probar la conexión con seguridad, empieza con un servidor que no tenga acceso a datos reales, permite únicamente las herramientas imprescindibles y verifica cada llamada antes de confiar en ella. MCP conecta sistemas; no convierte por sí solo una integración en segura ni concede acceso automáticamente.
Qué une MCP con Gemini CLI y qué queda fuera
El Model Context Protocol (MCP) define una forma común de que una aplicación cliente descubra herramientas y recursos que publica un servidor. Gemini CLI es uno de esos clientes: puede conectarse mediante procesos locales (stdio) o endpoints remotos compatibles, descubrir las herramientas y ofrecérselas al modelo durante una conversación. La documentación del proyecto describe, entre otros, transportes stdio, SSE y HTTP de flujo.
El servidor conserva la responsabilidad de implementar cada operación y de comprobar su propio acceso a los sistemas. MCP no es una base de datos, una autorización general a tu ordenador ni una garantía de que la salida del servidor sea correcta. Tampoco hay que confundirlo con Gemini Apps: este ejemplo configura Gemini CLI, que funciona desde terminal y tiene su propio archivo de ajustes.
Si estás empezando por el concepto de agente, consulta qué es un agente de IA. Para valorar si un proceso merece automatizarse antes de conectar herramientas, puedes leer automatización con IA.
Requisitos y elección de servidor
Necesitas Gemini CLI instalado y un servidor MCP cuya documentación indique cómo ejecutarlo o cuál es su endpoint y autenticación. Elige uno mantenido por una fuente en la que confíes, lee qué datos procesa, qué operaciones ofrece y qué permisos solicita. Un servidor local no es automáticamente fiable: su código se ejecuta en tu equipo con los permisos del proceso que lo inicia.
Para el primer ensayo, usa un servidor de ejemplo que no acceda a tus cuentas ni a carpetas de trabajo. La documentación de Gemini CLI muestra una configuración stdio con comando y argumentos, y opciones para limitar las herramientas. Si necesitas un ejemplo concreto con Workspace, el codelab oficial de Google para Workspace MCP y Gemini CLI explica una integración con Gmail, Drive, Calendar, Chat y People; requiere preparar un proyecto de Google Cloud, OAuth y APIs. No hace falta empezar por una integración así para aprender a comprobar una conexión.
Antes de instalar o ejecutar un servidor, revisa el origen del paquete, el comando exacto, los permisos del sistema operativo y si requiere variables secretas. No uses información de clientes ni documentos internos durante la prueba. Si el servidor necesita acceso a un servicio, utiliza una cuenta de prueba y permisos acotados.
Conexión paso a paso con datos de prueba
Gemini CLI guarda la configuración de usuario en ~/.gemini/settings.json; también admite configuración de proyecto. La documentación actual muestra el objeto mcpServers. Conserva cualquier ajuste que ya tengas al editar JSON y valida que el archivo siga siendo JSON válido.
Como plantilla, esta entrada usa nombres y rutas ilustrativas: sustitúyelos por el comando y los argumentos indicados por la documentación del servidor de prueba que hayas elegido. No la ejecutes sin comprobar primero que ese programa es confiable.
{
"mcpServers": {
"prueba-local": {
"command": "python",
"args": ["-m", "servidor_mcp_demo"],
"trust": false,
"includeTools": ["buscar_ejemplo"]
}
}
}
command y args describen el proceso stdio. trust: false mantiene las confirmaciones de uso; no actives trust: true como atajo, porque la documentación indica que evita las confirmaciones para ese servidor. includeTools limita las herramientas publicadas a los nombres permitidos; comprueba los nombres reales que expone el servidor. Si incluyes una herramienta de escritura, el servidor podría cambiar o enviar información: para la primera prueba elige una operación de lectura inocua.
Guarda el archivo y abre Gemini CLI en una carpeta de prueba, no en un repositorio o directorio con información sensible. En la sesión, escribe /mcp para consultar estado, detalles y herramientas descubiertas. La guía también describe gemini mcp list para ver los servidores desde el terminal. Si la herramienta aparece conectada, pídele una acción inocua sobre contenido inventado, por ejemplo que busque una etiqueta dentro de un conjunto de prueba. Revisa el nombre de la operación y sus argumentos antes de confirmar cualquier llamada.
No pegues en el prompt datos reales solo para comprobar que funciona. Primero confirma la comunicación con el servidor y la respuesta esperada usando material ficticio. Después, si existe una necesidad profesional legítima, evalúa por separado el tratamiento de datos, la identidad de la cuenta y las condiciones del proveedor.
Comprobar herramientas disponibles y resolver errores
En /mcp, comprueba que el servidor figura conectado y que la lista de herramientas coincide con lo que querías permitir. El estado conectado solo indica que el cliente estableció comunicación; no certifica el software, la seguridad de sus operaciones ni los permisos del servicio remoto.
Si no aparecen las herramientas, comprueba lo siguiente en orden:
- Que el nombre y la sintaxis de
commandyargscoinciden con las instrucciones del servidor y que el ejecutable está instalado. - Que el JSON es válido y el servidor se inicia sin errores cuando lo ejecutas conforme a su documentación.
- Que la carpeta actual está marcada como confiable si utilizas stdio. Gemini CLI indica que la comprobación/visualización de servidores stdio depende de la confianza de la carpeta.
- Que estás usando una versión de Gemini CLI compatible con la configuración que sigues; las opciones del CLI evolucionan, así que consulta la guía vigente si un comando no se reconoce.
- Que el endpoint remoto, si lo usas, es correcto y que el servidor y su autenticación están disponibles. No incluyas tokens en capturas, logs compartidos ni mensajes de error públicos.
Para obtener diagnósticos, vuelve a ejecutar /mcp o gemini mcp list y lee el error específico. Un servidor caído, un comando mal escrito, una carpeta no confiable o una autorización incompleta pueden parecer el mismo síntoma desde fuera, pero requieren soluciones diferentes. No rebajes las confirmaciones ni amplíes permisos para esconder un fallo de conexión.
Permisos mínimos, servidores confiables y eliminación
Trata cada servidor MCP como software al que potencialmente entregas entradas y que puede devolver instrucciones o resultados no verificados. Revisa sus herramientas una a una, qué datos reciben y qué efectos pueden producir. Permite solo los nombres necesarios mediante includeTools; la configuración también admite excludeTools, que tiene prioridad cuando una herramienta aparece en ambas listas.
Mantén trust desactivado, conserva las confirmaciones y prueba primero herramientas de solo lectura. Usa una cuenta y un entorno separados para experimentos. Si hacen falta credenciales, no las incrustes en el prompt ni en el repositorio: sigue el mecanismo documentado por el CLI y por el servidor, limita los permisos concedidos y evita registrar secretos. La expansión de variables de entorno en la configuración del proceso puede ayudar a no escribir un token literal en el JSON, pero no sustituye la gestión segura del secreto ni impide que un servidor malicioso lo utilice.
Al terminar, retira la conexión con gemini mcp remove prueba-local (usa el nombre que configuraste). Si solo quieres pausarla, gemini mcp disable prueba-local la desactiva; la documentación indica que se puede volver a habilitar. Para servicios OAuth, retirar el servidor local no necesariamente revoca el permiso en la cuenta: revoca por separado el consentimiento o cliente según las instrucciones del proveedor y elimina los tokens de prueba de la forma que documente la herramienta.
MCP puede ser una pieza útil en una estrategia de IA multimodal, pero la conexión debe responder a una tarea delimitada y gobernarse igual que cualquier acceso a herramientas externas.
FAQ
¿Es lo mismo Gemini Apps que Gemini CLI?
No. Gemini Apps es una aplicación conversacional; Gemini CLI es el cliente de terminal tratado aquí y se configura para conectarse a servidores MCP.
¿Qué es un servidor MCP?
Un programa que publica herramientas, recursos o instrucciones mediante el protocolo MCP para que un cliente compatible pueda descubrirlos y, según el caso, utilizarlos.
¿Se necesitan credenciales?
Solo si el servidor o el servicio al que se conecta las requiere. Empieza con una demostración sin datos ni credenciales reales; para una integración autenticada, usa los permisos mínimos y la guía oficial del proveedor.
¿Cómo retiro el acceso?
Quita o desactiva la entrada con gemini mcp remove nombre o gemini mcp disable nombre. Revoca aparte el consentimiento OAuth cuando corresponda.
Prueba MCP con criterio profesional
Aprende a identificar oportunidades, límites y riesgos de la IA aplicada al trabajo en el curso de IA para marketing, sin asumir que incluya formación específica sobre MCP. Antes de llevar una integración a tu entorno, comprueba qué datos y acciones implica.
Haz también el test ¿Cuánto te queda? para identificar qué áreas de IA quieres seguir desarrollando.
Fuentes oficiales
Sigue leyendo en humAIns