Usar o servidor MCP da API Android Management

Este documento mostra como usar o servidor remoto do Protocolo de Contexto de Modelo (MCP) da API Android Management para se conectar a aplicativos de IA, incluindo a CLI do Gemini, o ChatGPT, o Claude e aplicativos personalizados que você está desenvolvendo. O servidor MCP remoto da API Android Management permite que agentes de IA acessem dados de mobilidade empresarial de forma programática. Ele permite consultas em linguagem natural sobre frotas de dispositivos, auditoria automatizada de conformidade com políticas e integração de dados de gerenciamento de dispositivos em fluxos de trabalho automatizados mais amplos. O servidor MCP remoto da API Android Management é ativado quando você ativa a API Android Management.

O padrão do Protocolo de Contexto de Modelo (MCP) padroniza como os modelos de linguagem grandes (LLMs) e os aplicativos ou agentes de IA se conectam a fontes de dados externas. Com os servidores MCP, você pode usar as ferramentas, os recursos e os comandos deles para realizar ações e receber dados atualizados do serviço de back-end.

Qual é a diferença entre servidores MCP locais e remotos?

Servidores MCP locais
Normalmente executados na máquina local e usam os fluxos de entrada e saída padrão (stdio) para comunicação entre serviços no mesmo dispositivo.
Servidores MCP remotos
Executar na infraestrutura do serviço e oferecer um endpoint HTTP para aplicativos de IA para comunicação entre o cliente MCP de IA e o servidor MCP. Para mais informações sobre a arquitetura do MCP, consulte Arquitetura do MCP.

Antes de começar

Para usar o servidor MCP remoto da API Android Management, crie um projeto do Google Cloud e ative a API.

  1. No console do Cloud, na página do seletor de projetos, selecione ou crie um projeto na nuvem do Google Cloud.

    Acessar o seletor de projetos

  2. Ative a API Android Management.

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão com o papel de Proprietário (roles/owner). Caso contrário, é possível receber essa permissão com o papel de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

    Ativar a API

Funções exigidas

Para receber as permissões necessárias para usar o servidor MCP remoto da API Android Management, peça ao administrador para conceder a você os seguintes papéis de gerenciamento de identidade e acesso no projeto do Google Cloud em que você quer ativar o servidor MCP da API Android Management:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para usar o servidor MCP remoto da API Android Management. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias.

Permissões necessárias

As seguintes permissões são necessárias para usar o servidor MCP remoto da API Android Management:

  • serviceusage.mcppolicy.get
  • serviceusage.mcppolicy.update
  • Fazer chamadas de ferramentas do MCP: mcp.tools.call
  • Acesse os recursos do Android Management:
    • androidmanagement.enterprises.get
    • androidmanagement.devices.list

Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.

Autenticação e autorização

Os servidores MCP da API Android Management usam o protocolo OAuth 2.0 com o Identity and Access Management para autenticação e autorização. Todas as identidades do Google Cloud são compatíveis com a autenticação em servidores MCP.

O servidor MCP remoto da API Android Management não aceita chaves de API.

Recomendamos criar uma identidade separada para agentes que usam ferramentas MCP para que o acesso aos recursos possa ser controlado e monitorado. Para mais informações sobre autenticação, consulte Autenticar em servidores do MCP.

Escopos OAuth do MCP da API Android Management

O OAuth 2.0 usa escopos e credenciais para determinar se um principal autenticado está autorizado a realizar uma ação específica em um recurso. Para mais informações sobre os escopos do OAuth 2.0 no Google, leia Como usar o OAuth 2.0 para acessar as APIs do Google.

A API Android Management tem os seguintes escopos do OAuth da ferramenta MCP:

URI de escopo para gcloud Descrição
https://www.googleapis.com/auth/androidmanagement Gerencie dispositivos e apps Android.

Outros escopos podem ser necessários nos recursos acessados durante uma chamada de ferramenta. Para conferir uma lista dos escopos necessários para a API Android Management, consulte API Android Management.

