ClaudeとCloudinaryを連携する方法 — 画像・動画の管理を会話で任せる

ClaudeとCloudinaryの連携でできること

Cloudinaryコネクタは、画像・動画の管理サービスCloudinaryのアセットを、Claudeの会話から操作できるようにするConnectorです。開発元はCloudinary自身で、Connectorsディレクトリではデータ・分析と開発者ツールの2カテゴリに載っています。Anthropic verifiedの表示があり、追加時期は2025年11月、サインインが必須です。

接続先はディレクトリ上で https://asset-management.mcp.cloudinary.com/sse です。Cloudinaryのドキュメントでは、リモートサーバーの推奨エンドポイントは /mcp(Streamable HTTP、ステートレス)です。/sse は、Analysisサーバーを除いて非推奨とされ、将来のバージョンで削除される予定です。

ただし /sse は、Streamable HTTPのPOSTリクエストを /mcp の別名として受け付けます。ディレクトリ経由で追加した接続が、すぐに使えなくなるわけではありません。自分でURLを書く構成では /mcp を使います。

できることは、ディレクトリに載る22のツール名から読み取れます。アップロード、リネーム、ダウンロード、アーカイブ生成、検索、タグ一覧、フォルダー操作、使用量の取得などです。Cloudinaryのドキュメントには、次のような依頼例が挙がっています。

• タグ transparent が付いた全アセットのURLを返す
• sample.jpg を300x300にリサイズし、auto gravity(自動の切り抜き位置)を指定してWebPに変換するURLを作る
• タグ campaign-2024 が付いたアセットを削除する

使えるMCPサーバーは5種類ある

Cloudinaryは機能ごとにMCPサーバーを分けています。ディレクトリのコネクタが指すのは、このうちAsset Managementだけです。

変換まわりでは、2つのページの記述がずれています。ディレクトリの一覧には「変換」を名前に含むツールが1つもなく、掲載は22件です。Cloudinaryのドキュメントは、Asset Managementサーバーに変換ルールファイルを使う専用の変換ツールが含まれると説明しています。変換を任せたい場合は、接続後にClaudeへ変換URLの生成を頼み、動くかどうかを試すのが確実です。

Environment Config、Structured Metadata、Analysisを使うには、カスタムコネクタか設定ファイルで別々に追加します。追加すると開いているツールが増え、コンテキストの消費や誤操作の元になります。Cloudinaryのドキュメントも、必要のないサーバーやツールは無効にするよう勧めています。

認証にも差があります。Analysisサーバーは、APIキーでの認証に対応していません。OAuthで接続します。MediaFlowsサーバーは逆にOAuthを使わず、ヘッダーに認証情報を足す構成です。

22のツールを作業別に分ける

ディレクトリ掲載の22ツールを、名前の意味に沿って分けます。役割は名前からの分類で、個々の引数までは公式の一覧に書かれていません。

visual-search-assets は名前から画像による検索を想定できますが、ディレクトリの一覧に入力形式の説明は付いていません。試す前に、Claudeにツールの説明を表示させて確かめます。

削除系ツールをどう扱うか

このコネクタには、破壊的な操作ができるツールが4つあります。delete-asset、delete-derived-assets、delete-asset-relations、delete-folder です。Cloudinaryのドキュメントの依頼例にも「タグ campaign-2024 が付いた全アセットを削除する」という一括削除の文があります。

Claude側には、ツールごとの許可を絞る仕組みがあります。サポート記事によれば、TeamとEnterpriseのプランでは、OwnerがCustomize、Connectorsの画面でコネクタのTool permissionsを開き、Always allow、Needs approval、Blockedを選べます。ツールは読み取りと書き込み・削除といった種類ごとに分類され、設定は組織全体に効きます。

この段階分けはCloudinaryやAnthropicの推奨ではなく、ツールの種類に合わせた一例です。Claudeで書き込みを許可しても、Cloudinary側にその操作の権限がなければ実行できません。個人プランには組織向けのOwner設定がないため、削除を伴う依頼は実行前に対象の一覧を出させる運用になります。

Owner設定に頼れない場合の手段が、cloudinary-tools ヘッダーです。有効にするツールを名前で列挙できるので、削除系4本を含めずに接続すれば、Claudeからは削除ツールが見えません。ドキュメントがヘッダーを示しているのは、設定ファイルやコマンドでURLを直接指定する構成です。ディレクトリ経由の追加では、この指定は使えない前提で考えます。書き方は、このあとのClaude Codeでの追加の節にあります。

権限の面でも注意があります。ClaudeがCloudinaryのアセットを触れるのは、コネクタ経由で認証したアカウントの権限の範囲内です。サポート記事にも、Claudeは接続先サービスでの各人の権限を引き継ぐとあります。共有アカウントに管理者権限を持たせたまま接続すると、削除系ツールもその権限で動きます。

Claudeに接続する手順

claude.aiとClaude Desktop

Cloudinaryのドキュメントは、Claude Desktopへの追加方法を3通り挙げています。

サポート記事では、リモートMCPを使うカスタムコネクタは無料、Pro、Max、Team、Enterpriseで使えます。無料プランのカスタムコネクタは1つまでです。Cloudinaryのドキュメントは「有料プラン」としており、2つのページで条件が食い違います。無料プランで追加できるかどうかは、実際の画面で試すのが確実です。

Claude Codeでの追加

Claude Codeには、Cloudinaryのドキュメントが示すコマンドで追加します。

