1Instale o imagic e comece o teste

O servidor MCP vem com o imagic Max, e o teste grátis de 500 exportações libera tudo, sem cartão. Baixe-o antes na página do desktop, porque o Gemini CLI precisa de algo com quem conversar.

2Adicione o imagic ao Gemini CLI

A flag -s user importa. Sem ela, o servidor é adicionado só ao projeto atual.

gemini mcp add -s user imagic imagic-mcp

Configuração

O Gemini CLI lê ~/.gemini/settings.json (usuário) ou .gemini/settings.json (projeto). A chave de nível superior é mcpServers.

{
  "mcpServers": {
    "imagic": {
      "command": "imagic-mcp"
    }
  }
}

Instalou o app empacotado a partir deste site? Então não existe o comando imagic-mcp na sua máquina: o próprio app é o servidor. Aponte command para ele e passe --mcp (exemplo para Windows; no macOS o comando é /Applications/imagic.app/Contents/MacOS/imagic):

{
  "mcpServers": {
    "imagic": {
      "command": "C:\\Program Files\\imagic\\imagic.exe",
      "args": ["--mcp"]
    }
  }
}

Onde esse arquivo fica

Todas as plataformas	`~/.gemini/settings.json`

3Peça uma triagem

Reinicie o Gemini CLI se ele já estava aberto e depois aponte para uma sessão de fotos:

Faça a triagem da sessão em D:/Shoots/eva_tom, aplique o meu estilo e exporte as escolhidas.

O Gemini CLI vai chamar scan_directory, analyze_photos, apply_my_style e export_photos, em sequência. Cada uma delas roda na sua máquina: o agente envia instruções, nunca as suas fotos.

Armadilhas comuns

O gemini mcp add usa o escopo de projeto por padrão, ao contrário da maioria dos outros clientes. Se você o executar sem -s user, o imagic vai parecer sumir na sua próxima pasta.
As configurações de projeto têm prioridade sobre as de usuário, e as do sistema têm prioridade sobre as duas.
O Google não documenta se editar o settings.json à mão exige reiniciar.

O que o imagic pode fazer depois de conectado

scan_directory analyze_photos apply_my_style export_photos

São 25 ferramentas no total, cobrindo a biblioteca, a triagem, a edição e o seu estilo aprendido. Veja a referência completa das ferramentas ou os fluxos de trabalho para saber o que pedir de fato.

Configurando outro cliente?

Windsurf (Devin Desktop) Zed Continue Goose Warp LM Studio

Teste em uma sessão real

O teste de 500 exportações inclui o imagic Max, o servidor MCP e todas as ferramentas desta página. Sem cartão.

Começar o teste grátis Ler o guia do MCP

Configuração verificada na documentação da Google. Se o Gemini CLI mudar a configuração e esta página ficar para trás, avise a gente e vamos corrigir.

Conecte o imagic ao Gemini CLI