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

A CLI grava o arquivo para você, o que evita a confusão dos dois arquivos descrita abaixo.

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.

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

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

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

A AWS está no meio da migração entre dois arquivos. A IDE agora grava default.json, enquanto o mcp.json ainda funciona pela configuração useLegacyMcpJson, cujo padrão é true. A CLI lê o mcp.json.
A configuração do workspace tem prioridade sobre a global quando as duas nomeiam o mesmo servidor.
O campo timeout é em milissegundos e o padrão é 120000.
A AWS publica esses caminhos só na forma com til, sem expansão para o Windows.

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?

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.

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

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.

Conecte o imagic ao Amazon Q Developer