Se connecter au serveur MCP Developer Knowledge

Le serveur MCP Google Developer Knowledge permet aux outils de développement basés sur l'IA de rechercher dans la documentation officielle pour les développeurs de Google et d'extraire des informations sur les produits Google tels que Firebase, Google Cloud, Android, Maps, etc. En connectant votre application d'IA directement à notre bibliothèque officielle de documentation, vous vous assurez que le code et les conseils que vous recevez sont à jour et basés sur un contexte faisant autorité.

Une fois le serveur configuré, les outils intégrés peuvent vous aider à répondre à des demandes telles que :

  • Instructions relatives à l'implémentation

    • Par exemple : Quelle est la meilleure façon d'implémenter des notifications push à l'aide de Firebase Cloud Messaging dans une application Android ?

  • Génération et explication de code

    • Par exemple : Recherchez dans la documentation Google un exemple Python permettant de lister tous les buckets d'un projet Cloud Storage.

  • Dépannage et débogage

    • Par exemple : Pourquoi ma clé API Google Maps affiche-t-elle le filigrane "À des fins de développement uniquement" ?

  • Analyse comparative et résumé

    • Par exemple : Aide-moi à choisir entre Cloud Run et Cloud Functions pour un nouveau microservice. Crée un tableau Markdown qui compare les aspects clés tels que le cas d'utilisation principal, la simultanéité et le modèle de tarification.

Fonctionnalités du serveur MCP

Le serveur MCP Google Developer Knowledge fournit les outils suivants à votre application d'IA :

Nom de l'outil Description
search_documents Effectue des recherches dans la documentation Google destinée aux développeurs (Firebase, Google Cloud, Android, Maps et plus encore) pour trouver les pages et les extraits pertinents pour votre requête. Utilisez get_documents avec parent dans les résultats de recherche pour obtenir le contenu complet de la page.
get_documents Obtient le contenu complet de plusieurs documents à l'aide des parent des résultats search_documents.

L'outil search_documents divise la documentation en petits blocs de texte optimisés pour la recherche et la récupération basées sur l'IA. Lorsque vous effectuez une recherche, l'outil renvoie un ou plusieurs extraits de documents pertinents par rapport à votre requête. Si vous avez besoin d'afficher le contenu complet de la page qui entoure un extrait, utilisez get_documents avec le parent fourni dans les résultats de recherche pour récupérer le contenu complet de la page.

Installation

Le serveur MCP Google Developer Knowledge est un serveur MCP distant qui utilise l'API Developer Knowledge pour rechercher et récupérer de la documentation. Vous pouvez vous authentifier à l'aide d'OAuth ou d'une clé API.

S'authentifier à l'aide d'OAuth

Cette section vous guide tout au long du processus d'authentification de votre application d'IA auprès du serveur MCP Developer Knowledge à l'aide d'OAuth.

Prérequis : configurer Google Cloud CLI

Avant de continuer, assurez-vous de disposer des éléments suivants :

Étape 1 : Activez l'API Developer Knowledge dans un projet

  1. Ouvrez la page de l'API Developer Knowledge dans la bibliothèque des API Google.
  2. Vérifiez que vous avez sélectionné le bon projet dans lequel vous souhaitez utiliser l'API.
  3. Cliquez sur Activer. Aucun rôle IAM spécifique n'est requis pour activer ou utiliser l'API.

Étape 2 : Choisissez votre méthode d'authentification

La méthode d'authentification que vous choisissez dépend de la compatibilité de votre assistant IA avec les identifiants par défaut de l'application (ADC) à l'aide de la gcloud CLI ou de la nécessité d'un ID client OAuth autonome. Les assistants tels que Gemini CLI peuvent utiliser votre identifiant Google Cloud existant pour une configuration fluide, tandis que d'autres, comme Antigravity, vous demandent de créer et de fournir manuellement vos propres identifiants pour établir une connexion sécurisée.

Sélectionnez l'onglet correspondant aux exigences de configuration de votre assistant IA spécifique.

ADC

Associer votre compte

  1. Pour autoriser le serveur MCP à agir en votre nom, exécutez la commande suivante en remplaçant PROJECT_ID par l'ID de votre projet Google Cloud :

    gcloud auth application-default login
--project=PROJECT_ID

  2. Lorsque vous y êtes invité, sélectionnez un compte, puis cliquez sur Continuer.

