Informações gerais sobre o Modo de Desenvolvedor dos apps do Gemini

O Modo de Desenvolvedor dos apps do Gemini é um espaço de trabalho interativo de depuração e avaliação baseado na Web, em que é possível inspecionar a execução de ferramentas em tempo real, validar esquemas e simular o contexto do usuário antes de enviar o app conectado para revisão.

É possível conectar seu servidor do Protocolo de Contexto de Modelo (MCP) ao Modo de Desenvolvedor de duas maneiras, dependendo do seu fluxo de trabalho:

  • Pelo Google Connected Console: se você estiver integrando seu servidor MCP no Google Connected Console, poderá iniciar o Modo de Desenvolvedor com seu app registrado já pré-selecionado.
  • Como um app MCP personalizado: se você quiser criar um protótipo ou depurar um endpoint de servidor MCP HTTPS implantado antes de registrá-lo no console, conecte seu servidor diretamente no Gemini como um app MCP personalizado.

O Modo de Desenvolvedor dos apps do Gemini ajuda você a realizar as seguintes tarefas:

  • Inspecione payloads de solicitação e resposta JSON-RPC ativos, códigos de status HTTP e latência de execução em tempo real.
  • Verifique como o Gemini analisa os esquemas de ferramentas do MCP, as restrições de parâmetros e as anotações de segurança.
  • Simule atributos do ambiente do usuário, como data, hora e idioma, e teste os fluxos de autenticação do cliente.

Para entrar no Modo de Desenvolvedor dos apps do Gemini no web app Gemini, faça o seguinte:

  1. Abra o app Gemini no navegador da Web.
  2. Clique em Configurações > Modo de Desenvolvedor dos apps do Gemini ou acesse diretamente gemini.google.com/devmode.
  3. Na caixa de diálogo Escolher um app, selecione o app conectado registrado (se ele ainda não estiver pré-selecionado) ou clique em + Criar novo para conectar um endpoint de servidor MCP HTTPS como um app MCP personalizado. Para instruções completas de configuração, consulte Ativar o Modo de Desenvolvedor dos apps do Gemini.

Espaço de trabalho de painel dividido

Ao ativar o Modo de Desenvolvedor de apps do Gemini e selecionar seu app personalizado do MCP, o Gemini abre um espaço de trabalho de painel dividido vinculado ao endpoint do seu servidor. A barra de cabeçalho superior mostra o nome do app ativo e permite alternar entre os apps personalizados conectados. Para reabrir o painel lateral do Modo de Desenvolvedor dos apps do Gemini, acesse Configurações > Modo de Desenvolvedor dos apps do Gemini a qualquer momento.

Interface de painel dividido do Modo de Desenvolvedor dos apps do Gemini mostrando uma conversa no Gemini à esquerda e o inspetor de registro de eventos à direita com um evento get_summit_info expandido exibindo 200 OK, latência de execução e payloads JSON de solicitação e resposta formatados.
Figura 1. O espaço de trabalho de painel dividido do Modo de Desenvolvedor dos apps do Gemini mostrando a prévia da conversa no Gemini e o inspetor do Registro de Eventos.

Prévia da conversa no Gemini

O painel à esquerda simula a experiência do cliente do Gemini para que você possa testar como os usuários finais interagem com seu app conectado.

Guias de inspetor e telemetria

O painel direito oferece quatro guias de diagnóstico e configuração para inspecionar e testar seu servidor MCP:

  • Log de eventos: mostra um fluxo cronológico de telemetria de comandos, interações com a interface, solicitações de saída do Tool call e respostas de entrada do Tool result. Cada evento mostra selos para o código de status HTTP, a latência de execução em milissegundos e o tamanho do payload em kilobytes. É possível expandir um evento para revelar o texto completo do comando e os payloads de solicitação e resposta JSON-RPC formatados. Use Limpar e Exportar para gerenciar a telemetria da sessão.
  • Esquemas de ferramentas: lista as instruções do servidor e todas as operações retornadas pelo endpoint tools/list do servidor. É possível filtrar ferramentas usando Filtrar ferramentas, analisar selos de segurança e autenticação (Somente leitura, Destrutivo, Autenticação necessária) e expandir qualquer ferramenta para inspecionar os tipos de parâmetro, campos obrigatórios, descrições, JSON de Esquema bruto e estrutura de resposta de amostra. Você também pode clicar em Sincronizar esquema para buscar novamente tools/list do servidor MCP sem redefinir o histórico de conversas.
  • Ambiente: oferece controles de contexto simulado para testar o comportamento da ferramenta dependente de contexto sem modificar sua máquina local. É possível substituir Data e hora (Data simulada e Hora simulada) e Preferências (Idioma) ou clicar em Redefinir para restaurar os valores padrão.
  • Autenticação: configura como o Gemini estabelece as credenciais do cliente e do usuário com seu servidor MCP em Registro dinâmico de clientes.
Guia "Esquemas de ferramentas" mostrando selos de segurança, restrições de parâmetros e prévias de respostas.
Figura 2. A guia Esquemas de ferramentas, que mostra selos de segurança, restrições de parâmetros e prévias de respostas.

Anotações de segurança e encadeamento de ferramentas

O Gemini avalia as anotações da ferramenta MCP e o contexto da conversa ativa para determinar quando pedir a confirmação do usuário antes de executar uma ferramenta. Durante os testes no Modo de Desenvolvedor dos apps do Gemini, verifique se as ferramentas declaram as anotações readOnlyHint e destructiveHint adequadas e invocam cards de confirmação quando esperado.

Outros recursos