openclip-remove-background

OpenClip：背景の削除

remove_background は画像を受け取り、背景を切り抜いた透過 PNG を返します。 無料で利用できます。OpenClip アカウントは必要ですが、サブスクリプションもクレジットも不要です。調整するパラメーターはなく、1 回の呼び出しで処理が完了します。

セットアップ（一度だけ）

OpenClip は https://openclip.app/mcp にあるリモート MCP サーバーです。OAuth のプロンプトが表示されたら OpenClip アカウントでサインインしてください。コピーする API キーはありません。

• Claude Code： claude mcp add --transport http openclip https://openclip.app/mcp を実行してから、/mcp で認証します。
• Claude Desktop / web： 「Settings」、「Connectors」、「Add custom connector」の順に選択し、URL を貼り付けてサインインします。
• Cursor（.cursor/mcp.json）：{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• ヘッダーのみのクライアント： openclip.app/settings/connect で MCP トークンを作成し、Authorization: Bearer <token> を指定して https://openclip.app/mcp/key に接続します。

動作確認：get_account を呼び出します。

処理の流れ

1. アップロード。 create_upload(filename, content_type) は id と upload_url を返します。 upload_url に生のバイトデータを PUT してから、id を file として渡します。 complete_upload は呼び出さないでください。 これは有料の切り抜き処理を開始します。無料ツールはアップロードされたファイルを直接読み込みます。
2. 呼び出し。 remove_background(file) を呼び出します。他のパラメーターはありません。
3. ポーリング。 tool_job の hashid が返されます。5～10 秒ごとに get_tool_job_status(tool_job) をポーリングします。queued / processing は処理中、completed は透過 PNG の永続的な CDN outputs URL を返し、failed は error を返します。
4. PNG の URL を返す。 透過画像のため、一部のプレビューでは市松模様や黒い背景があるように見えます。これは想定どおりで、アルファチャンネルは含まれています。

ルール

• ツールは非同期のため、必ずポーリングしてください。
• 出力は常に PNG です。透過にはアルファチャンネルが必要なため、jpg は使えません。後から単色の背景に合成したり、サイズを変更したりする場合は、edit_image を連鎖させてください（openclip-thumbnails を参照）。
• 出力 URL は永続的な CDN リンクで、有効期限付きでも署名付きでもありません。
• 無料利用には、1 日あたりのレート制限とファイルごとのサイズ上限があります。上限を引き上げる方法は、エラーテキストに記載されています。

プロンプトからアクションへの例

• 「この写真の背景を削除して」- create_upload、バイトデータを PUT、remove_background(file)、ポーリングし、透過 PNG の URL を返します。
• 「出品用に商品を切り抜いて」- 同じ手順の後、必要なサイズがあれば出力に対して edit_image(file, operation="resize", ...) を実行します。
• 「このロゴを透過にしたい」- 同じ手順の後、PNG を返します。

関連項目

画像のサイズ変更、トリミング、形式変換には openclip-thumbnails（edit_image）を使用します。動画から切り抜き用のフレームを取り出す場合も、openclip-thumbnails（extract_thumbnails）を使用します。