Cloudinary

resmi

Cloudinary'in medya yönetim platformuyla doğal dil kullanarak etkileşim kurun.

Cloudinary MCP ile neler yapabilirsiniz?

Medya yükleme ve yönetme — Görselleri, videoları ve ham dosyaları yükleyin; ardından bunları klasörler, etiketler ve varlık ilişkileriyle düzenleyin.
Varlıkları arama ve dönüştürme — Gelişmiş filtreleme ile varlıkları arayın ve varlık işlemleri ile dönüşümlerini uygulayın.
Yapay zekâyla görsel oluşturma — Metin istemlerinden veya referans görsellerden yeni görseller oluşturun ve hesabınıza kaydedin.
Medya içeriğini analiz etme — Varlıklarda yapay zekâ ile etiketleme, moderasyon, açıklama oluşturma, nesne algılama ve filigran veya kalite analizi işlemlerini çalıştırın.
Ortam ayarlarını yapılandırma — Adlandırılmış dönüşümler, yükleme ön ayarları, akış profilleri ve webhook tetikleyicileri oluşturun.
Yapılandırılmış meta verileri yönetme — Meta veri alanları oluşturun, doğrulama kuralları belirleyin ve liste türündeki alanlar için veri kaynağı değerlerini yönetin.

Barındırılan MCP Sunucusu

npx add-mcp 'https://asset-management.mcp.cloudinary.com/mcp'

Claude Code, Codex, Cursor ve daha fazlasına kurulur

Dokümantasyon

Cloudinary MCP Sunucuları