Configurer votre application d'IA

Une fois l'authentification effectuée, la dernière étape consiste à fournir à votre application d'IA les détails de la configuration du serveur. Bien que la structure JSON exacte varie selon l'application, vous pouvez utiliser l'exemple suivant comme modèle.

  1. Pour configurer Gemini CLI ou Gemini Code Assist, modifiez ou créez l'un des fichiers de configuration suivants :

    • Dans votre projet : .gemini/settings.json
    • Dans votre répertoire d'accueil : ~/.gemini/settings.json
    {
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
     },
      "timeout": 30000,
      "headers": {
        "X-goog-user-project": "PROJECT_ID"
      }
    }
  }
}

    Pour vérifier que le serveur MCP fonctionne comme prévu, passez à la section Vérifier l'installation.

Identifiants manuels

Configurer l'écran d'autorisation OAuth

Configurez l'écran de consentement OAuth du projet et ajoutez-vous en tant qu'utilisateur test. Si vous avez déjà effectué cette étape pour votre projet Google Cloud, passez à l'étape suivante.

  1. Ouvrez la page "Présentation de l'authentification" de la console Google Cloud, puis cliquez sur Commencer.
  2. Saisissez un nom d'application, sélectionnez votre adresse e-mail d'assistance, puis cliquez sur Suivant.
  3. Dans Audience, sélectionnez Externe, puis cliquez sur Suivant.
  4. Saisissez votre adresse e-mail dans Coordonnées, puis cliquez sur Suivant.
  5. Lisez et acceptez le Règlement sur les données utilisateur dans les services d'API Google, puis cliquez sur Continuer.
  6. Cliquez sur Créer.

Ajouter des utilisateurs de test

  1. Dans Google Auth Platform, cliquez sur Audience.
  2. Sous Utilisateurs de test, cliquez sur Ajouter des utilisateurs.
  3. Saisissez votre adresse e-mail et celles des autres utilisateurs de test autorisés, puis cliquez sur Enregistrer.

Créer un client OAuth

Pour vous authentifier en tant qu'utilisateur final et accéder aux données utilisateur dans votre application, vous devez créer un ID client OAuth 2.0. Un ID client sert à identifier une application unique auprès des serveurs OAuth de Google.

  1. Dans Google Auth Platform, cliquez sur Clients.
  2. Cliquez sur Créer un client.
  3. Dans le sélecteur Type d'application, sélectionnez Application de bureau.
  4. Dans le champ Nom, saisissez un nom pour l'identifiant. Ce nom n'apparaît que dans la console Google Cloud.
  5. Cliquez sur Créer. L'écran "Client OAuth créé" s'affiche, indiquant votre nouvel ID client et votre nouveau code secret de client.
  6. Cliquez sur OK. Les identifiants que vous venez de créer s'affichent sous ID client OAuth 2.0.
  7. Cliquez sur l'ID client que vous venez de créer. Dans la section Codes secrets du client, cliquez sur l'icône de téléchargement pour enregistrer le fichier JSON. Vous utiliserez les valeurs client_id et client_secret de ce fichier dans une étape ultérieure.

Configurer votre application d'IA

Vous devez ensuite fournir à votre application d'IA les détails de la configuration du serveur. Bien que la séquence exacte d'étapes varie selon l'application, vous pouvez utiliser l'exemple suivant comme modèle.

Pour configurer Antigravity afin qu'il utilise le serveur MCP :

  1. Dans Antigravity, cliquez sur le menu Options supplémentaires dans le volet "Agent" > Serveurs MCP > Gérer les serveurs MCP.

  2. En haut du volet "Gérer les serveurs MCP" qui s'ouvre, cliquez sur Afficher la configuration brute pour modifier le fichier mcp_config.json :

    {
  "mcpServers": {
    "google-developer-knowledge": {
      "serverUrl": "https://developerknowledge.googleapis.com/mcp"
    }
  }
}

  3. Revenez à Gérer les serveurs MCP, puis cliquez sur Actualiser.

Ajouter des identifiants OAuth

