Liga o imagic ao Claude Code

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 Claude Code precisa de algo com que comunicar.

2Acrescenta o imagic ao Claude Code

O duplo hífen é obrigatório. Sem ele, o Claude Code lê as opções do próprio imagic como se fossem suas.

claude mcp add imagic -- 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 (mostrado 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 (utilizador). A chave de topo é mcpServers.

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

Onde fica esse ficheiro

Onde encontrá-lo na interface

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

3Pede uma seleção

Reinicia o Claude Code 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 Claude Code 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 âmbito fica definido quando adicionas o servidor. O predefinido é local, ou seja, apenas este projeto; passa --scope user para o imagic ficar disponível em todo o lado.
• A documentação da Anthropic indica explicitamente que ~/.claude/mcp.json e %APPDATA%\Claude\mcp.json não são lidos. Só os caminhos acima o são.
• Um servidor com âmbito de projeto precisa de aprovação interativa na primeira vez que o Claude Code o vê.
• Reinicia a sessão depois de editares o .mcp.json à mão; ele é lido no início da sessão.

O que o imagic pode fazer depois de ligado

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?

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