Pré-requisitos para usar apps conectados

Antes de começar, certifique-se de ter o seguinte:

  • Um servidor MCP implantado com um endpoint HTTPS seguro

    O servidor MCP precisa ser acessível publicamente por HTTPS usando o transporte HTTP transmissível (por exemplo, https://api.yourdomain.com/v1/mcp).

    Consulte o guia para desenvolvedores do servidor MCP da Connected Apps Platform para detalhes de implementação.

  • Verifique se o servidor pode receber solicitações do Google

    Se o servidor restringir o acesso externo por IP de origem, inclua os seguintes endereços IP na lista de permissões:

    • 108.177.64.0/20
    • 142.250.88.0/22
    • 172.217.80.0/20
    • 192.178.20.0/22
    • 192.179.0.0/20
    • 74.125.232.0/24
    • 136.121.40.0/21

    Os intervalos de IP de saída do Google podem mudar ao longo do tempo. Por isso, recomendamos que você os leia nas listas publicadas pelo Google e atualize sua lista de permissões regularmente:

  • Acesso a uma conta de desenvolvedor registrada no Google Connected Console

    Depois de fazer login, verifique se você tem uma das seguintes permissões de apps conectados no Google Connected Console:

    • Ver apps conectados
    • Criar e gerenciar apps conectados

    Os Termos de Serviço dos Apps Conectados também precisam ser aceitos por um proprietário ou administrador da conta. Na primeira vez que sua organização acessar os apps conectados no Google Connected Console, um proprietário da conta ou administrador precisará fazer login e aceitar o contrato do programa antes que os membros da equipe convidados possam prosseguir.

    Se você acha que tem acesso, mas não consegue criar apps conectados, peça ao proprietário da conta ou administrador para conceder à sua conta de usuário a permissão "Ver apps conectados" ou "Criar e gerenciar apps conectados" na página Usuários e permissões.

  • Capacidade de hospedar um arquivo de verificação do .well-known no domínio do servidor MCP

    Para verificar a propriedade do domínio, você precisa disponibilizar um arquivo de token de desafio JSON diretamente (com HTTP 200 OK e sem redirecionamentos) em https://<your-domain>/.well-known/google-connected-apps.

  • Analisar as categorias de apps conectados disponíveis

    A categoria do seu app conectado está associada a recursos específicos que ele precisa oferecer para garantir uma experiência do usuário de alta qualidade. Depois que uma categoria de um app conectado é selecionada, ela não pode ser alterada. Saiba mais.

  • Um servidor MCP implantado com um URL de endpoint válido

    Consulte o guia para desenvolvedores do servidor MCP de apps conectados para mais detalhes.

  • Metadados públicos e propriedades da marca do seu app conectado

    • Nome do app conectado: o nome de exibição do app conectado mostrado aos usuários nos produtos do Google e usado quando os usuários mencionam seu app com @.
    • Descrição: um resumo conciso de uma única frase (com menos de 30 palavras) sobre o que o app conectado pode fazer pelos usuários, como "Acompanhe suas compras recentes, verifique o status da entrega e confira seu histórico de pedidos".
    • Ícone: um ícone do app de 512 px × 512 px no formato JPEG ou PNG, com um tamanho máximo de arquivo de 1 MB (1.024 kB).
    • Funcionalidades: pelo menos três tarefas de alto valor que seu app conectado pode realizar, como "Pesquisar seu histórico de pedidos" ou "Verificar o status de entrega em tempo real", além das funcionalidades padrão definidas pela categoria do app. Essas informações aparecem para que os usuários decidam se vão conectar o app. Não inclua números no início das suas capacidades.
    • Exemplos de comandos: pelo menos três exemplos de consultas que ajudam os usuários a entender o que podem perguntar. Comece pelo menos dois comandos de exemplo com o nome do app conectado. Mencione o nome do app de forma natural em pelo menos um comando (ou seja, sem começar com o nome do app). Não inclua números no início dos comandos de exemplo.
    • URL dos Termos de Serviço: um URL acessível publicamente para os Termos de Serviço do app conectado.
    • URL da Política de Privacidade: um URL acessível ao público para a Política de Privacidade do app conectado.
    • URL do site (opcional): um site para seu app conectado.