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 Claude Code precisa de algo com quem conversar.

2Adicione o imagic ao Claude Code

O traço duplo é obrigatório. Sem ele, o Claude Code lê as flags do próprio imagic como se fossem dele.

claude mcp add imagic -- 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 (exemplo para Windows; no macOS é /Applications/imagic.app/Contents/MacOS/imagic):

claude mcp add imagic -- "C:\Program Files\imagic\imagic.exe" --mcp

Configuração

O Claude Code lê .mcp.json (projeto) ou ~/.claude.json (usuário). A chave de nível superior é mcpServers.

{
  "mcpServers": {
    "imagic": {
      "type": "stdio",
      "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": {
      "type": "stdio",
      "command": "C:\\Program Files\\imagic\\imagic.exe",
      "args": ["--mcp"]
    }
  }
}

Onde esse arquivo fica

Windows	`%USERPROFILE%\.claude.json`
macOS	`~/.claude.json`
Linux	`~/.claude.json`

Onde encontrar na interface

Execute /mcp dentro de uma sessão para ver o status e ativar ou desativar servidores.

3Peça uma triagem

Reinicie o Claude Code 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 Claude Code 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 escopo é definido quando você adiciona o servidor. O padrão é local, ou seja, só este projeto; passe --scope user para deixar o imagic disponível em qualquer lugar.
A documentação da Anthropic observa de forma explícita que ~/.claude/mcp.json e %APPDATA%\Claude\mcp.json não são lidos. Só os caminhos acima são.
Um servidor com escopo de projeto precisa de aprovação interativa na primeira vez que o Claude Code o vê.
Reinicie a sessão depois de editar o .mcp.json à mão; ele é lido no início da sessão.

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?

Claude Desktop Cursor VS Code and GitHub Copilot Codex CLI Gemini CLI Windsurf (Devin Desktop)

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 Anthropic. Se o Claude Code mudar a configuração e esta página ficar para trás, avise a gente e vamos corrigir.

Conecte o imagic ao Claude Code