Model Context Protocol (MCP), büyük dil modelleri (LLM'ler) ile harici sistemler arasındaki bağlamı yönetmek için yeni, standartlaştırılmış bir protokoldür. Bu depo, Cloudinary'nin medya yönetimi platformu için kapsamlı MCP sunucuları sağlar. Böylece Cursor ve Claude gibi yapay zekâ uygulamalarından doğal dil kullanarak medya varlıklarınızı doğrudan yükleyebilir, oluşturabilir, dönüştürebilir, analiz edebilir ve düzenleyebilirsiniz.

Bu MCP sunucularıyla, tüm medya iş akışınızı konuşmaya dayalı yapay zekâ üzerinden sorunsuzca yönetebilirsiniz: görsel ve videoları yükleyip oluşturmaktan ve dönüştürmekten otomatik işleme hatlarını yapılandırmaya, yapay zekâ destekli araçlarla içeriği analiz etmeye ve varlıkları yapılandırılmış meta verilerle düzenlemeye kadar. İster medya açısından zengin uygulamalar geliştiriyor, ister büyük varlık kitaplıklarını yönetiyor, ister içerik iş akışlarını otomatikleştiriyor olun, bu sunucular Cloudinary'nin medya optimizasyonu ve yönetimi özelliklerinin tamamına doğrudan erişim sağlar.

Cloudinary için aşağıdaki MCP sunucuları kullanılabilir:

Sunucu Adı	Açıklama	Uzak MCP Sunucusu
Varlık Yönetimi	Medya varlıklarınızı yükleyin, yönetin, arayın ve dönüştürün; metin istemlerinden veya referans görsellerden yapay zekâyla yeni görseller oluşturun	asset-management
Ortam Yapılandırması	Cloudinary ortam ayarlarınızı, yükleme ön ayarlarınızı ve dönüşümlerinizi yapılandırın ve yönetin	environment-config
Yapılandırılmış Meta Veriler	Varlıkların daha iyi düzenlenmesi ve aranabilirliği için yapılandırılmış meta veri alanları oluşturun, yönetin ve sorgulayın	structured-metadata
Analiz	Medya varlıklarınız için yapay zekâ destekli içerik analizi, moderasyon ve otomatik etiketleme özelliklerinden yararlanın	analysis
MediaFlows	Yapay zekâ destekli yardımla görsel ve videolar için düşük kodlu iş akışı otomasyonları oluşturun ve yönetin	mediaflows

İçindekiler

Belgeler
Kurulum
Yapılandırma Örnekleri
- Gelişmiş Yerel Sunucu Yapılandırması
Kimlik Doğrulama
Sunucuya Göre Özellikler
Daha fazla Cloudinary aracına mı ihtiyacınız var?
Sorun Giderme
Ücretli Özellikler
Lisans

Belgeler

Cloudinary'nin MCP sunucularını kullanmaya yönelik ayrıntılı kılavuzlar, eğitimler ve kapsamlı belgeler için:

Cloudinary MCP ve LLM Araçları Belgeleri - Cloudinary'yi yapay zekâ/LLM uygulamalarıyla entegre etmeye yönelik eksiksiz kılavuz
MediaFlows MCP Belgeleri - MediaFlows (MCP) sunucusunu kullanmaya yönelik kurulum talimatları ve yönergeler

Kurulum

Uzak MCP Sunucuları (Önerilen)

Uzak MCP sunucuları Cloudinary tarafından barındırılır ve hemen kullanıma hazırdır. Yerel kurulum gerekmez.

Yerel MCP Sunucuları

Yerel MCP sunucuları, npm paketleri kullanılarak makinenizde çalışır. Daha fazla denetime veya özelleştirmeye ihtiyacınız varsa bu seçeneği tercih edin.

Not: Kurulumdan sonra ortam değişkenlerinizi (CLOUDINARY_CLOUD_NAME, CLOUDINARY_API_KEY, CLOUDINARY_API_SECRET) gerçek kimlik bilgilerinizle yapılandırmanız gerekir.

Docker Görüntüleri

Cloudinary MCP sunucularının resmî Docker görüntüleri Docker Hub'da mevcuttur. Bu görüntüler, MCP sunucularını yerel olarak veya bulut ortamlarında çalıştırmak için kapsayıcı tabanlı bir dağıtım seçeneği sunar.

Docker Hub'da kullanılabilir: Cloudinary MCP Docker Görüntüleri

Docker görüntüleri çeşitli avantajlar sunar:

Yalıtılmış ortamlar - MCP sunucularını sistem bağımlılıklarınızı etkilemeden kapsayıcılarda çalıştırın
Kolay dağıtım - Çok az yapılandırma gerektiren hızlı kurulum
Tutarlı çalışma zamanı - Farklı makineler ve platformlarda aynı ortamı sağlar
Ölçeklenebilirlik - Birden fazla örneği kolayca dağıtın veya kapsayıcı düzenleme sistemlerine entegre edin

Docker görüntülerini kullanmak için sisteminizde Docker'ın kurulu olduğundan emin olun ve kapsayıcıları çalıştırırken Cloudinary kimlik bilgilerinizi ortam değişkenleri olarak iletin. Kullanıma ilişkin özel talimatlar için Docker Hub'daki ilgili Docker görüntüsü belgelerine bakın.

Yapılandırma Örnekleri

Uzak MCP Sunucularının Yapılandırması

Uzak sunucular Cloudinary tarafından barındırılır ve URL üzerinden erişilir:

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp"
    },
    "cloudinary-env-config-remote": {
      "url": "https://environment-config.mcp.cloudinary.com/mcp"
    },
    "cloudinary-smd-remote": {
      "url": "https://structured-metadata.mcp.cloudinary.com/mcp"
    },
    "cloudinary-analysis-remote": {
      "url": "https://analysis.mcp.cloudinary.com/mcp"
    },
    "mediaflows": {
      "url": "https://mediaflows.mcp.cloudinary.com/v2/mcp"
    }
  }
}

Aktarım: Uzak sunucular iki uç noktayı destekler — /mcp (Streamable HTTP, önerilen, durumsuz) ve /sse (SSE, kullanımdan kaldırıldı ancak geriye dönük uyumluluk için korunuyor). /sse uç noktası, /mcp için takma ad olarak POST isteklerini de kabul eder; bu nedenle Streamable HTTP isteklerini /sse adresine gönderen istemciler çalışır. Yeni yapılandırmalar için /mcp kullanın.

Kimlik Doğrulamalı Uzak MCP Sunucuları

Cloudinary tarafından barındırılan uzak MCP sunucuları, kimlik doğrulama için varsayılan olarak OAuth2 kullanır. Başlıklar aracılığıyla API anahtarlarıyla da kimlik doğrulaması yapabilirsiniz:

