Iminify

npx add-mcp 'https://www.iminify.com/mcp'

Iminify executa um servidor MCP, para que um agente de IA possa comprimir, converter e redimensionar imagens e escanear páginas para você, direto do chat ou do editor que você já usa. Peça ao Claude para "transformar estas fotos de produtos em WebP com menos de 1600 pixels de largura" e ele chama o Iminify, aguarda os resultados e entrega os links de download.

O servidor fica em um único endereço:

https://www.iminify.com/mcp

Ele fala MCP via HTTP streamable e faz login com OAuth, então a maioria dos aplicativos só precisa desse endereço. Na primeira vez que você conectar, o aplicativo envia você ao Iminify para aprovar, e a partir daí ele funciona como você: suas imagens, seu plano, seus contadores.

Conectando um aplicativo

Você precisa de uma conta com e-mail verificado. O plano gratuito funciona.

Claude

O Iminify está no diretório de conectores do Claude. No Claude, na web, no aplicativo de desktop ou no celular, abra Personalizar, depois Conectores, procure por Iminify e pressione Conectar, ou vá direto para a listagem dele. O Claude abre o Iminify em uma aba do navegador; faça login se ainda não estiver, verifique o que ele pede e pressione Aprovar. Uma conexão cobre tanto o Chat quanto o Cowork.

Você também pode adicioná-lo como um conector personalizado com o endereço acima, da mesma forma que adicionaria qualquer servidor que não esteja no diretório.

O conector é tudo o que o Claude precisa. Ele comprime qualquer coisa com endereço web, escaneia páginas e, no Cowork, pode trabalhar em uma pasta do seu computador e gravar os arquivos menores de volta (Arquivos no seu computador explica como). O plugin Iminify é opcional: ele adiciona uma rotina pronta para esse trabalho de pasta.

Claude Code

Execute isto no seu terminal e depois execute /mcp dentro do Claude Code e escolha Iminify para fazer login:

claude mcp add --transport http iminify https://www.iminify.com/mcp

É só isso. Se você também quiser a rotina do plugin Iminify para otimizar as imagens de um projeto inteiro, digite estes dois comandos no Claude Code. O plugin traz o servidor junto:

/plugin marketplace add mozex/iminify-plugin
/plugin install iminify@iminify

Depois execute /mcp e faça login em plugin:iminify:iminify.

Cursor

Adicione o servidor a ~/.cursor/mcp.json, ou a .cursor/mcp.json em um projeto:

{
  "mcpServers": {
    "iminify": {
      "url": "https://www.iminify.com/mcp"
    }
  }
}

O Cursor mostra um botão de login ao lado do servidor nas configurações de MCP.

VS Code

Adicione-o a .vscode/mcp.json no seu workspace:

{
  "servers": {
    "iminify": {
      "type": "http",
      "url": "https://www.iminify.com/mcp"
    }
  }
}

ChatGPT

O ChatGPT adiciona servidores MCP como plugins, e um que você adiciona por conta própria precisa do modo de desenvolvedor, que contas Plus, Pro, Business, Enterprise e Education têm. Ative-o em Configurações, depois Segurança e login. Em seguida, abra Plugins, adicione um servidor MCP com o endereço acima e OAuth como login, e aprove-o no Iminify quando o ChatGPT enviar você para lá. Na web, escolha-o para um chat no menu +, em Modo de desenvolvedor; o aplicativo de desktop oferece um servidor habilitado para cada chat.

Qualquer outra coisa

Qualquer cliente que fale MCP via HTTP pode usar o mesmo endereço. Se ele não suportar OAuth, dê a ele uma chave de API em vez disso, enviada como cabeçalho em cada requisição:

Authorization: Bearer <your-api-key>

No Claude Code, isso é claude mcp add --transport http iminify https://www.iminify.com/mcp --header "Authorization: Bearer $IMINIFY_API_KEY".

O que o agente pode fazer

Ferramenta	O que ela faz
compress_images	Comprimir, converter ou redimensionar até 20 imagens em uma chamada, a partir de endereços, links de upload ou enviadas inline
create_upload_link	Obter um endereço de uso único para enviar um arquivo local
get_image	Status de uma imagem, tamanhos, economia e links de download
list_images	Suas imagens, mais recentes primeiro, filtradas por status, origem ou escaneamento
create_zip	Um link de download para várias imagens finalizadas, ou todas as de um escaneamento
scan_page	Escanear uma página web por todas as imagens que ela carrega e comprimir todas
get_scan	Progresso de um escaneamento, suas imagens, as que foram puladas e por quê, e o que foi economizado
rename_image	Alterar o nome sob o qual um resultado é baixado
share_image	Dar a um resultado uma página pública para enviar a alguém
delete_image	Excluir uma imagem e seus dois arquivos, permanentemente
get_usage	Seu plano, seus limites e o que foi usado hoje

As configurações são as da API: um nível, um formato, uma largura, uma altura ou uma escala, e se deve manter os metadados. Raramente você precisa nomeá-los. Diga o que quer em palavras simples e o agente escolhe.

O plugin Iminify

