1Instala o imagic e começa a avaliação

O servidor MCP vem com o imagic Max, e a avaliação gratuita de 500 exportações desbloqueia tudo sem cartão. Transfere-o primeiro a partir da página de computador, porque o Gemini CLI precisa de algo com que comunicar.

2Acrescenta o imagic ao Gemini CLI

A opção -s user é importante. Sem ela, o servidor é adicionado apenas ao projeto atual.

gemini mcp add -s user imagic imagic-mcp

Configuração

O Gemini CLI lê ~/.gemini/settings.json (utilizador) ou .gemini/settings.json (projeto). A chave de topo é mcpServers.

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

Instalaste a aplicação empacotada a partir deste site? Então não existe um comando imagic-mcp no teu computador: a própria aplicação é o servidor. Aponta command para ela e passa --mcp (mostrado para Windows; no macOS o comando é /Applications/imagic.app/Contents/MacOS/imagic):

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

Onde fica esse ficheiro

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

3Pede uma seleção

Reinicia o Gemini CLI se já estava a correr e aponta-o para uma sessão:

Seleciona a sessão em D:/Shoots/eva_tom, aplica o meu estilo e exporta as fotografias a manter.

O Gemini CLI vai chamar, por ordem, scan_directory, analyze_photos, apply_my_style e export_photos. Cada uma delas corre no teu computador: o agente envia instruções, nunca as tuas fotografias.

Coisas em que as pessoas costumam cair

O gemini mcp add usa por predefinição o âmbito de projeto, ao contrário da maioria dos outros clientes. Executa-o sem -s user e o imagic parecerá desaparecer na tua pasta seguinte.
As definições do projeto sobrepõem-se às do utilizador, e as definições do sistema sobrepõem-se a ambas.
A Google não documenta se editar o settings.json à mão exige um reinício.

O que o imagic pode fazer depois de ligado

scan_directory analyze_photos apply_my_style export_photos

São 30 ferramentas no total, que cobrem a biblioteca, a seleção, a edição e o teu estilo aprendido. Vê a referência completa das ferramentas, ou os fluxos de trabalho para saberes o que pedir na prática.

Vais configurar outro cliente?

Windsurf (Devin Desktop) Zed Continue Goose Warp LM Studio

Experimenta numa sessão real

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

Começar a avaliação gratuita Ler o guia do MCP

Configuração verificada na documentação do Google. Se o Gemini CLI mudar a sua configuração e esta página ficar desatualizada, diz-nos e corrigimos.

Liga o imagic ao Gemini CLI