CLOUDINARY_URL Kullanımı (En Basit Yöntem)

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name"
      }
    }
  }
}

Tek Tek Başlıkların Kullanımı

{
  "mcpServers": {
    "cloudinary-env-config-remote": {
      "url": "https://environment-config.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-cloud-name": "your_cloud_name",
        "cloudinary-api-key": "your_api_key",
        "cloudinary-api-secret": "your_api_secret"
      }
    }
  }
}

Özel Yapılandırmayla

{
  "mcpServers": {
    "cloudinary-smd-remote": {
      "url": "https://structured-metadata.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name",
        "cloudinary-region": "api-eu",
        "cloudinary-tools": "list-metadata-fields,get-metadata-field,create-metadata-field"
      }
    }
  }
}

Hata Ayıklama Başlıklarıyla

API hız sınırı başlıklarını ve istek kimliklerini araç sonuçlarında göstermek için başlıkların eklenmesini etkinleştirin:

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name",
        "cloudinary-embed-headers": "true"
      }
    }
  }
}

Her araç sonucu, hız sınırı ve istek izleme bilgilerini içeren bir _headers alanı içerir:

{
  "_headers": {
    "x-featureratelimit-limit": "10000",
    "x-featureratelimit-remaining": "9998",
    "x-featureratelimit-reset": "Thu, 13 Feb 2026 00:00:00 GMT",
    "x-request-id": "bfeaccc60050594832508590a358a1a4"
  }
}

Yerel MCP Sunucularının Yapılandırması

Yerel sunucular, npm paketleri kullanılarak makinenizde çalışır:

Seçenek 1: CLOUDINARY_URL ortam değişkenini kullanma (Önerilen)

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/asset-management-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-env-config": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/environment-config-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-smd": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/structured-metadata-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-analysis": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/analysis-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    }
  }
}

Seçenek 2: Tek tek ortam değişkenlerini kullanma

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/asset-management-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "cloud_name",
        "CLOUDINARY_API_KEY": "api_key",
        "CLOUDINARY_API_SECRET": "api_secret"
      }
    }
  }
}

Seçenek 3: Komut satırı bağımsız değişkenlerini kullanma

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": [
        "-y", "--package", "@cloudinary/asset-management-mcp",
        "--",
        "mcp", "start",
        "--cloud-name", "cloud_name",
        "--api-key", "api_key",
        "--api-secret", "api_secret"
      ]
    }
  }
}

MediaFlows MCP Sunucusu Yapılandırması

MediaFlows için aşağıdaki yapılandırmayı kullanın:

{
  "mcpServers": {
    "mediaflows": {
      "url": "https://mediaflows.mcp.cloudinary.com/v2/mcp",
      "headers": {
        "cld-cloud-name": "cloud_name",
        "cld-api-key": "api_key",
        "cld-secret": "api_secret"
      }
    }
  }
}

Gelişmiş Yerel Sunucu Yapılandırması

Her npm paketi, yukarıdaki temel kurulum örneklerinin yanı sıra ek yapılandırma seçeneklerini de destekler.

HTTP Sunucusu Olarak Çalıştırma

Yerel bir MCP sunucusunu stdio yerine Streamable HTTP aktarımını kullanarak çalıştırmak için serve komutunu kullanın:

npx -y --package @cloudinary/asset-management-mcp -- mcp serve

Sunucu http://localhost:2718/mcp adresinde dinler. Özel bir bağlantı noktası belirtebilirsiniz:

npx -y --package @cloudinary/asset-management-mcp -- mcp serve --port 3000

Eski SSE aktarımı mcp start --transport sse üzerinden hâlâ kullanılabilir (aynı --port bayrağı, varsayılan değer 2718), ancak kullanımdan kaldırılmıştır. Yeni yapılandırmalar için mcp serve kullanın:

npx -y --package @cloudinary/asset-management-mcp -- mcp start --transport sse

Kullanılabilir Yapılandırma Seçenekleri

Herhangi bir paketin tüm kullanılabilir yapılandırma seçeneklerini görmek için:

npx -y --package @cloudinary/asset-management-mcp -- mcp start --help
npx -y --package @cloudinary/asset-management-mcp -- mcp serve --help

