Configurer votre assistant de codage avec Gemini MCP et Skills

Les assistants de codage basés sur l'IA sont puissants, mais ils ont des limites : les données d'entraînement sont limitées à une date spécifique, et ils ne disposent pas des nouvelles fonctionnalités et modifications de l'API. Sans accès à la documentation spécifique à Gemini, les agents peuvent suggérer des schémas génériques au lieu d'approches optimisées.

Pour que votre assistant de codage soit à jour avec l'évolution de l'API Gemini et son utilisation recommandée, nous vous recommandons de configurer le MCP Gemini Docs et d'améliorer votre environnement avec les compétences de l'API Gemini. Bien que ces outils puissent être utilisés indépendamment, ils sont conçus pour fonctionner ensemble afin d'offrir une couverture complète.

Connecter le MCP Gemini Docs

Gemini héberge un serveur MCP (Model Context Protocol) public sur gemini-api-docs-mcp.dev. En connectant votre agent de codage à ce serveur, vous vous assurez que toutes les requêtes ont accès aux dernières API, mises à jour de code et exemples de configuration optimale.

Exécutez la commande suivante dans le terminal de votre agent ou à la racine de votre projet pour installer le serveur :

npx add-mcp gemini-api-docs-mcp.dev

Ce serveur ajoute une fonction search_documentation que votre agent peut utiliser pour récupérer les définitions d'API et les schémas d'intégration en temps réel à partir des fichiers de documentation officiels de Gemini.

Ajouter des compétences de développement d'API

Les compétences fournissent des règles et des bonnes pratiques intégrées (comme l'application des versions correctes du SDK et du modèle actuel) directement dans le contexte de votre assistant. La compétence fonctionne avec le service MCP Gemini Docs : si vous avez installé les deux, la compétence utilise le service MCP pour la documentation, mais même sans le MCP installé, elle récupère llms.txt à partir de ai.google.dev en cas de problème.

Pour installer ces compétences, vous pouvez utiliser l'un des outils compatibles suivants. Les instructions d'installation pour les deux sont fournies sous chaque module de compétence :

  • skills.sh : recommandé. Norme ouverte pour les comportements d'agent portables.
  • Context7 : compatible avec les utilisateurs qui utilisent déjà l'écosystème Context7.

gemini-api-dev

Compétence de base pour le développement Gemini à usage général. Cette compétence fournit de la documentation et des bonnes pratiques pour les éléments suivants :

  • Le routage des invites vers les modèles actuels (par exemple, Gemini 3.1 Pro/Flash) et l'évitement des modèles obsolètes
  • Les invites multimodales, l'appel de fonction, les sorties structurées et les schémas d'intégration courants

Installer avec skills.sh

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

Installer avec Context7

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

gemini-live-api-dev

Compétence permettant de créer des applications d'IA conversationnelle en temps réel avec l'API Gemini Live. Cette compétence fournit de la documentation et des bonnes pratiques pour les éléments suivants :

  • Les connexions WebSocket pour le streaming à faible latence
  • Le streaming audio, vidéo et texte
  • La détection de l'activité vocale et la prise en charge de l'interruption

Installer avec skills.sh

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

Installer avec Context7

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

gemini-interactions-api

Compétence permettant de créer des applications avec l' API Interactions. L'API Interactions est une interface unifiée permettant d'interagir avec les modèles et les agents Gemini, conçue pour les applications d'agent. Cette compétence couvre les points suivants :

  • La génération de texte, le chat multitour et le streaming
  • L'appel de fonction, la sortie structurée et la génération d'images
  • L'exécution en arrière-plan et les agents Deep Research
  • La gestion de l'état de la conversation côté serveur
  • Les schémas de SDK Python et TypeScript

Installer avec skills.sh

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

Installer avec Context7

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

Vérifier l'installation

Après l'installation, vérifiez que votre assistant de codage peut se connecter au serveur MCP Gemini Docs et utiliser les compétences installées.

1. Vérifier le comportement de l'agent

Le moyen le plus fiable de vérifier est de poser une question technique à votre agent sur l'API Gemini.

Invite : "Comment utiliser la mise en cache du contexte avec l'API Gemini ?"

Une configuration réussie :

  • Fournit un code précis : référence des méthodes Gemini spécifiques telles que cacheContent ou cachedContents.create à partir des derniers points de terminaison.
  • Utilise l'outil MCP : indique qu'il est connecté au serveur MCP Gemini Docs ou qu'il utilise l'outil search_documentation pour récupérer des données.
  • Appelle les compétences chargées : affiche un indicateur indiquant qu'il "utilise la compétence : gemini-api-dev" (s'il s'appuie sur un wrapper secondaire).

2. Vérifier les manifestations et les outils

Si l'agent fournit une réponse générale ou générique, utilisez les commandes Discovery ou Status spécifiques à votre environnement pour vérifier que le MCP ou la compétence Docs est chargé en mémoire.

Environnement Vérification du MCP Vérification des compétences
Code Claude Saisissez /mcp dans le terminal pour afficher les serveurs actifs et les outils search_documentation. Saisissez /skills dans le terminal pour lister tous les fichiers manifestes actifs.
Cursor Accédez à Paramètres > Fonctionnalités > MCP. Assurez-vous que le serveur est "Connecté". Ouvrez Paramètres > Règles. Vérifiez que la compétence apparaît sous "L'agent décide".
Antigravity Vérifiez l'état du MCP dans la barre latérale Personnalisations > Connexions. Saisissez /skills list ou cochez la barre latérale Personnalisations > Règles.
Gemini CLI Exécutez gemini mcp list ou utilisez /mcp list. Exécutez gemini skills list ou utilisez la commande barre oblique /skills en session.
Copilot Saisissez @gemini /mcp pour lister les connecteurs de données actifs. Saisissez @gemini /skills (ou /skills) pour afficher les extensions actives.

Dépannage

Si votre agent ne fournit que des informations générales ou ne reconnaît pas les méthodes spécifiques à Gemini, vérifiez les points suivants :

L'agent n'a pas découvert la compétence

La plupart des agents n'indexent les compétences qu'au démarrage.

Solution : redémarrez complètement votre IDE (Cursor/VS Code) ou quittez et rouvrez votre agent basé sur un terminal (Claude Code).

Conflit global/local

Si vous avez installé avec l'option --global, votre agent peut l'ignorer au profit de règles spécifiques au projet.

Solution : essayez d'installer la compétence directement à la racine de votre projet sans l'option globale :

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

Ressources