Registrar, testar e publicar o app conectado

Depois de atender aos pré-requisitos, siga estas etapas para registrar, configurar, testar e publicar seu app conectado.

Etapa 1: criar um app conectado

Para criar um app conectado:

  1. Faça login no Google Connected Console.
  2. Na página inicial, selecione Criar app.
  3. Na caixa de diálogo Escolha o que criar:
    • Se for solicitado que você aceite os Termos de Serviço de apps conectados, selecione Ver termos, leia e aceite o contrato e selecione Criar. Somente um administrador da conta pode aceitar o contrato.
    • Caso contrário, selecione Criar no card App conectado.

  4. Na caixa de diálogo Dê um nome ao seu app conectado, digite um nome para o app. Esse é o nome que será usado para exibir o app nos produtos do Google e é como os usuários vão mencioná-lo usando @. Selecione Próxima.

  5. Na caixa de diálogo Selecionar uma categoria de app conectado, selecione o domínio, a categoria ou o setor do seu app no menu Selecionar uma categoria.

  6. Na caixa de diálogo Escolher tipo de conexão, escolha uma das seguintes opções:

    • Servidor MCP: conecte um servidor MCP para oferecer seus serviços aos usuários do Gemini e da Pesquisa na Web, no Android e no iOS.
    • MCP do Android: exponha os recursos no dispositivo ao Gemini no Android para que ele possa ativar ações e concluir tarefas para os usuários no seu app.

    Saiba como configurar um app conectado ao MCP do Android. Só é possível escolher um tipo de conexão por app conectado, e isso não pode ser mudado depois.

  7. Selecione Criar app conectado.

Isso abre a página de visão geral de gerenciamento do seu app conectado (Configurar e testar seu app conectado), em que é possível configurar os detalhes do app, a conexão com o servidor MCP e os testadores.

Etapa 2: inserir os detalhes do app conectado

Para fornecer mais detalhes sobre o app conectado e configurar como ele aparece para os usuários:

  1. Na página de visão geral do app conectado, na linha Detalhes do app, selecione Começar (ou Gerenciar se estiver atualizando detalhes).
  2. Na parte de cima da página Detalhes do app, verifique o campo Nome do app conectado. Você pode atualizar o nome, se necessário. Ele é mostrado aos usuários nos produtos do Google e usado quando eles mencionam seu app com @.
  3. Na seção Detalhes públicos, em Ícone, faça upload do ícone do app (JPG ou PNG, até 1 MB e 512 px × 512 px).

  4. Preencha os seguintes campos:

    • Descrição: insira um resumo conciso de uma única frase (menos de 30 palavras) que descreva os principais recursos do seu app conectado e o que ele pode fazer. Esse texto é mostrado aos usuários, não é usado como instruções do modelo.
    • Recursos: insira pelo menos três tarefas de alto valor que seu app conectado pode realizar. Selecione Adicionar recurso para adicionar mais entradas. Não inclua números no início das suas capacidades. Inclua apenas um recurso por entrada. Se a categoria incluir recursos predefinidos, eles vão aparecer na parte de cima da lista e não poderão ser modificados.
    • Exemplos de comandos: insira pelo menos três exemplos de comandos que ajudem os usuários a entender o que podem pedir ou perguntar. Selecione Adicionar comando de exemplo para adicionar entradas.
      • Comece pelo menos dois comandos com @<YourAppName> (por exemplo, @Order Tracker where is my last order?).
      • Mencione o <YourAppName> de forma natural em pelo menos um comando sem começar com o nome do app (por exemplo, Track my recent order on Order Tracker).
      • Não inclua prefixos numerados (1., 2., 3.) nem coloque os comandos entre aspas ("...").

    • Localização em vários idiomas: para fornecer traduções para Descrição, Recursos e Exemplos de comandos, envolva o texto de cada localidade em tags de idioma no campo de entrada. Exemplo:

      <en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>

      O Connected Console valida automaticamente suas tags e mostra as localidades detectadas abaixo de cada campo (por exemplo, Found translations for 2 languages: en-US, es-ES).

    • URL dos Termos de Serviço: insira um link https:// ou http:// válido para seus Termos de Serviço.

    • URL da política: insira um link https:// ou http:// válido para sua Política de Privacidade.

    • URL do site (opcional): insira um link para seu site para fins de atribuição.

  5. Selecione Salvar na parte de baixo da página para voltar à página de visão geral.

Etapa 3: inserir o endpoint do MCP e verificar a propriedade do domínio

Antes que o Google possa se conectar ao seu servidor MCP ou sincronizar suas ferramentas, você precisa fornecer o URL do endpoint do servidor MCP e verificar se é o proprietário do domínio em que ele está hospedado.