Você não precisa do plugin. O servidor sozinho faz tudo nesta página, e um agente pode otimizar uma pasta com ele descobrindo os passos conforme avança. O plugin Iminify, de código aberto no GitHub, empacota o servidor com uma habilidade, optimize-images, que tem esses passos escritos, para que o trabalho siga o mesmo caminho cuidadoso toda vez. Ele instala no Claude Code e no Claude, onde uma instalação cobre Chat e Cowork, e funciona onde quer que o agente alcance seus arquivos: um projeto no Claude Code, uma pasta no Cowork.

A habilidade faz todo o trabalho de otimizar as imagens de um projeto, ou qualquer pasta delas:

1. Ela encontra as imagens que você nomeia, ou todas as imagens que o projeto rastreia no git, deixando de fora pastas de dependências e build.
2. Ela mostra a lista e as configurações que usará, e espera um sim.
3. Ela envia cada arquivo por um link de upload, comprime-os na sua conta e espera os resultados.
4. Ela grava cada arquivo menor sobre o original. Um arquivo que o Iminify não conseguiu deixar menor permanece como estava.

Ela nunca sobrescreve um arquivo que o git não pudesse devolver: um com alterações não confirmadas espera sua autorização. Um novo formato significa um novo nome de arquivo, então ela converte apenas quando você pede, salva o novo arquivo ao lado do antigo e atualiza as referências que encontrar. Peça em palavras simples, como "otimize as imagens em public/images" ou "converta os PNGs em resources/img para WebP", ou execute como /iminify:optimize-images.

Para instalá-lo:

• Claude Code: digite os dois comandos em Claude Code acima, depois execute /mcp e faça login em plugin:iminify:iminify.
• Claude, Chat e Cowork: está no diretório de plugins do Claude. Abra Personalizar, depois Plugins, procure por Iminify em Descobrir e pressione Adicionar, e faça login na primeira vez que o Claude pedir. Uma instalação cobre Chat e Cowork, e inclui a conexão com o Iminify, então você não precisa do conector também. Já tem o conector? Nada duplica: ambos usam o mesmo endereço, então o Claude mostra um único conjunto de ferramentas do Iminify. Depois, no Cowork no aplicativo de desktop, entregue uma pasta ao Claude, diga "otimize as imagens nesta pasta", e ele assume a partir daí.

Cada imagem que ele comprime conta para o seu plano, como qualquer outra.

Arquivos no seu computador

Um agente só pode enviar arquivos que ele alcança. Em um chat simples, o Claude trabalha com imagens que têm endereço na internet, ou arquivos pequenos que envia inline. Um agente que executa comandos ao lado dos seus arquivos, como Claude Code, Cursor, ou Claude no Cowork com uma pasta conectada, pode enviar arquivos locais de qualquer tamanho que seu plano aceite, com ou sem o plugin:

1. Ele chama create_upload_link com o nome do arquivo e recebe um endereço que funciona uma vez, por 15 minutos.
2. Ele envia o arquivo para lá com um PUT, da forma que este comando faz:

   curl --fail --upload-file hero.png "<upload_url>"
   

3. Ele chama compress_images com o upload_id que obteve no passo 1.

Um arquivo enviado mas nunca comprimido é excluído cerca de um dia após chegar. Arquivos inline, enviados como base64 dentro da chamada, são limitados a 4 MB cada; qualquer coisa maior passa por um link de upload.

O Claude no Cowork executa esses comandos em uma sandbox, e os arquivos menores voltam da mesma forma, baixados de seus links. Se o Claude disser que a sandbox não alcança o Iminify, ative Permitir saída de rede em Configurações, depois Recursos. Em um plano Team ou Enterprise, um proprietário permite o domínio nas configurações da organização.

Resultados voltam como links

O servidor nunca coloca bytes de imagem em suas respostas. Cada imagem vem com um download_url para a cópia otimizada e outro para o original, e create_zip dá um para um lote inteiro. Esses links funcionam sem chave, então o agente pode buscá-los ou simplesmente mostrá-los a você, e eles param de funcionar após 60 minutos. Peça novamente para obter novos.

O trabalho roda em segundo plano, como faz em todo lugar. compress_images e scan_page respondem imediatamente com o trabalho na fila, e o agente verifica com get_image ou get_scan até terminar. Cada resposta carrega um hint quando há algo para esperar ou saber, como uma imagem que o Iminify não conseguiu deixar menor com as configurações usadas.

Limites

O servidor MCP é mais uma porta para sua conta, não uma separada. Cada imagem que um agente coloca na fila conta contra as imagens diárias do seu plano e as compressões por minuto, os mesmos contadores que o site e a API gastam, e cada chamada ao servidor conta como uma requisição de API. Limites e cotas explica cada um, e a página de preços tem os números para cada plano.

Quando um limite é atingido, ou qualquer outra coisa é recusada, a ferramenta responde com um erro carregando o message e o code da API (listados na página de erros), além de retry_after em segundos quando esperar ajudar. Um bom agente informa a mensagem em vez de tentar novamente em loop.

Desconectando um aplicativo

Configurações > Aplicativos conectados lista todos os aplicativos que você aprovou, com quando foi a última chamada. Desconecte um ali e ele para de funcionar imediatamente; ele precisa ser aprovado novamente para voltar. Um aplicativo que fica sem uso por 30 dias precisa ser reconectado de qualquer forma.

Um aplicativo conectado com uma chave de API em vez disso é removido excluindo essa chave em Configurações > Tokens de API.