openclip-remove-background

OpenClip: eliminación de fondo

remove_background toma una imagen y devuelve un PNG transparente con el fondo recortado. Es GRATUITO, necesita una cuenta de OpenClip pero no requiere suscripción ni créditos. No hay parámetros que ajustar, una sola llamada hace todo el trabajo.

Configuración (una sola vez)

OpenClip es un servidor MCP remoto en https://openclip.app/mcp. Inicia sesión con tu cuenta de OpenClip cuando aparezca la solicitud OAuth, no se necesita copiar ninguna clave API.

• Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp, luego /mcp para autorizar.
• Claude Desktop / web: Configuración, Conectores, "Agregar conector personalizado", pega la URL, inicia sesión.
• Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Clientes solo con encabezados: genera un token MCP en openclip.app/settings/connect y conéctate a https://openclip.app/mcp/key con Authorization: Bearer <token>.

Verificación: llama a get_account.

El bucle

1. Subir. create_upload(filename, content_type) devuelve un id y una upload_url. Haz PUT de los bytes sin procesar a upload_url, luego pasa el id como file. NO llames a complete_upload, eso inicia el pipeline de recorte pago. Las herramientas gratuitas leen el archivo subido directamente.
2. Llamar. remove_background(file). Sin otros parámetros.
3. Sondear. Devuelve un hashid tool_job. Sondear get_tool_job_status(tool_job) cada 5 a 10 segundos. queued / processing están en curso, completed devuelve una URL CDN permanente outputs para el PNG transparente, failed devuelve error.
4. Devolver la URL del PNG. Es transparente, por lo que puede verse como un tablero de ajedrez o un fondo negro en algunas vistas previas. Eso es normal, el canal alfa está presente.

Reglas

• Siempre sondea, la herramienta es asíncrona.
• La salida siempre es PNG. La transparencia necesita un canal alfa, por lo que jpg no es una opción. Si el usuario quiere aplanarlo sobre un color o redimensionarlo después, encadena con edit_image (ver openclip-thumbnails).
• Las URLs de salida son enlaces CDN permanentes, no firmados ni con expiración.
• El uso gratuito tiene límite de velocidad por día y un límite de tamaño por archivo. El texto de error explica cómo aumentar un límite.

Ejemplos de acciones a partir de instrucciones

• "Elimina el fondo de esta foto" - create_upload, PUT bytes, remove_background(file), sondear, devolver la URL del PNG transparente.
• "Recorta el producto para un listado" - lo mismo, luego edit_image(file, operation="resize", ...) sobre la salida si necesitan dimensiones específicas.
• "Necesito este logo en transparente" - lo mismo, luego entregar el PNG.

Relacionado

Redimensionar, recortar y reformatear imágenes está en openclip-thumbnails (edit_image). Extraer un fotograma de un video para recortarlo también está en openclip-thumbnails (extract_thumbnails).