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

Los asistentes de programación potenciados por IA son potentes, pero tienen limitaciones: los datos de entrenamiento se interrumpen en una fecha específica, y faltan las funciones y los 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 actualizado tu asistente de programación con la API de Gemini en evolución y su uso recomendado, te recomendamos 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 proporcionar una cobertura completa.

Conecta el MCP de la documentación de Gemini

Gemini aloja un servidor público de 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, las actualizaciones de código y los ejemplos de configuración óptima más recientes.

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 API y patrones de integración en tiempo real de los archivos de documentación oficiales de Gemini.

Agrega habilidades de desarrollo de API

Las habilidades proporcionan reglas y prácticas recomendadas integradas (como la aplicación de las versiones correctas del SDK y del modelo actual) directamente en el contexto de tu asistente. La habilidad funciona junto con el servicio MCP de la documentación de Gemini. Si tienes ambos instalados, la habilidad usa el servicio MCP para la documentación, pero incluso sin el MCP instalado, recuperará llms.txt de ai.google.dev como alternativa.

Para instalar estas habilidades, puedes usar una de las siguientes herramientas compatibles. Las instrucciones de instalación para ambas se proporcionan debajo de cada módulo de habilidades:

  • skills.sh: Recomendado El estándar abierto para comportamientos de agentes portátiles
  • Context7: Compatible con los usuarios que ya utilizan el ecosistema Context7

gemini-api-dev

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

  • Generación de texto, chat de varios turnos y transmisión
  • Llamada a funciones, salida estructurada y generación de imágenes
  • Ejecución en segundo plano y agentes de Deep Research
  • Administración del estado de conversación del servidor
  • Enrutamiento de instrucciones a los modelos actuales y evitación de modelos obsoletos
  • Patrones de 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 compilar aplicaciones de IA conversacionales en tiempo real con la API de Gemini Live. Esta habilidad proporciona documentación y prácticas recomendadas para lo siguiente:

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

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 programació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 verificar es hacerle a tu agente una pregunta técnica sobre la API de Gemini.

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

Una configuración exitosa hará lo siguiente:

  • Proporcionar 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 MCP: Muestra que está conectada al servidor MCP de la documentación de Gemini o que utiliza la herramienta search_documentation para recuperar datos.
  • Invocar habilidades cargadas: Muestra un indicador de que está "Usando la habilidad: gemini-api-dev" (si depende de 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 Discovery o Status para tu entorno para verificar que el MCP o la habilidad de la documentación se carguen en la memoria.

Entorno Verificación de MCP Verificación de habilidades
Claude Code Escribe /mcp en la terminal para ver los servidores activos y las herramientas search_documentation. Escribe /skills en la terminal para enumerar todas las manifestaciones activas.
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 la barra lateral Personalizaciones > Conexiones para ver el estado de MCP. 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 en 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 métodos específicos de Gemini, verifica lo siguiente:

El agente no descubrió la habilidad

La mayoría de los agentes indexan 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 y local

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

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

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

Recursos