openclip-remove-background

OpenClip: remoção de fundo

remove_background recebe uma imagem e retorna um PNG transparente com o fundo removido. É GRATUITO, precisa de uma conta OpenClip mas sem assinatura e sem créditos. Não existem parâmetros para ajustar, uma única chamada faz todo o trabalho.

Configuração (única vez)

OpenClip é um servidor MCP remoto em https://openclip.app/mcp. Faça login com sua conta OpenClip quando o prompt OAuth aparecer, não há chave de API para copiar.

• Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp, em seguida /mcp para autorizar.
• Claude Desktop / web: Configurações, Conectores, "Adicionar conector personalizado", cole a URL, faça login.
• Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Clientes somente header: gere um token MCP em openclip.app/settings/connect e conecte-se a https://openclip.app/mcp/key com Authorization: Bearer <token>.

Verificação: chame get_account.

O fluxo

1. Upload. create_upload(filename, content_type) retorna um id e uma upload_url. Faça PUT dos bytes brutos na upload_url, depois passe o id como file. NÃO chame complete_upload, isso inicia o pipeline de recorte pago. As ferramentas gratuitas leem o arquivo enviado diretamente.
2. Chame. remove_background(file). Nenhum outro parâmetro.
3. Consulte. Retorna um hashid tool_job. Consulte get_tool_job_status(tool_job) a cada 5 a 10 segundos. queued / processing estão em andamento, completed retorna uma URL CDN permanente outputs para o PNG transparente, failed retorna error.
4. Retorne a URL do PNG. Ele é transparente, então parecerá ter um fundo quadriculado ou preto em algumas visualizações. Isso é esperado, o canal alfa está lá.

Regras

• Sempre consulte, a ferramenta é assíncrona.
• A saída é sempre PNG. Transparência precisa de um canal alfa, então jpg não é uma opção. Se o usuário quiser achatá-lo em uma cor ou redimensioná-lo depois, encadeie edit_image (veja openclip-thumbnails).
• URLs de saída são links CDN permanentes, não assinados nem com expiração.
• O uso gratuito é limitado por dia com um limite de tamanho por arquivo. O texto de erro explica como remover um limite.

Exemplos de prompts para ações

• "Remova o fundo desta foto" - create_upload, PUT bytes, remove_background(file), consulte, retorne a URL do PNG transparente.
• "Recorte o produto para um anúncio" - o mesmo, depois edit_image(file, operation="resize", ...) na saída se precisarem de dimensões específicas.
• "Preciso deste logotipo em transparente" - o mesmo, depois devolva o PNG.

Relacionados

Redimensionar, cortar e reformatar imagens é openclip-thumbnails (edit_image). Extrair um quadro de um vídeo para recortar também é openclip-thumbnails (extract_thumbnails).