Como conectar a BLAKK ao Gemini

O app do Gemini aceita conectores só nos EUA, por enquanto. Veja como usar a BLAKK pelo app, pelo Gemini CLI ou pelo Antigravity.

Antes de começar

• Uma conta do Google e o Gemini que você usa: o app, o Gemini CLI ou o Antigravity.
• Seu login da BLAKK. A IA vai abrir a tela de entrada da BLAKK. Ela passa a ver e fazer só o que o seu perfil de acesso permite, então quem é artista não enxerga o financeiro se o perfil dele não deixa.
• O endereço do conector da BLAKK:

https://app.blakk.com.br/mcp

Não é preciso gerar chave de API nem mexer em código: a conexão usa login com autorização (OAuth), o mesmo tipo de autorização de quando você entra em um site com a conta do Google.

O Google oferece três caminhos, e a escolha depende de onde você está e de como usa o Gemini:

• App do Gemini (gemini.google.com): por enquanto, os conectores personalizados só funcionam nos Estados Unidos, em inglês, para maiores de 18 anos e em contas pessoais.
• Gemini CLI: o Gemini no terminal do computador. Funciona no Brasil.
• Antigravity: o ambiente de agentes do Google, que substituiu o Gemini CLI para contas gratuitas e do Google One em junho de 2026.

No app do Gemini (Estados Unidos)

1. Abra gemini.google.com no navegador, com a interface em inglês e a Atividade (Keep Activity) ligada.
2. Clique em Settings, no canto inferior, e depois em Connected Apps. Se não encontrar, procure em Personal Intelligence › Connected Apps.
3. Em Custom apps, clique em Add a custom app.
4. Cole o endereço https://app.blakk.com.br/mcp. Não é preciso abrir as opções avançadas.
5. Clique em Next, entre com o seu login da BLAKK e autorize.

Para usar, digite @ na conversa e escolha a BLAKK. Depois de conectada pela web, ela também funciona no app do Gemini no celular. Antes de qualquer alteração, o Gemini pede a sua confirmação.

Se você está no Brasil, a opção Custom apps ainda não aparece. Use um dos caminhos abaixo.

No Gemini CLI

Com o Gemini CLI instalado, adicione a BLAKK com um comando no terminal:

gemini mcp add --transport http blakk https://app.blakk.com.br/mcp

Abra o Gemini CLI, digite /mcp auth blakk e faça login na BLAKK pelo navegador. Se preferir editar o arquivo de configuração (~/.gemini/settings.json), o trecho é este:

{
  "mcpServers": {
    "blakk": {
      "httpUrl": "https://app.blakk.com.br/mcp"
    }
  }
}

Use httpUrl, e não url: o campo url é para um tipo de conexão mais antigo.

No Antigravity

No Antigravity, a BLAKK entra pelo arquivo ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "blakk": {
      "serverUrl": "https://app.blakk.com.br/mcp"
    }
  }
}

Aqui o campo se chama serverUrl. Depois de salvar:

1. Abra as configurações do agente (Cmd+, no Mac ou Ctrl+, no Windows).
2. Na aba Customizations, clique em Authenticate ao lado da BLAKK.
3. Faça login na BLAKK pelo navegador, copie o código exibido, cole de volta no Antigravity e clique em Submit.

No Antigravity CLI, o comando /mcp mostra os servidores conectados.

Como usar

Depois de conectada, fale com a IA do jeito que falaria com alguém da equipe, por texto ou por áudio:

• “Quem está agendado amanhã à tarde?”
• “Compara o faturamento de setembro com o de agosto e me diz o que mudou.”
• “Quais clientes não voltam ao studio há mais de seis meses?”
• “Agenda a Carla com a Lara na sexta às 15h.”
• “Lança 320 reais de energia como despesa paga hoje.”

Para pedidos que alteram o sistema, como um agendamento ou uma despesa, a IA mostra o que vai fazer e pede a sua confirmação antes.

Se algo não funcionar

• Não aparece Custom apps no app do Gemini: o recurso ainda não está disponível no Brasil nem em português. Use o Gemini CLI ou o Antigravity.
• Erro ao conectar: confirme se o endereço termina em /mcp e se o campo está certo: httpUrl no Gemini CLI e serverUrl no Antigravity.
• A BLAKK aparece desconectada: refaça o login com /mcp auth blakk (Gemini CLI) ou Authenticate (Antigravity).

Conecte a BLAKK à sua IAO que é MCP, o que dá para pedir e o guia de cada IA.