AWS · imagic Max

Conecte o imagic ao Amazon Q Developer

Adicione o imagic ao Amazon Q Developer pela CLI ou pelo painel da IDE e saiba qual dos dois arquivos de configuração você está de fato editando.

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 Amazon Q Developer precisa de algo com quem conversar.

2Adicione o imagic ao Amazon Q Developer

Use o bloco de configuração abaixo. Ele aponta o comando para o app imagic instalado com --mcp, que é como a versão empacotada roda como servidor MCP.

No Linux, aponte o comando para o binário imagic dentro da pasta em que você extraiu a versão portátil e mantenha o argumento --mcp.

Não instale um pacote npm chamado imagic-mcp para fazer isso funcionar: o pacote npm com esse nome é um projeto não relacionado de outro autor, não é nosso. O servidor MCP do imagic já vem embutido no app para desktop.

Está rodando o imagic a partir de um checkout do código-fonte (apenas para desenvolvedores, não o app empacotado)? O ponto de entrada do próprio checkout é assim:

q mcp add --name imagic --command imagic-mcp

Configuração

O Amazon Q Developer lê ~/.aws/amazonq/mcp.json (global) ou .amazonq/mcp.json (workspace). A chave de nível superior é mcpServers.

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"]
    }
  }
}

Está rodando o imagic a partir de um checkout do código-fonte (apenas para desenvolvedores, não o app empacotado)? O ponto de entrada do próprio checkout é assim:

{
  "mcpServers": {
    "imagic": {
      "command": "imagic-mcp",
      "args": []
    }
  }
}

Onde esse arquivo fica

macOS~/.aws/amazonq/mcp.json
Linux~/.aws/amazonq/mcp.json

A AWS publica esse caminho só na forma com ~ e não documenta nenhuma expansão no Windows, então use o comando ou a interface acima em vez de adivinhar onde ele vai parar.

Onde encontrar na interface

Painel do Amazon Q Developer, depois Chat, depois o ícone de ferramentas, depois o sinal de mais.

3Peça uma triagem

Reinicie o Amazon Q Developer 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 Amazon Q Developer 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 que o imagic pode fazer depois de conectado

scan_directory analyze_photos apply_my_style export_photos

São 30 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?

ChatGPT Claude.ai Claude Code Claude Desktop Cursor VS Code and GitHub Copilot

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.

Configuração verificada na documentação da AWS. Se o Amazon Q Developer mudar a configuração e esta página ficar para trás, avise a gente e vamos corrigir.