Configurar um cliente do MCP para usar o servidor MCP da API Android Management

Aplicativos e agentes de IA, como Claude ou Antigravity, podem instanciar um cliente MCP que se conecta a um único servidor MCP. Um aplicativo de IA pode ter vários clientes que se conectam a diferentes servidores do MCP. Se o aplicativo não estiver listado nas orientações específicas do cliente, use as informações a seguir para se conectar na maioria dos aplicativos.

No seu aplicativo de IA, procure uma maneira de adicionar ou se conectar a um servidor MCP remoto. Para o servidor MCP da API Android Management, insira as seguintes informações conforme necessário:

  • Nome do servidor: servidor MCP da API Android Management
  • URL do servidor ou Endpoint: https://androidmanagement.googleapis.com/mcp
  • Transporte: HTTP
  • Detalhes da autenticação: dependendo de como você quer fazer a autenticação, é possível inserir suas credenciais do Google Cloud, o ID e a chave secreta do cliente OAuth ou uma identidade e credenciais do agente. Para mais informações sobre autenticação, consulte Autenticar em servidores do MCP.

Para orientações específicas sobre como configurar e se conectar ao servidor MCP, consulte Orientações específicas do cliente.

Para orientações mais gerais, consulte os seguintes recursos:

Ferramentas disponíveis

Para conferir detalhes das ferramentas do MCP disponíveis e as descrições delas para o servidor MCP da API Android Management, consulte a referência do MCP da API Android Management.

Ferramentas de lista

Use o MCP Inspector para listar ferramentas ou envie uma solicitação HTTP tools/list diretamente para o servidor MCP remoto da API Android Management. O método tools/list não requer autenticação.

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

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

Exemplos de casos de uso

Confira a seguir exemplos de casos de uso do servidor MCP da API Android Management:

  • Consultas em linguagem natural: faça perguntas complexas sobre sua frota de dispositivos sem escrever código. Por exemplo: "Quais dos meus dispositivos não estão em conformidade com o patch de segurança mais recente?"
  • Auditorias automatizadas:buscam dados periodicamente e compilam relatórios sobre o status do dispositivo e a adesão à política.
  • Alertas inteligentes:monitore os dados da frota para sinalizar anomalias ou possíveis problemas com base em insights em tempo real.

Comandos de amostra

Use os exemplos de comandos a seguir para receber informações sobre recursos da API Android Management:

  • Liste os dispositivos na empresa ENTERPRISE_ID.
  • Recebe detalhes do dispositivo DEVICE_ID na empresa ENTERPRISE_ID.
  • Mostre os detalhes da política POLICY_NAME.
  • Quais aplicativos estão disponíveis no ENTERPRISE_ID empresarial?

Nos comandos, substitua o seguinte:

  • ENTERPRISE_ID: o nome do recurso da empresa. Por exemplo, enterprises/LC012345.
  • DEVICE_ID: o nome do recurso do dispositivo.
  • POLICY_NAME: o nome do recurso da política.

Configurações opcionais de segurança

O MCP apresenta novos riscos e considerações de segurança devido à ampla variedade de ações que podem ser feitas com as ferramentas do MCP. Para minimizar e gerenciar esses riscos, o Google Cloud oferece políticas padrão e personalizáveis para controlar o uso das ferramentas do MCP na sua organização ou projeto do Google Cloud.

Para mais informações sobre segurança e governança do MCP, consulte Segurança e proteção de IA.

Controlar o uso do MCP com políticas de negação do IAM

As políticas de negação do Identity and Access Management (IAM) ajudam a proteger os servidores MCP remotos do Google Cloud. Configure essas políticas para bloquear o acesso indesejado às ferramentas do MCP.

Por exemplo, é possível negar ou permitir o acesso com base em:

  • O principal.
  • Propriedades da ferramenta, como somente leitura.
  • O ID do cliente OAuth do aplicativo.

Para mais informações, consulte Controlar o uso do MCP com o Identity and Access Management.

A seguir