Utiliser le serveur MCP de l'API Android Management

Ce document vous explique comment utiliser le serveur MCP (Model Context Protocol) distant de l'API Android Management pour vous connecter à des applications d'IA, y compris l'interface de ligne de commande Gemini, ChatGPT, Claude et les applications personnalisées que vous développez. Le serveur MCP distant de l'API Android Management permet aux agents d'IA d'accéder de manière programmatique aux données de mobilité de l'entreprise. Il permet d'effectuer des requêtes en langage naturel sur les flottes d'appareils, d'auditer automatiquement la conformité aux règles et d'intégrer les données de gestion des appareils dans des workflows automatisés plus larges. Le serveur MCP distant de l'API Android Management est activé lorsque vous activez l'API Android Management.

Le Model Context Protocol (MCP) standardise la façon dont les grands modèles de langage (LLM) et les applications ou agents d'IA se connectent à des sources de données externes. Les serveurs MCP vous permettent d'utiliser leurs outils, ressources et invites pour effectuer des actions et obtenir des données à jour à partir de leur service de backend.

Quelle est la différence entre les serveurs MCP locaux et distants ?

Serveurs MCP locaux
S'exécutent généralement sur votre machine locale et utilisent les flux d'entrée et de sortie standards (stdio) pour la communication entre les services sur le même appareil.
Serveurs MCP distants
 : s'exécute sur l'infrastructure du service et propose un point de terminaison HTTP aux applications d'IA pour la communication entre le client AI MCP et le serveur MCP. Pour en savoir plus sur l'architecture MCP, consultez Architecture MCP.

Avant de commencer

Pour utiliser le serveur MCP distant de l'API Android Management, vous devez créer un projet Google Cloud et activer l'API Android Management.

  1. Dans la console Cloud, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  2. Activez l'API Android Management.

    Rôles requis pour activer les API

    Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

    Activer l'API

Rôles requis

Pour obtenir les autorisations nécessaires pour utiliser le serveur MCP distant de l'API Android Management, demandez à votre administrateur de vous accorder les rôles Identity and Access Management suivants sur le projet Google Cloud dans lequel vous souhaitez activer le serveur MCP de l'API Android Management :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour utiliser le serveur MCP distant de l'API Android Management. Pour afficher les autorisations exactes requises, développez la section Autorisations requises.

Autorisations requises

Les autorisations suivantes sont requises pour utiliser le serveur MCP distant de l'API Android Management :

  • serviceusage.mcppolicy.get
  • serviceusage.mcppolicy.update
  • Effectuer des appels d'outils MCP : mcp.tools.call
  • Accéder aux ressources Android Management :
    • androidmanagement.enterprises.get
    • androidmanagement.devices.list

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Authentification et autorisation

Les serveurs MCP de l'API Android Management utilisent le protocole OAuth 2.0 avec Identity and Access Management pour l'authentification et l'autorisation. Toutes les identités Google Cloud sont acceptées pour l'authentification auprès des serveurs MCP.

Le serveur MCP distant de l'API Android Management n'accepte pas les clés API.

Nous vous recommandons de créer une identité distincte pour les agents qui utilisent les outils MCP afin de pouvoir contrôler et surveiller l'accès aux ressources. Pour en savoir plus sur l'authentification, consultez S'authentifier auprès des serveurs MCP.

Habilitations OAuth MCP de l'API Android Management

OAuth 2.0 utilise des niveaux d'accès et des identifiants pour déterminer si un compte principal authentifié est autorisé à effectuer une action spécifique sur une ressource. Pour en savoir plus sur les champs d'application OAuth 2.0 chez Google, consultez Utiliser OAuth 2.0 pour accéder aux API Google.

L'API Android Management dispose des champs d'application OAuth suivants pour les outils MCP :

URI du champ d'application pour gcloud Description
https://www.googleapis.com/auth/androidmanagement Gérez les appareils et les applications Android.

Des champs d'application supplémentaires peuvent être requis pour les ressources auxquelles vous accédez lors d'un appel d'outil. Pour afficher la liste des habilitations requises pour l'API Android Management, consultez API Android Management.

Configurer un client MCP pour utiliser le serveur MCP de l'API Android Management

