mailinapp
Documentation menu

Conectar o Gemini

Quais passos se aplicam depende de como você usa o Gemini: o aplicativo para consumidores (Spark), o Gemini Enterprise através da sua organização, ou a Antigravity CLI. Escolha abaixo o que corresponde ao seu caso.

Aplicativo Gemini (Spark)

  1. Vá em gemini.google.com → Configurações e ajuda → Apps conectados → Apps personalizados para o Spark → Adicionar um app personalizado.
  2. Cole https://mailinapp.com/api/mcp como a URL do servidor.
  3. Aprove a tela de consentimento do MailInApp quando o Gemini a abrir — faça login se necessário, escolha com qual conta se conectar caso pertença a mais de uma, escolha seus escopos (veja Escopos e permissões) e aprove.

Só isso — nada para submeter ou revisar, da mesma forma que conectar o Claude ou o ChatGPT. Se você não vir Apps personalizados para o Spark como opção, trata-se de uma restrição de elegibilidade do Google, não de algo do lado do MailInApp: atualmente o Google restringe apps personalizados do Spark a contas pessoais do Google, baseadas nos EUA, com 18 anos ou mais, com "Keep Activity" ativado e o app do Gemini definido para inglês. Fora dessas condições, a opção simplesmente não aparece.

Gemini Enterprise (através da sua organização)

Se sua empresa usa o Gemini Enterprise, você não pode adicionar o MailInApp sozinho(a) da forma como faria no aplicativo para consumidores — isso vem desativado por padrão, atrás de uma política organizacional, e ativá-lo é uma configuração única feita pelo(a) administrador(a) do seu Workspace, não por você. Envie estes detalhes ao seu administrador:

  • URL de autorização: https://mailinapp.com/oauth/authorize
  • URL do token: https://mailinapp.com/oauth/token
  • Escopos: qualquer combinação de Escopos e permissões, separados por espaço.
  • PKCE: ativado (S256).
  • Id/segredo do cliente: envie um e-mail para [email protected] com o URI de redirecionamento que o seu locatário (tenant) do Gemini Enterprise usa, e nós emitiremos um para o seu administrador inserir.

Depois que seu administrador configurar isso, conectar e usar o MailInApp através do Gemini Enterprise funciona da mesma forma que qualquer outro assistente — fazer login, escolher sua conta, escolher escopos, aprovar.

Antigravity CLI

Se você usa a Antigravity CLI (a sucessora da Gemini CLI) em vez do aplicativo Gemini, adicione o MailInApp ao arquivo de configuração dela em vez de uma tela de configurações. Adicione uma entrada em mcp_config.json (ou .agents/mcp_config.json):

{
  "mcpServers": {
    "mailinapp": {
      "url": "https://mailinapp.com/api/mcp"
    }
  }
}

A Antigravity CLI abre a mesma tela de consentimento OAuth que qualquer outro cliente na primeira vez que se conecta.

Se uma conexão parar de funcionar

  • Nenhuma opção de "Adicionar um app personalizado" em Apps conectados — essa é uma restrição de elegibilidade do próprio Google, não do MailInApp: o recurso de apps personalizados do Spark exige uma conta pessoal do Google baseada nos EUA, com 18 anos ou mais, com "Keep Activity" ativado, e o app do Gemini definido para inglês. A opção não aparecerá de forma alguma fora dessas condições, independentemente de qualquer coisa do lado do MailInApp.
  • Conexão empresarial rejeitada pela configuração do seu administrador — o id/segredo do cliente que o MailInApp emitiu está vinculado ao URI de redirecionamento exato que o seu locatário forneceu na configuração. Se esse URI mudar, peça ao seu administrador para enviar um e-mail para [email protected] com o novo, em vez de reutilizar o cliente antigo.
  • A Antigravity CLI reporta um erro de conexão — verifique se mcp_config.json é um JSON válido e se o campo url está exatamente como https://mailinapp.com/api/mcp; um objeto mcpServers malformado é a causa mais comum.
  • Você trocou de equipe, ou um(a) colega de equipe revogou seu acesso — como em qualquer outra plataforma, um token de conector do Gemini é revalidado em relação à sua associação de conta atual a cada chamada, então perder o acesso a uma empresa desativa as chamadas dessa conexão imediatamente, sem que você precise fazer nada do lado do Gemini.

Revogando

Independentemente de qual superfície do Gemini você usou para se conectar, Conexões, no painel do MailInApp (/dashboard/connections), lista isso junto com todo outro assistente, com um Revogar de um clique — o token para de funcionar na próxima chamada.