MCP Tools Reference: Android Device Management MCP Server

Herramienta: list_enterprises

Enumera las empresas a las que puede acceder el llamador.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP list_enterprises.

Solicitud de Curl 
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_enterprises",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Solicitud para enumerar las empresas administradas por EMM.

ListEnterprisesRequest

Representación JSON 
{
  "projectId": string,
  "pageSize": integer,
  "pageToken": string,
  "view": enum (EnterpriseView)
}
Campos
projectId

string

Obligatorio. Es el ID del proyecto de Cloud del EMM que administra las empresas.
pageSize

integer

Es el tamaño de página solicitado. El tamaño real de la página puede fijarse en un valor mínimo o máximo.
pageToken

string

Es un token que identifica una página de resultados que devuelve el servidor.
view

enum (EnterpriseView)

Especifica qué campos de Enterprise se deben devolver. Este método solo admite BASIC.

Esquema de salida

Es la respuesta a una solicitud para enumerar empresas.

ListEnterprisesResponse

Representación JSON 
{
  "enterprises": [
    {
      object (Enterprise)
    }
  ],
  "nextPageToken": string
}
Campos
enterprises[]

object (Enterprise)

Es la lista de empresas.
nextPageToken

string

Si hay más resultados, se incluye un token para recuperar la siguiente página de resultados.

Enterprise

Representación JSON 
{
  "name": string,
  "enabledNotificationTypes": [
    enum (NotificationType)
  ],
  "pubsubTopic": string,
  "primaryColor": integer,
  "logo": {
    object (ExternalData)
  },
  "enterpriseDisplayName": string,
  "termsAndConditions": [
    {
      object (TermsAndConditions)
    }
  ],
  "appAutoApprovalEnabled": boolean,
  "signinDetails": [
    {
      object (SigninDetail)
    }
  ],
  "contactInfo": {
    object (ContactInfo)
  },
  "googleAuthenticationSettings": {
    object (GoogleAuthenticationSettings)
  },
  "enterpriseType": enum (EnterpriseType),
  "managedGooglePlayAccountsEnterpriseType": enum (ManagedGooglePlayAccountsEnterpriseType),
  "managedGoogleDomainType": enum (ManagedGoogleDomainType)
}
Campos
name

string

Nombre de la empresa que genera el servidor durante la creación, con el formato enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

Son los tipos de notificaciones de Google Pub/Sub habilitadas para la empresa.
pubsubTopic

string

Es el tema en el que se publican las notificaciones de Pub/Sub, en el formato projects/{project}/topics/{topic}. Este campo solo es obligatorio si las notificaciones de Pub/Sub están habilitadas.
primaryColor

integer

Es un color en formato RGB que indica el color predominante que se mostrará en la IU de la app de administración de dispositivos. Los componentes de color se almacenan de la siguiente manera: (red << 16) | (green << 8) | blue, donde el valor de cada componente está entre 0 y 255, inclusive.
logo

object (ExternalData)

Imagen que se muestra como logotipo durante el aprovisionamiento del dispositivo. Los tipos admitidos son: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng.
enterpriseDisplayName

string

Es el nombre de la empresa que se muestra a los usuarios. La longitud máxima de este campo es 10 caracteres.
termsAndConditions[]

object (TermsAndConditions)

Son los términos y condiciones que se deben aceptar cuando se aprovisiona un dispositivo para esta empresa. Se genera una página de condiciones para cada valor de esta lista.
appAutoApprovalEnabled
(deprecated)

boolean

Está obsoleto y no se usa.
signinDetails[]

object (SigninDetail)

Son los detalles de acceso de la empresa.
contactInfo

object (ContactInfo)

Es la información de contacto de la empresa administrada por EMM.
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Es la configuración para la autenticación de usuarios proporcionada por Google.
enterpriseType

enum (EnterpriseType)

Solo salida. Es el tipo de empresa.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

Solo salida. Es el tipo de cuenta empresarial de Google Play administrado.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

Solo salida. Es el tipo de dominio de Google administrado.

Int32Value

Representación JSON 
{
  "value": integer
}
Campos
value

integer

Es el valor int32.

ExternalData

Representación JSON 
{
  "url": string,
  "sha256Hash": string
}
Campos
url

string

Es la URL absoluta de los datos, que debe usar el esquema http o https. La Política de dispositivos Android no proporciona ninguna credencial en la solicitud GET, por lo que la URL debe ser de acceso público. Incluir un componente largo y aleatorio en la URL puede evitar que los atacantes la descubran.
sha256Hash

string

Es el hash SHA-256 codificado en base64 del contenido alojado en la URL. Si el contenido no coincide con este hash, Android Device Policy no usará los datos.

TermsAndConditions

Representación JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Campos
header

object (UserFacingMessage)

Es un encabezado corto que aparece sobre el contenido HTML.
content

object (UserFacingMessage)

Es una cadena HTML con un formato adecuado. Se analizará en el cliente con android.text.Html#fromHtml.