Les applications et agents d'IA, tels que Claude ou Antigravity, peuvent instancier un client MCP qui se connecte à un seul serveur MCP. Une application d'IA peut comporter plusieurs clients qui se connectent à différents serveurs MCP. Si votre application n'est pas listée dans les conseils spécifiques aux clients, vous pouvez utiliser les informations suivantes pour vous connecter depuis la plupart des applications.

Dans votre application d'IA, recherchez un moyen d'ajouter ou de vous connecter à un serveur MCP distant. Pour le serveur MCP de l'API Android Management, saisissez les informations requises :

  • Nom du serveur : serveur MCP de l'API Android Management
  • URL du serveur ou Point de terminaison : https://androidmanagement.googleapis.com/mcp
  • Transport : HTTP
  • Informations d'authentification : selon la méthode d'authentification que vous souhaitez utiliser, vous pouvez saisir vos identifiants Google Cloud, votre ID et votre code secret de client OAuth, ou les identifiants et les informations d'authentification d'un agent. Pour en savoir plus sur l'authentification, consultez S'authentifier auprès des serveurs MCP.

Pour obtenir des conseils spécifiques à une application sur la configuration et la connexion au serveur MCP, consultez Conseils spécifiques aux clients.

Pour obtenir des conseils plus généraux, consultez les ressources suivantes :

Outils disponibles

Pour afficher les détails des outils MCP disponibles et leurs descriptions pour le serveur MCP de l'API Android Management, consultez la documentation de référence sur le MCP de l'API Android Management.

Outils de liste

Utilisez l'inspecteur MCP pour lister les outils ou envoyez une requête HTTP tools/list directement au serveur MCP distant de l'API Android Management. La méthode tools/list ne nécessite pas d'authentification.

POST /mcp HTTP/1.1
Host: androidmanagement.googleapis.com
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "tools/list",
}

Exemples de cas d'utilisation

Voici des exemples de cas d'utilisation du serveur MCP de l'API Android Management :

  • Requêtes en langage naturel : posez des questions complexes sur votre parc d'appareils sans écrire de code. Par exemple, "Quels sont les appareils qui ne sont pas conformes au dernier correctif de sécurité ?"
  • Audits automatisés : récupèrent régulièrement des données et compilent des rapports sur l'état des appareils et le respect des règles.
  • Alertes intelligentes : surveillez les données de votre parc pour signaler les anomalies ou les problèmes potentiels en fonction d'insights en temps réel.

Exemples de prompts

Vous pouvez utiliser les exemples de requêtes suivants pour obtenir des informations sur les ressources de l'API Android Management :

  • Répertoriez les appareils dans l'ENTERPRISE_ID de l'entreprise.
  • Obtenez des informations sur l'appareil DEVICE_ID dans l'entreprise ENTERPRISE_ID.
  • Affiche les détails de la règle POLICY_NAME.
  • Quelles applications sont disponibles dans ENTERPRISE_ID Enterprise ?

Dans les requêtes, remplacez les éléments suivants :

  • ENTERPRISE_ID : nom de ressource de l'entreprise, par exemple enterprises/LC012345.
  • DEVICE_ID : nom de ressource de l'appareil.
  • POLICY_NAME : nom de ressource de la règle.

Configurations de sécurité et de protection facultatives

Le MCP introduit de nouveaux risques et considérations de sécurité en raison de la grande variété d'actions qui peuvent être effectuées avec les outils MCP. Pour minimiser et gérer ces risques, Google Cloud propose des règles par défaut et personnalisables permettant de contrôler l'utilisation des outils de gestion de la conformité et de la confidentialité dans votre organisation ou projet Google Cloud.

Pour en savoir plus sur la sécurité et la gouvernance de MCP, consultez Sécurité et sûreté de l'IA.

Contrôler l'utilisation de MCP avec des stratégies de refus IAM

Les stratégies de refus Identity and Access Management (IAM) vous aident à sécuriser les serveurs MCP distants Google Cloud. Configurez ces règles pour bloquer l'accès indésirable aux outils MCP.

Par exemple, vous pouvez refuser ou autoriser l'accès en fonction des critères suivants :

  • Le directeur.
  • Propriétés de l'outil, comme la lecture seule.
  • ID client OAuth de l'application.

Pour en savoir plus, consultez Contrôler l'utilisation de MCP avec Identity and Access Management.

Étape suivante