Kullanılabilir bayrakların tam listesi (@cloudinary/asset-management-mcp; diğer paketler bunların bir alt kümesini destekler):

USAGE
  mcp start [--transport stdio|sse] [--port value] [--tool value]... [--mode dynamic]
            [--tool-annotations value] [--scope admin|builder|librarian]
            [--api-key value] [--api-secret value] [--oauth2 value]
            [--cloud-name value] [--server-url value] [--server-index value]
            [--region api|api-eu|api-ap] [--api-host value] [--mcp-apps value]
            [--log-level debug|warning|info|error] [--env value]...
  mcp serve [--port value] [--disable-static-auth] [--tool value]... [--mode dynamic]
            [--tool-annotations value] [--scope admin|builder|librarian]
            [--api-key value] [--api-secret value] [--oauth2 value]
            [--cloud-name value] [--server-url value] [--server-index value]
            [--region api|api-eu|api-ap] [--api-host value] [--mcp-apps value]
            [--log-level debug|warning|info|error] [--env value]...

COMMANDS
  start  Run the MCP server (stdio by default)
  serve  Run the MCP server with Streamable HTTP transport

FLAGS
  --transport              start only: the transport to use
                           [stdio|sse, default = stdio; sse is deprecated]
  --port                   The port to listen on [default = 2718]
  --disable-static-auth    serve only: disable static authentication, allowing
                           credentials to be passed via request headers only
  --tool...                Specify tools to mount on the server (repeatable)
  --mode                   dynamic: expose list_tools, describe_tool_input, and
                           execute_tool instead of individual tools [dynamic]
  --tool-annotations       Filter tools by annotations (comma-separated:
                           readOnly, destructive, idempotent, openWorld)
  --scope                  Mount tools/resources that match given scope
                           (repeatable) [admin|builder|librarian]
  --api-key                Sets the api_key auth field for the API
  --api-secret             Sets the api_secret auth field for the API
  --oauth2                 Sets the oauth2 auth field for the API
  --cloud-name             Allows setting the cloud_name parameter for all
                           supported operations
  --server-url             Overrides the default server URL used by the SDK
  --server-index           Selects a predefined server used by the SDK
  --region                 Sets the region variable for url substitution
                           [api|api-eu|api-ap]
  --api-host               Sets the host variable for url substitution
  --mcp-apps               Enable MCP Apps (interactive UI): bare flag or
                           all/true, none/false, or a comma-separated list of
                           asset-gallery,asset-details,asset-upload
  --log-level              The log level to use for the server
                           [debug|warning|info|error, default = info]
  --env...                 Environment variables made available to the server
  -h, --help               Print help information and exit

Hata Ayıklama

Ayrıntılı ağ yükü hata ayıklaması için CLOUDINARY_DEBUG ortam değişkenini kullanın:

CLOUDINARY_DEBUG=true npx -y --package @cloudinary/asset-management-mcp -- mcp start

Kapsamlı sorun giderme için hata ayıklama modunu diğer seçeneklerle birleştirebilirsiniz:

CLOUDINARY_DEBUG=true npx -y --package @cloudinary/asset-management-mcp -- mcp serve --log-level debug

Not: Bu yapılandırma seçenekleri tüm yerel MCP paketleri için geçerlidir:

@cloudinary/asset-management-mcp
@cloudinary/environment-config-mcp
@cloudinary/structured-metadata-mcp
@cloudinary/analysis-mcp

Kimlik Doğrulama

MCP sunucularını yerel olarak çalıştırırken kimlik doğrulaması birkaç şekilde yapılandırılabilir:

Seçenek 1: Tek tek ortam değişkenleri (Önerilen)

export CLOUDINARY_CLOUD_NAME="cloud_name"
export CLOUDINARY_API_KEY="api_key"
export CLOUDINARY_API_SECRET="api_secret"

Seçenek 2: CLOUDINARY_URL ortam değişkeni

export CLOUDINARY_URL="cloudinary://api_key:api_secret@cloud_name"

Seçenek 3: Komut satırı bağımsız değişkenleri

Kimlik bilgilerini doğrudan bağımsız değişken olarak iletin (yukarıdaki yapılandırma örneklerine bakın)