claude mcp add --transport sse cloudinary-asset-mgmt \
  https://asset-management.mcp.cloudinary.com/mcp

コマンドの --transport sse と /mcp のURLの組み合わせは、ドキュメントの記載どおりです。追加後にClaude Code内で /mcp を実行すると、CloudinaryのOAuth認証に進みます。OAuthを使わずAPIキーで認証したい場合は、cloudinary-url ヘッダーに cloudinary://api_key:api_secret@cloud_name の形式で認証情報を渡す方法もあります。APIキーを渡す構成では、設定ファイルに秘密情報が残ります。共有リポジトリの設定に書き込まない扱いが必要です。

APIキーで接続する構成では、追加のヘッダーも渡せます。Cloudinaryのドキュメントには、次の3つが挙がっています。

cloudinary-region の例に出てくる値は api-eu だけで、EU以外のリージョンの値は示されていません。cloudinary-embed-headers を有効にすると、ツールの結果に _headers というフィールドが付きます。大量のアセットを流すときの、レート制限の残りを見る手がかりになります。

設定ファイルの例は、headers に cloudinary-url と並べて書く形です。次のJSONは mcpServers の中に入れる断片で、置く場所はクライアントごとに異なります。

{
  "cloudinary-asset-mgmt": {
    "url": "https://asset-management.mcp.cloudinary.com/mcp",
    "headers": {
      "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name",
      "cloudinary-tools": "search-assets,list-tags,get-usage-details"
    }
  }
}

この cloudinary-tools の値は、Asset Managementの読み取り系ツールだけを並べた例です。ドキュメントの例はStructured Metadataサーバー向けなので、Asset Managementで同じ書き方が通るかは接続後に試します。

マーケットプレイスのプラグインも使えます。Claude Codeでは次のコマンドで入ります。

/plugin install cloudinary@claude-plugins-official

プラグインには、Cloudinaryスキルの一部と、すべてのリモートMCPサーバーが含まれます。ChatGPTとCodex向けのプラグインはAsset Managementのみで、スキルは付きません。

ローカルサーバーという選択肢

リモートサーバーのほかに、npmパッケージとして自分のマシンで動かすローカルサーバーもあります。Node.js v18以上とnpmが要り、クラウド名・APIキー・APIシークレットを設定に書き込む構成です。パッケージ名は @cloudinary/asset-management のように、サーバーごとに分かれています。設定を細かく制御したい環境向けの選択肢で、認証情報と更新は自分で管理します。

Claude Desktopの設定ファイルでリモートサーバーを使うときは、npx mcp-remote を経由します。APIキーは MCP_HEADER_cloudinary-cloud-name のような環境変数名で渡す形です。

依頼の書き方と確認の型

Cloudinaryのドキュメントには、精度を上げるための注意が並んでいます。Claudeで使う場合に効くものを絞ります。

• Cloudinaryを使いたい場面では、Cloudinaryを使うことを明示する
• クラウドがダイナミックフォルダーモードか固定フォルダーモードかを伝える
• 自動タグ付けなどのアドオンを使うなら、先にコンソールでアドオンを有効にしておく
• メタデータを扱うなら、対象のフィールド名やタグの付け方を指定する
• Console側でSecurity Settingsなどの設定を有効にしないと動かない機能は、先に有効にしておく
• 高性能なモデルが選べるなら、そちらを使う

依頼文の例を挙げます。

Cloudinaryのフォルダー marketing/spring-sale にある画像のうち、
タグ spring-sale が付いたものを一覧にして。
その後、今月の使用量を get-usage-details で確認して報告して。
削除や更新はしないで。

この例は、読み取り系のツールだけを使う依頼の形です。ツールを名指しして操作の範囲を先に限ると、意図しない書き込みを避けやすくなります。出力は毎回同じとは限らず、Cloudinaryのドキュメントも「今日のプロンプトが明日は別の結果になることがある」と注意しています。

変換URLの生成を頼むときは、変換ルールのMarkdownファイル(cloudinary_transformation_rules.md)を文脈に添える方法もあります。Cloudinaryが公開しているファイルです。有効な変換パラメーターだけを使わせるためのファイルです。SDKを使ったコードを書かせるなら、プロンプトの末尾に use context7 を付けるよう案内されています。

使用量は get-usage-details で読めます。ディレクトリのツール一覧には、どの指標をどの単位で返すかの説明が付いていません。請求に関わる数字は、Cloudinaryのコンソールの表示と突き合わせてください。

分析・広告データは別のコネクタが向く

利用状況の分析や広告データの取り込みは、別のコネクタが向きます。たとえばClaudeとMixpanelを連携する方法やClaudeとSupermetricsを連携する方法で扱っています。ツールが多いコネクタを追加したときのコンテキスト消費については、MCPツール説明文の文字数上限を変える方法が関係します。

よくある質問

アカウントを持っていなくても試せますか

Cloudinaryのドキュメントによれば、アカウントがない場合はエージェントが npx @cloudinary/cloud で一時的なClaimable Cloudを用意できます。メールアドレスでの認証を済ませるまでは一時的なもので、認証しなければ自動で失効します。

まとめ

ディレクトリから追加できるのはAsset Managementだけで、削除系4本を含む22のツールが一度に開きます。個人プランには組織向けのTool permissionsがないため、ディレクトリ経由なら、削除を伴う依頼は対象の一覧を見てから進めます。URLを自分で書く構成なら cloudinary-tools で削除系を外せます。設定やメタデータ、解析まで任せたいなら、カスタムコネクタか設定ファイルでサーバーを足します。