La première fois que vous tentez d'utiliser le serveur MCP Developer Knowledge, votre assistant IA vous invite à terminer la configuration :

  1. Demandez à l'agent d'utiliser le serveur MCP Developer Knowledge avec une requête telle que :

    How do I list Cloud Storage buckets?

  2. Si un message vous demande d'enregistrer un ou plusieurs URI de redirection, cliquez sur l'option pour continuer. Comme vous avez configuré l'ID client en tant qu'application de bureau, il n'est pas nécessaire d'ajouter ces URI spécifiques dans la plate-forme Google Auth.

  3. Lorsque votre assistant IA vous demande l'ID client et le code secret du client, collez chaque clé correspondante du fichier JSON de code secret du client que vous avez enregistré précédemment.

  4. Lorsque vous y êtes invité, sélectionnez un compte, puis cliquez sur Continuer.

  5. Revenez à votre assistant IA. L'agent va maintenant traiter votre demande à l'aide du serveur nouvellement authentifié.

S'authentifier à l'aide d'une clé API

Cette section vous guide tout au long du processus d'authentification de votre application d'IA auprès du serveur MCP Developer Knowledge à l'aide d'une clé API.

Étape 1 : Créez une clé API

Vous pouvez générer une clé API Developer Knowledge dans votre projet Google Cloud à l'aide de la console Google Cloud ou de gcloud CLI :

Console Google Cloud

Activer l'API

  1. Ouvrez la page de l'API Developer Knowledge dans la bibliothèque des API Google.
  2. Vérifiez que vous avez sélectionné le bon projet dans lequel vous souhaitez utiliser l'API.
  3. Cliquez sur Activer. Aucun rôle IAM spécifique n'est requis pour activer ou utiliser l'API.