Cloudinary kimlik bilgilerinizi Cloudinary Console Dashboard bölümünde, Settings > Security altında bulabilirsiniz.

Sunucuya Göre Özellikler

Varlık Yönetimi Sunucusu

Medya varlıklarını (görseller, videolar, ham dosyalar) yükleyin ve yönetin
Gelişmiş filtreleme ve görsel aramayla varlıkları arayın ve düzenleyin
Metin istemlerinden veya referans görsellerden yapay zekâyla yeni görseller oluşturup doğrudan hesabınıza kaydedin
Varlık işlemlerini ve dönüşümlerini gerçekleştirin
Klasörleri, etiketleri ve varlık ilişkilerini yönetin
Arşivler ve indirme bağlantıları oluşturun

Ortam Yapılandırması Sunucusu

Adlandırılmış dönüşümler ve yükleme ön ayarları oluşturun ve yönetin
Akış profillerini ve tetikleyicileri (web kancası bildirimleri) yönetin
Yükleme eşlemelerini ayarlayın

Yapılandırılmış Meta Veriler Sunucusu

Yapılandırılmış meta veri alanları oluşturun ve yönetin
Koşullu meta veri kurallarını ve doğrulamayı yapılandırın
Liste türündeki meta veri alanları için veri kaynağı değerlerini yönetin
Meta veri yapılandırmalarını düzenleyin ve arayın

Analiz Sunucusu

Etiketleme, moderasyon ve açıklama ekleme dahil yapay zekâ destekli içerik analizi
Birden fazla yapay zekâ modeliyle nesne algılama ve tanıma
Görüntü kalitesi analizi ve filigran algılama
İçerik moderasyonu ve güvenlik analizi
Moda, metin ve anatomi algılama özellikleri
Logo algılama ve ürün (mağaza) sınıflandırması

MediaFlows Sunucusu

Doğal dil kullanarak iş akışı otomasyonları oluşturun ve yönetin
Ortamınızdaki mevcut PowerFlow otomasyonlarını sorgulayın
Meta verilere, etiketlere ve varlık özelliklerine dayalı koşullu mantık oluşturun
Varlık moderasyonu, onay ve bildirim iş akışlarını otomatikleştirin
Mevcut otomasyon yapılandırmalarında hata ayıklayın ve bunları anlayın

Daha fazla Cloudinary aracına mı ihtiyacınız var?

Bu MCP sunucularına yeni işlevler eklemeye devam ediyoruz. Geri bildirim bırakmak, hata bildirmek veya özellik isteğinde bulunmak isterseniz lütfen bu depoda bir sorun kaydı açın.

Sorun Giderme

"Claude'un yanıtı kesildi..."

Bu mesajı görüyorsanız Claude büyük olasılıkla bağlam uzunluğu sınırına ulaşmış ve yanıtın ortasında durmuştur. Bu durum en çok, büyük varlık listeleri içeren varlık yönetimi sunucusu gibi art arda birçok araç çağrısını tetikleyen sunucularda görülür.

Bu sorunla karşılaşma olasılığını azaltmak için:

İsteklerinizde açık olun ve kısa ifadeler kullanın.
Tek bir istek birden fazla aracı çağırıyorsa yanıtları kısa tutmak için isteği birkaç küçük araç çağrısına bölmeyi deneyin.
Varlık aramalarının ve listelerinin kapsamını sınırlamak için filtreleme parametrelerini kullanın.

Kimlik Doğrulama Sorunları

Cloudinary kimlik bilgilerinizin doğru yapılandırıldığından ve gerçekleştirmeye çalıştığınız işlemler için gerekli izinlere sahip olduğundan emin olun.

Ücretli Özellikler

Bazı özellikler ücretli bir Cloudinary planı gerektirebilir. Kullanmayı düşündüğünüz özellikler için Cloudinary hesabınızın gerekli abonelik düzeyine sahip olduğundan emin olun. Örneğin:

Gelişmiş yapay zekâ analiz özellikleri
Yüksek hacimli API kullanımı
Gelişmiş dönüşüm özellikleri

Lisans

MIT Lisansı kapsamında lisanslanmıştır. Ayrıntılar için LICENSE dosyasına bakın.