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

Los asistentes de codificación de IA son potentes, pero tienen limitaciones: los datos de entrenamiento se interrumpen 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 actualizado tu asistente de codificación con la API de Gemini en evolución y su uso recomendado, te recomendamos que configures el MCP de Gemini Docs 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 Gemini Docs

Gemini aloja un servidor público de Protocolo de contexto del modelo (MCP) en https://gemini-api-docs-mcp.dev. Conectar tu agente de codificació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 óptimos.

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 Gemini Docs. 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 de Context7

gemini-api-dev

La habilidad fundamental para el desarrollo de Gemini de uso general. Esta habilidad proporciona documentación y prácticas recomendadas para lo siguiente:

  • Enrutamiento de instrucciones a los modelos actuales (p.ej., Gemini 3.1 Pro/Flash) y evitación de modelos obsoletos
  • Instrucciones multimodales, llamadas a función, resultados estructurados y patrones de integración comunes

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 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 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

gemini-interactions-api

Habilidad para crear apps con la API de Interactions. La API de Interactions es una interfaz unificada para interactuar con modelos y agentes de Gemini, diseñada para aplicaciones de agentes. Esta habilidad abarca lo siguiente:

  • Generación de texto, chat de varios turnos y transmisión
  • Llamadas a función, resultados estructurados 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
  • Patrones de SDK de Python y TypeScript

Instala con skills.sh

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

Instala con Context7

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

Verifica la instalación

Después de la instalación, confirma que tu asistente de codificación pueda conectarse al servidor MCP de Gemini Docs 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 Gemini Docs 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 de Discovery o Status para tu entorno para verificar que el MCP o la habilidad de Docs 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 el estado de 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 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 la 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