openclip-remove-background

OpenClip을 사용해 이미지 배경을 제거하고 투명 PNG를 반환합니다. OpenClip 계정만 있으면 무료이며, 구독이 필요 없습니다. 요청 시 사용하세요.

openclip-remove-background란 무엇인가요?

이 스킬은 이미지에서 배경을 제거하고 투명 PNG를 반환하는 OpenClip의 `remove_background` 도구를 활용합니다. 무료로 사용할 수 있으며, OpenClip 계정만 있으면 되고 구독이나 크레딧이 필요 없습니다. 원격 MCP 서버(`https://openclip.app/mcp`)로 작동하며, Claude Code, Claude Desktop/웹, Cursor 등 다양한 MCP 지원 클라이언트에서 설정할 수 있습니다. 사용 과정은 파일 업로드, `remove_background` 호출(비동기), 작업 상태 폴링, 완료된 투명 PNG의 CDN URL 반환 순서로 진행됩니다. 출력은 항상 PNG이며, 영구적인 CDN 링크로 제공되므로 이미지 크기 조정이나 배경색 추가 등 후처리가 필요하면 `openclip-thumbnails` 스킬의 `edit_image`를 연계할 수 있습니다.

지원 대상✓Claude Code~Codex CLI✓Cursor

npx skills add https://github.com/OpenClip-App/agent-skills/tree/main/skills/openclip-remove-background

문서

OpenClip: 배경 제거

remove_background는 이미지를 받아 배경이 제거된 투명 PNG를 반환합니다. 무료이며, OpenClip 계정만 있으면 구독이나 크레딧이 필요 없습니다. 조정할 매개변수도 없으며, 한 번 호출로 모든 작업이 완료됩니다.

설정 (최초 한 번)

OpenClip은 https://openclip.app/mcp에 있는 원격 MCP 서버입니다. OAuth 프롬프트가 나타나면 OpenClip 계정으로 로그인하세요. 복사할 API 키는 없습니다.

Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp, 그런 다음 /mcp로 인증합니다.
Claude Desktop / 웹: 설정, 커넥터, "사용자 정의 커넥터 추가"에서 URL을 붙여넣고 로그인합니다.
Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
헤더 전용 클라이언트: openclip.app/settings/connect에서 MCP 토큰을 발급받고 Authorization: Bearer <토큰>을 포함하여 https://openclip.app/mcp/key에 연결합니다.

동작 확인: get_account를 호출합니다.

진행 순서

업로드. create_upload(filename, content_type)은 id와 upload_url을 반환합니다. PUT 메서드로 원시 바이트를 upload_url에 전송한 다음, id를 file로 전달합니다. complete_upload를 호출하지 마십시오. 유료 클리핑 파이프라인이 시작됩니다. 무료 도구는 업로드된 파일을 직접 읽습니다.
호출. remove_background(file). 다른 매개변수는 없습니다.
폴링. tool_job 해시 ID를 반환합니다. 5~10초 간격으로 get_tool_job_status(tool_job)을 폴링합니다. queued / processing은 진행 중이고, completed는 투명 PNG의 영구 CDN outputs URL을 반환하며, failed는 error를 반환합니다.
PNG URL 반환. 투명하기 때문에 일부 미리보기에서는 바둑판 무늬나 검은색 배경처럼 보일 수 있습니다. 이는 정상이며, 알파 채널은 그대로 있습니다.

규칙

항상 폴링하세요. 도구는 비동기식입니다.
출력은 항상 PNG입니다. 투명도를 위해서는 알파 채널이 필요하므로 jpg는 사용할 수 없습니다. 사용자가 특정 색상으로 평탄화하거나 크기를 조정하려면 edit_image를 연계하세요. (openclip-thumbnails 참조)
출력 URL은 서명이나 만료가 없는 영구 CDN 링크입니다.
무료 사용은 하루에 속도 제한이 있으며 파일 크기 제한이 있습니다. 오류 메시지에 제한 해제 방법이 설명되어 있습니다.

예제: 프롬프트에서 동작으로

"이 사진에서 배경을 제거해 줘" - create_upload, PUT 바이트, remove_background(file), 폴링 후 투명 PNG URL 반환.
"리스팅용 상품을 오려내 줘" - 위와 동일, 그런 다음 출력에 대해 edit_image(file, operation="resize", ...)로 원하는 크기 조정.
"이 로고를 투명 배경으로 만들어 줘" - 위와 동일, PNG 반환.

openclip-remove-background