Para inserir o endpoint do MCP e verificar a propriedade do domínio:

  1. Na página de visão geral do app conectado, no card Configuração do MCP e das ferramentas, selecione Começar (ou Gerenciar se estiver atualizando os detalhes atuais). Isso abre a Etapa 1 (Endpoints do servidor MCP) do fluxo de configuração do MCP.
  2. Em Conecte o endpoint do servidor MCP, insira o URL HTTPS completo do endpoint do servidor MCP (por exemplo, https://api.yourdomain.com/v1/mcp).

  3. Em Verificar seu domínio, conclua a verificação do token de desafio do seu domínio. Se você já tiver verificado o domínio ou o domínio pai dele na sua conta de desenvolvedor, ele vai aparecer automaticamente como verificado:

    1. No card Verificar a propriedade do domínio, selecione Fazer o download do token. O navegador vai baixar um arquivo chamado google-connected-apps.json com a seguinte estrutura:

      {
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}

    2. Faça upload e hospede esse conteúdo JSON no seu servidor em https://<your-domain>/.well-known/google-connected-apps.

      • Verifique se o endpoint está acessível publicamente por HTTPS, retorna HTTP 200 OK diretamente sem redirecionamentos HTTP e inclui seu token na matriz verification_tokens.

    3. Volte para o Google Connected Console e selecione Verificar domínio.

    4. Depois que a verificação for concluída, a linha Domínio verificado com token de desafio vai mostrar uma marca de seleção verde e desbloquear a seção Credenciais de acesso abaixo dela.

Etapa 4: configurar as credenciais de acesso

Depois de verificar seu domínio, configure como o Google se autentica com seu servidor MCP e busque as definições de ferramentas do servidor.

Para configurar as credenciais de acesso:

  1. Na seção Fornecer credenciais de acesso (na Etapa 1 da página Configuração do MCP e das ferramentas), selecione Começar (ou Atualizar credenciais para modificar uma configuração atual).

  2. Em Seu servidor exige autorização?, selecione uma das seguintes opções:

    • Não: selecione essa opção se o servidor MCP estiver acessível publicamente sem autenticação e, em seguida, selecione Confirmar.

    • Sim: selecione essa opção se alguma das ferramentas expostas pelo servidor MCP exigir autorização. Em seguida, em Selecione o modelo de autorização usado pelo servidor MCP, escolha o fluxo de autenticação:

      • Máquina para máquina (credenciais de cliente OAuth): selecione essa opção para autenticação de serviço para serviço (RFC 6749), em que o Google se comunica diretamente com seu servidor MCP usando um ID do cliente e uma chave secreta compartilhados, sem redirecionamentos de login do usuário final:
        1. Insira o ID do cliente (obrigatório) e a chave secreta do cliente (opcional).
        2. Se quiser, insira um Endpoint de autorização (opcional) e um Endpoint de token (opcional) se o servidor não os anunciar usando /.well-known/oauth-authorization-server.
        3. Selecione Registrar cliente (ou Atualizar cliente).

      • Delegado pelo usuário (código de autorização): selecione essa opção se o servidor MCP exigir que os usuários façam login e autorizem ações com as próprias contas usando a vinculação da Conta do Google:

        1. Adicionar os URIs de redirecionamento do OAuth do Google à lista de permissões: no banner Verifique se você adicionou os URIs de redirecionamento fornecidos à lista de permissões, selecione Ver (ou selecione o ícone de cópia) para inspecionar os URIs de redirecionamento específicos do app gerados para seu app conectado. Adicione-os à lista de permissões do servidor OAuth e volte para o Console de Conexão do Google.
        2. Em Selecione como o Google deve se autenticar com seu servidor OAuth, selecione como seu cliente OAuth está registrado:
          • Pré-registrado: escolha esta opção se você gerar um ID do cliente e uma chave secreta do cliente (opcional) estáticos no seu provedor OAuth. Também é possível fornecer um Endpoint de autorização personalizado (opcional) e um Endpoint de token personalizado (opcional).
          • Metadados de ID do cliente ou registro dinâmico de clientes (recomendado): escolha esta opção se o servidor for compatível com os documentos de metadados de ID do cliente (CIMD) do OAuth ou com o registro dinâmico de clientes (RFC 7591). O Google verifica primeiro o CIMD e volta para o DCR usando os endpoints de descoberta .well-known. Também é possível especificar endpoints personalizados de autorização e token.

        3. Em Autenticar com suas credenciais de desenvolvedor, como você selecionou o modelo de autorização Delegado pelo usuário, é necessário fazer login no servidor antes que o Google possa buscar ferramentas. Selecione uma das opções:

          • Autenticar via pop-up (recomendado): abre o fluxo de autenticação em uma caixa de diálogo sobreposta. Essa é a experiência padrão.
          • Autenticar por redirecionamento (alternativa): abre o fluxo de autenticação usando um redirecionamento em tela cheia na mesma guia ou janela. Use essa opção se a caixa de diálogo não for renderizada devido a restrições de exibição ou cabeçalhos de segurança (como X-Frame-Options ou Content-Security-Policy).

          Recomendamos que você tente primeiro fazer a autenticação usando a caixa de diálogo. Se não for possível autenticar usando a caixa de diálogo, use o Redirect Method. Sua seleção também determina a experiência de login para os usuários quando eles usam o app conectado pela primeira vez.

        4. Selecione Registrar cliente (ou Atualizar cliente).

Etapa 5: fornecer detalhes da conta de teste (somente para autorização delegada pelo usuário)

Se o app conectado exigir autenticação, você precisará fornecer credenciais de teste previamente preenchidas com dados de amostra realistas e com a autenticação de dois fatores (2FA) desativada, além de instruções de teste para o representante do Google. Isso permite que a equipe de análise e controle de qualidade do Google verifique a execução da ferramenta sem ser bloqueada por sandboxes vazios, paywalls ou desafios de 2FA. Se o Google não conseguir testar totalmente o app conectado, ele poderá ser rejeitado durante a revisão.

Etapa 6: sincronizar as ferramentas

Para criar cada versão do app conectado, o Google sincroniza com o endpoint fornecido para receber as ferramentas disponíveis e criar um snapshot. Essas são as ferramentas que estarão disponíveis para os usuários nessa versão. Enquanto a versão do app conectado estiver em pré-lançamento e disponível para testadores, você poderá continuar fazendo mudanças no servidor e sincronizando novamente as ferramentas para atualizar. Isso cria um novo snapshot das suas ferramentas.

Quando você publica, o snapshot mais recente das suas ferramentas é usado para essa versão do app conectado. Não será mais possível fazer mudanças nas ferramentas, descrições ou detalhes do servidor. Para atualizar as ferramentas ou sincronizar as modificações do servidor, crie uma nova versão do app conectado. Recomendamos criar um novo endpoint para cada versão do app conectado.

Para sincronizar ferramentas:

  1. Na seção Ferramentas de sincronização:

    1. Selecione Ferramentas de sincronização.
    2. Se for solicitado que você faça login, autentique-se com uma conta de desenvolvedor que tenha permissões para listar todas as ferramentas que você pretende expor aos usuários. As ferramentas que sua conta não pode acessar não são sincronizadas.
    3. Depois de conectado, o Connected Console mostra o número de ferramentas sincronizadas, além de um botão Sincronizar ferramentas novamente.

  2. Selecione Próxima na parte de baixo da página para avançar para a etapa 2 da configuração do MCP e das ferramentas.

Etapa 7: determinar como e onde os usuários usam seu app

Na seção Ferramentas da página Configuração do MCP e das ferramentas, configure parâmetros básicos, como onde seu app conectado está disponível geograficamente, o idioma dele e os produtos do Google em que você quer disponibilizá-lo.

  1. Em Disponibilidade, ao lado de Disponibilizar a versão em, configure as seguintes opções de segmentação:
    • Países / regiões: selecione as localizações geográficas em que o app conectado deve estar disponível.
    • Idiomas: selecione os idiomas disponíveis no app conectado.
    • Produtos: selecione os produtos do Google em que o app conectado vai estar disponível.

  2. Na seção Ferramentas, depois de Disponibilidade, confira as ferramentas sincronizadas do seu servidor MCP. Selecione qualquer ferramenta na lista Ferramentas para definir as configurações no painel Gerenciar ferramenta à direita:

    • Ativar ferramenta: use o botão Ativar ferramenta para incluir ou excluir a ferramenta no app conectado. As ferramentas desativadas não estarão disponíveis no app conectado para os usuários interagirem.

    • Contexto adicional: selecione se a ferramenta precisa de indicadores contextuais do Google para funcionar:

      • Localidade: a localidade determinada pela Conta do Google do usuário.
      • Local aproximado: local físico do usuário ou do dispositivo em uma área igual ou superior a 3 quilômetros quadrados (por exemplo, a cidade em que o usuário está).
      • Local exato: localização física do usuário ou do dispositivo com precisão de até 50 metros.

    • Confirmação do usuário: selecione Confirmação do usuário necessária para exigir uma confirmação explícita do usuário antes de executar a ferramenta. Isso é pré-selecionado automaticamente se as anotações do MCP da ferramenta especificarem destructiveHint: true.

  3. Se o servidor MCP fornecer recursos de interface, mude para a guia Recursos de interface ao lado de Ferramentas para inspecionar os recursos de interface do servidor (text/html, text/html;profile=mcp-app, text/javascript, text/css), verificar quais ferramentas estão vinculadas a cada recurso e analisar a Política de Segurança de Conteúdo (CSP) connectDomains e resourceDomains.

  4. Selecione Salvar na parte de baixo da página.

Depois que os Detalhes do app e a Configuração do MCP e das ferramentas forem salvos, sua configuração vai ficar automaticamente disponível para todos os testadores que você adicionou para visualização, e o status da versão na página de visão geral será atualizado para Disponível para testadores.

Etapa 8: testar o app conectado

Para disponibilizar seu app conectado aos testadores, adicione-os na tela "Gerenciar testadores". Somente os usuários que você adicionar à lista de testadores poderão ver e interagir com seu app conectado não publicado. Só é possível adicionar testadores que tenham uma conta do @gmail.com.

  1. Na página de visão geral do app conectado, no card Testar o app, selecione Adicionar testadores (ou Gerenciar testadores, se você já tiver adicionado alguns).

  2. Na tela Gerenciar testadores, selecione as listas de e-mails atuais ou Criar lista de e-mails para adicionar as Contas do Google autorizadas a testar sua integração. Inclua seu próprio endereço de e-mail se quiser testar o app.

  3. Selecione Salvar.

  4. Os testadores no app do Gemini podem invocar seu app conectado digitando @ seguido do nome do app e selecionando-o no menu. Você também pode ver e conectar seu app no Gemini acessando Configurações e ajuda → Apps conectados na barra de navegação à esquerda.

  5. Recomendamos testar sua integração:

    • Teste todos os exemplos de comandos.
    • Teste as invocações explícitas de @<AppName> e as consultas em linguagem natural.
    • Verifique o fluxo de autenticação de ponta a ponta, a execução da ferramenta, as solicitações de confirmação do usuário e todos os recursos da interface.

Quando estiver tudo pronto, envie o app conectado ao Google para análise.

Etapa 9: iniciar uma revisão do app conectado e publicar após a aprovação

Antes que seu app conectado seja disponibilizado para todos os usuários, o Google analisa e testa sua integração.

Para enviar seu app conectado para revisão, faça o seguinte:

  1. Na página de visão geral do app conectado, no card Versões à direita, selecione Enviar para revisão (ativado quando a configuração do app estiver concluída e em pré-lançamento sem problemas de bloqueio).

  2. Enquanto sua versão estiver em análise:

    • O Connected Console cria automaticamente uma nova versão de rascunho editável para que os testadores possam continuar visualizando o app e você possa preparar futuras edições sem interromper a revisão.
    • Bloqueia todas as mudanças na versão em análise.
    • Para ver os detalhes somente leitura da versão em análise ou cancelar a revisão, selecione o botão de mais opções (⋮) no card Em análise e selecione Ver detalhes do app ou Cancelar revisão.

  3. Quando o Google concluir a análise, você vai receber uma notificação, e o card Versões será atualizado:

    • Se houver problemas: o card Versões vai mostrar Problemas encontrados. Selecione Ver problemas para inspecionar as descobertas específicas da análise. Atualize a configuração ou o servidor MCP na versão de pré-lançamento editável, verifique as correções com os testadores e selecione Enviar para revisão novamente.
    • Se aprovado: o card Versões vai mostrar Pronto para publicar. Selecione Publicar quando estiver tudo pronto para lançar o app conectado para os usuários.

Parabéns! Seu app conectado foi publicado e está sendo lançado para os usuários nos produtos do Google que você selecionou.

Gerenciamento de versões contínuo e pós-publicação

Depois de publicado, o card inferior em Versões mostra Publicado com o número da versão ativa do app conectado, a data de publicação e a contagem de países/regiões, idiomas e produtos segmentados. Selecione o menu Mais opções (⋮) no card Publicado e escolha Ver detalhes do app a qualquer momento para inspecionar a configuração somente leitura da sua versão ativa.

Enquanto a versão publicada permanece ativa na produção, você pode usar o painel Editar e testar seu app conectado à esquerda (ou selecionar Criar nova versão se não houver um rascunho) para configurar, visualizar e testar atualizações em uma nova versão (Version <N+1>) de forma independente antes de enviá-la para revisão e publicação.