UserFacingMessage

Representación JSON 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Campos
localizedMessages

map (key: string, value: string)

Es un mapa que contiene pares <configuración regional, mensaje>, en el que la configuración regional es un código de idioma BCP 47 bien formado, como en-US, es-ES o fr.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
defaultMessage

string

Es el mensaje predeterminado que se muestra si no se especifica ningún mensaje localizado o si la configuración regional del usuario no coincide con ninguno de los mensajes localizados. Se debe proporcionar un mensaje predeterminado si se proporcionan mensajes localizados.

LocalizedMessagesEntry

Representación JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

SigninDetail

Representación JSON 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "defaultStatus": enum (SigninDetailDefaultStatus),

  // Union field _token_tag can be only one of the following:
  "tokenTag": string
  // End of list of possible types for union field _token_tag.
}
Campos
signinUrl

string

Es la URL de acceso para la autenticación cuando el dispositivo se aprovisiona con un token de inscripción de acceso. El extremo de acceso debe finalizar el flujo de autenticación con una URL con el formato https://enterprise.google.com/android/enroll?et= para un acceso exitoso o https://enterprise.google.com/android/enroll/invalid para un acceso fallido.
signinEnrollmentToken

string

Es un token de inscripción para toda la empresa que se usa para activar el flujo de acceso personalizado. Este es un campo de solo lectura que genera el servidor.
qrCode

string

Es una cadena JSON cuya representación UTF-8 se puede usar para generar un código QR que permita inscribir un dispositivo con este token de inscripción. Para inscribir un dispositivo con NFC, el registro de NFC debe contener una representación serializada de java.util.Properties de las propiedades en el JSON. Este es un campo de solo lectura que genera el servidor.
allowPersonalUsage

enum (AllowPersonalUsage)

Controla si se permite el uso personal en un dispositivo aprovisionado con este token de inscripción.

En el caso de los dispositivos empresariales, haz lo siguiente:

  • Habilitar el uso personal permite que el usuario configure un perfil de trabajo en el dispositivo.
  • Para inhabilitar el uso personal, el usuario debe aprovisionar el dispositivo como un dispositivo completamente administrado.

En el caso de los dispositivos personales, haz lo siguiente:

  • Habilitar el uso personal permite que el usuario configure un perfil de trabajo en el dispositivo.
  • Si inhabilitas el uso personal, el dispositivo no se podrá aprovisionar. No se puede inhabilitar el uso personal en dispositivos de propiedad personal.
defaultStatus

enum (SigninDetailDefaultStatus)

Opcional. Indica si la URL de acceso se debe usar de forma predeterminada para la empresa. El SigninDetail con defaultStatus establecido en SIGNIN_DETAIL_IS_DEFAULT se usa para el método de inscripción de la Cuenta de Google. Solo uno de los signinDetails de una empresa puede tener defaultStatus establecido en SIGNIN_DETAIL_IS_DEFAULT. Si un Enterprise tiene al menos un signinDetails y ninguno de ellos tiene defaultStatus establecido en SIGNIN_DETAIL_IS_DEFAULT, se selecciona el primero de la lista y se establece defaultStatus en SIGNIN_DETAIL_IS_DEFAULT. Si no se especifica ningún signinDetails para el Enterprise, fallará la inscripción del dispositivo en la Cuenta de Google.

Campo de unión _token_tag.

_token_tag puede ser una de las siguientes opciones:
tokenTag

string

Son metadatos especificados por el EMM para distinguir entre instancias de SigninDetail.

ContactInfo

Representación JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Campos
contactEmail

string

Dirección de correo electrónico de un punto de contacto, que se usará para enviar anuncios importantes relacionados con Google Play administrado.
dataProtectionOfficerName

string

Nombre del oficial de protección de datos.
dataProtectionOfficerEmail

string

Es el correo electrónico del oficial de protección de datos. El correo electrónico se valida, pero no se verifica.
dataProtectionOfficerPhone

string

Número de teléfono del oficial de protección de datos. El número de teléfono se valida, pero no se verifica.
euRepresentativeName

string

Nombre del representante de la UE.
euRepresentativeEmail

string

Es el correo electrónico del representante de la UE. El correo electrónico se valida, pero no se verifica.
euRepresentativePhone

string

Número de teléfono del representante de la UE. Se valida el número de teléfono, pero no se verifica.

GoogleAuthenticationSettings

Representación JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Campos
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Solo salida. Indica si los usuarios deben autenticarse con Google durante el proceso de inscripción. El administrador de TI puede especificar si la autenticación de Google está habilitada para la empresa en los dispositivos de los trabajadores del conocimiento. Este valor solo se puede establecer a través de la Consola del administrador de Google. La autenticación de Google se puede usar con signin_url. En el caso de que se requiera la autenticación de Google y se especifique un signin_url, la autenticación de Google se iniciará antes de signin_url.

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