Créer et sécuriser la clé API

  1. Dans la console Google Cloud du projet dans lequel vous avez activé l'API, accédez à la page Identifiants.
  2. Cliquez sur Créer des identifiants, puis sélectionnez Clé API dans le menu. La boîte de dialogue "Clé API créée" affiche la chaîne correspondant à la clé que vous venez de créer.
  3. Cliquez sur Modifier la clé API.
  4. Dans le champ Nom, indiquez un nom pour la clé.
  5. Sous API restrictions (Restrictions liées à l'API), sélectionnez Restrict key (Restreindre la clé).
  6. Dans la liste Sélectionner des API, activez l'API Developer Knowledge, puis cliquez sur OK.
    • Remarque : Si vous venez d'activer l'API Developer Knowledge, il peut s'écouler un certain temps avant qu'elle n'apparaisse dans la liste Sélectionner des API.
  7. Cliquez sur Enregistrer.

Une fois la clé créée, cliquez sur Afficher la clé pour l'afficher. Notez-la pour l'utiliser lors de la configuration de votre application d'IA.

CLI gcloud

  1. Si ce n'est pas déjà fait, téléchargez et installez la CLI gcloud.

  2. Activez l'API Developer Knowledge en remplaçant PROJECT_ID par l'ID de votre projet Google Cloud :

    gcloud services enable developerknowledge.googleapis.com --project=PROJECT_ID

  3. Créez une clé API en utilisant le même ID de projet Google Cloud :

    gcloud services api-keys create --project=PROJECT_ID --display-name="DK API Key"

    Cette commande renvoie une chaîne de clé API. Notez-la pour l'utiliser lors de la configuration de votre application d'IA.

  4. Sécurisez votre clé API en ajoutant des restrictions de clé API. Pour renforcer la sécurité, limitez la clé API à l'API Developer Knowledge.

Étape 2 : Activez le serveur MCP Developer Knowledge dans un projet

Pour activer le serveur MCP Developer Knowledge dans votre projet Google Cloud, téléchargez et installez gcloud CLI, puis exécutez la commande suivante en remplaçant PROJECT_ID par l'ID de votre projet Google Cloud :

gcloud beta services mcp enable developerknowledge.googleapis.com --project=PROJECT_ID

Si le service Developer Knowledge n'est pas activé pour votre projet Google Cloud, vous serez invité à l'activer avant d'activer le serveur MCP à distance.

Pour respecter les bonnes pratiques de sécurité, nous vous recommandons d'activer les serveurs MCP uniquement pour les services nécessaires au fonctionnement de votre application d'IA.

Étape 3 : Configurez votre application d'IA

Configurez les applications d'IA populaires en suivant ces instructions. Remplacez YOUR_API_KEY par la clé API Developer Knowledge que vous avez générée à l'étape précédente :

Gemini CLI

Pour configurer Gemini CLI, exécutez la commande suivante :

gemini mcp add -t http -H "X-Goog-Api-Key: YOUR_API_KEY" google-developer-knowledge https://developerknowledge.googleapis.com/mcp --scope user

Vous pouvez également modifier ou créer l'un des fichiers de configuration suivants :

  • Dans votre projet : .gemini/settings.json
  • Dans votre répertoire d'accueil : ~/.gemini/settings.json
{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Gemini Code Assist

Pour configurer Gemini Code Assist, modifiez ou créez l'un des fichiers de configuration suivants :

  • Dans votre projet : .gemini/settings.json
  • Dans votre répertoire d'accueil : ~/.gemini/settings.json
{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Pour configurer Claude Code, exécutez la commande suivante dans le dossier de votre application.

claude mcp add google-dev-knowledge --transport http https://developerknowledge.googleapis.com/mcp --header "X-Goog-Api-Key: YOUR_API_KEY"

Cursor

Pour configurer Cursor, modifiez .cursor/mcp.json (pour un projet spécifique) ou ~/.cursor/mcp.json (pour tous les projets).

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot

Pour configurer GitHub Copilot dans VS Code pour un seul projet, modifiez le fichier .vscode/mcp.json dans votre espace de travail.

{
  "servers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Pour rendre le serveur disponible dans tous les projets, modifiez vos paramètres utilisateur. Cliquez sur le bouton Open Settings (JSON) (Ouvrir les paramètres (JSON)).

{
  "mcp": {
    "servers": {
      "google-developer-knowledge": {
        "url": "https://developerknowledge.googleapis.com/mcp",
        "headers": {
          "X-Goog-Api-Key": "YOUR_API_KEY"
        }
      }
    }
  }
}

Windsurf

Pour configurer l'éditeur Windsurf, modifiez le fichier ~/.codeium/windsurf/mcp_config.json.

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Vérifier l'installation

Une fois configurée, ouvrez votre application d'IA et saisissez une requête telle que :

How do I list Cloud Storage buckets?

Si vous voyez un appel d'outil vers search_documents ou un autre outil de serveur MCP Developer Knowledge, cela signifie que le serveur fonctionne correctement.

Gérer l'utilisation des jetons

La récupération du contenu d'un document, en particulier lorsque vous utilisez batch_get_documents, consomme des jetons dans la fenêtre de contexte de votre application d'IA. Étant donné que certaines pages de la documentation pour les développeurs Google sont assez volumineuses, la récupération de plusieurs documents peut rapidement entraîner des coûts plus élevés, des temps de réponse du modèle plus lents et un dépassement de la fenêtre de contexte.

Pour optimiser les performances et éviter une facture inattendue, rédigez des requêtes spécifiques qui ciblent uniquement les informations dont vous avez besoin. Évitez les requêtes trop générales (par exemple, "Compare tous les produits Firebase") qui obligent l'agent à ingérer de grandes quantités de données à la fois.

Documentation incluse

Pour savoir quels documents sont recherchés par le serveur, consultez la référence du corpus.

Limites connues

  • Champ d'application du contenu : seules les pages publiques du corpus de référence sont incluses. Le contenu provenant d'autres sources, comme GitHub, les sites OSS, les blogs ou YouTube, n'est pas inclus.
  • Résultats uniquement en anglais : le serveur n'accepte que les résultats en anglais.
  • Dépendance au réseau : les outils du serveur s'appuient sur des services Google Cloud en direct. Si vous rencontrez des erreurs persistantes, vérifiez votre connexion Internet et la configuration de la clé API Developer Knowledge.

Dépannage

Si vous rencontrez des problèmes, vérifiez les points suivants :

Model Armor

Si vous utilisez Model Armor pour protéger votre application, vous pouvez rencontrer des erreurs 403 PERMISSION_DENIED pour certaines requêtes. Étant donné que le serveur MCP Developer Knowledge ne renvoie que de la documentation publique provenant de sources Google fiables, nous vous recommandons de définir les filtres d'injection de code et de jailbreaking (PIJB) sur des niveaux de confiance HIGH_AND_ABOVE pour réduire les faux positifs. Si votre cas d'utilisation n'implique pas d'autres outils qui accèdent à des données privées ou sensibles, vous pouvez également envisager de désactiver les filtres PIJB.