Configura tu asistente de programación con Gemini MCP y Skills

Los asistentes de codificación basados en IA son potentes, pero tienen limitaciones: los datos de entrenamiento se cortan en una fecha específica, y faltan funciones y cambios nuevos de la API. Sin acceso a la documentación específica de Gemini, los agentes pueden sugerir patrones genéricos en lugar de enfoques optimizados.

Para mantener tu asistente de programación actualizado con la API de Gemini en evolución y su uso recomendado, te sugerimos que configures el MCP de la documentación de Gemini y que mejores tu entorno con las habilidades de la API de Gemini. Si bien estas herramientas se pueden usar de forma independiente, están diseñadas para funcionar en conjunto y brindar una cobertura completa.

Conecta el MCP de Gemini Docs

Gemini aloja un servidor público del Protocolo de contexto del modelo (MCP) en https://gemini-api-docs-mcp.dev. Conectar tu agente de programación a este servidor garantiza que todas las consultas tengan acceso a las APIs más recientes, las actualizaciones de código y los ejemplos de configuración óptima.

Ejecuta el siguiente comando en la terminal o la raíz del proyecto de tu agente para instalar el servidor:

npx add-mcp "https://gemini-api-docs-mcp.dev"

Este servidor agrega una función search_documentation que tu agente puede usar para recuperar definiciones de APIs y patrones de integración en tiempo real de los archivos de documentación oficiales de Gemini.

Agrega habilidades de desarrollo de APIs

Las habilidades proporcionan reglas y prácticas recomendadas integradas (como aplicar las versiones correctas del SDK y del modelo actual) directamente en el contexto de tu asistente. La habilidad funciona en conjunto con el servicio de MCP de Gemini Docs: Si tienes ambos instalados, la habilidad usa el servicio de MCP para la documentación, pero incluso sin el MCP instalado, recuperará /gemini-api/docs/llms.txt de ai.google.dev como alternativa (donde también se pueden recuperar páginas individuales como Markdown sin procesar agregando .md.txt, como https://ai.google.dev/gemini-api/docs/speech-generation.md.txt).

Para instalar estas habilidades, puedes usar una de las siguientes herramientas compatibles. A continuación, se proporcionan las instrucciones de instalación para ambos módulos de habilidad:

  • skills.sh: Se recomienda. Es el estándar abierto para los comportamientos portátiles de los agentes.
  • Context7: Se admite para los usuarios que ya utilizan el ecosistema de Context7.

gemini-api-dev

Habilidad para compilar apps con la API de Gemini (API de Interactions). La API de Interactions es la forma más sencilla y eficaz de crear con modelos y agentes de Gemini. Esta habilidad abarca lo siguiente:

  • Generación de texto, chat de varios turnos y transmisión
  • Llamadas a funciones, resultados estructurados y generación de imágenes
  • Ejecución en segundo plano y agentes de Deep Research
  • Administración del estado de la conversación del servidor
  • Enrutamiento de instrucciones a los modelos actuales y evitación de los modelos obsoletos
  • Patrones del SDK de Python y TypeScript

Instala con skills.sh

npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

Instala con Context7

npx ctx7 skills install /google-gemini/gemini-skills gemini-api-dev

gemini-live-api-dev

Habilidad para crear aplicaciones de IA conversacional en tiempo real con la API de Gemini Live. Esta habilidad proporciona documentación y prácticas recomendadas para lo siguiente:

  • Conexiones WebSocket para la transmisión con baja latencia
  • Transmisión de audio, video y texto
  • Detección de actividad de voz y compatibilidad con la interrupción

Instala con skills.sh

npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global

Instala con Context7

npx ctx7 skills install /google-gemini/gemini-skills gemini-live-api-dev

Verifica la instalación

Después de la instalación, confirma que tu asistente de codificación pueda conectarse al servidor de MCP de la documentación de Gemini y usar las habilidades instaladas.

1. Verifica el comportamiento del agente

La forma más confiable de verificarlo es hacerle a tu agente una pregunta técnica sobre la API de Gemini.

Instrucción: "¿Cómo uso el almacenamiento de contexto en caché con la API de Gemini?"

Una configuración exitosa tendrá las siguientes características:

  • Proporciona código preciso: Haz referencia a métodos específicos de Gemini, como cacheContent o cachedContents.create, desde los extremos más recientes.
  • Usar la herramienta de MCP: Demuestra que está conectado al servidor de MCP de Gemini Docs o que utiliza la herramienta search_documentation para recuperar datos.
  • Invoca habilidades cargadas: Muestra un indicador que diga "Using skill: gemini-api-dev" (si se basa en un wrapper secundario).

2. Verifica las manifestaciones y las herramientas

Si el agente da una respuesta general o genérica, usa los comandos específicos de Discovery o Status para tu entorno y verifica que el MCP o la habilidad de Docs se hayan cargado en la memoria.

Entorno Verificación del MCP Verificación de habilidades
Claude Code Escribe /mcp en la terminal para ver los servidores activos y las herramientas de search_documentation. Escribe /skills en la terminal para enumerar todos los manifiestos activos.
Cursor Navega a Configuración > Funciones > MCP. Asegúrate de que el servidor esté “conectado”. Abre Configuración > Reglas. Verifica que la habilidad aparezca en "El agente decide".
Antigravity Consulta el estado del MCP en la barra lateral Personalizaciones > Conexiones. Escribe /skills list o consulta la barra lateral Personalizaciones > Reglas.
CLI de Gemini Ejecuta gemini mcp list o usa /mcp list. Ejecuta gemini skills list o usa el comando de barra /skills durante la sesión.
Copilot Escribe @gemini /mcp para enumerar los conectores de datos activos. Escribe @gemini /skills (o /skills) para ver las extensiones activas.

Solución de problemas

Si tu agente solo proporciona información general o no reconoce los métodos específicos de Gemini, verifica lo siguiente:

El agente no descubrió la habilidad

La mayoría de los agentes indexan las habilidades solo al inicio.

Solución: Reinicia por completo tu IDE (Cursor/VS Code) o sal y vuelve a abrir tu agente basado en terminal (Claude Code).

Conflicto global vs. local

Si realizaste la instalación con la marca --global, es posible que el agente la ignore en favor de las reglas específicas del proyecto.

Solución: Intenta instalar la habilidad directamente en la raíz de tu proyecto sin la marca global:

npx skills add google-gemini/gemini-skills --skill gemini-api-dev

Recursos