Cloudinary

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

Cloudinary MCP Sunucuları

Model Context Protocol (MCP), büyük dil modelleri (LLM'ler) ile harici sistemler arasında bağlam yönetimi için yeni ve standartlaştırılmış bir protokoldür. Bu depo, Cloudinary'nin medya yönetim platformu için kapsamlı MCP sunucuları sağlar ve Cursor ile Claude gibi yapay zeka uygulamalarından doğrudan doğal dil kullanarak medya varlıklarınızı yüklemenize, dönüştürmenize, analiz etmenize ve düzenlemenize olanak tanır.

Bu MCP sunucuları sayesinde, görüntü ve video yükleme ve dönüştürmeden otomatik işleme hatları yapılandırmaya, yapay zeka destekli araçlarla içerik analizine ve yapılandırılmış meta verilerle varlıkları düzenlemeye kadar tüm medya iş akışınızı konuşmaya dayalı yapay zeka ile sorunsuz bir şekilde yönetebilirsiniz. Medya açısından zengin uygulamalar oluşturuyor, büyük varlık kitaplıklarını yönetiyor veya içerik iş akışlarını otomatikleştiriyor olun, bu sunucular Cloudinary'nin medya optimizasyonu ve yönetimi yeteneklerinin tamamına doğrudan erişim sağlar.

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

Sunucu Adı	Açıklama	Uzaktan MCP Sunucusu
Varlık Yönetimi	Gelişmiş arama ve organizasyon yetenekleriyle medya varlıklarınızı yükleyin, yönetin ve dönüştürün	asset-management
Ortam Yapılandırması	Cloudinary ortam ayarlarınızı, yükleme ön ayarlarını ve dönüşümlerinizi yapılandırın ve yönetin	environment-config
Yapılandırılmış Meta Veriler	Gelişmiş varlık organizasyonu ve aranabilirlik 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 zeka destekli içerik analizi, moderasyon ve otomatik etiketleme yeteneklerinden yararlanın	analysis
MediaFlows	Yapay zeka destekli yardımla görüntüler ve videolar için düşük kodlu iş akışı otomasyonları oluşturun ve yönetin	mediaflows

İçindekiler

• Dokümantasyon
• Kurulum
  • Uzaktan MCP Sunucuları (Önerilen)
  • Yerel MCP Sunucuları
  • Docker Görüntüleri
• Yapılandırma Örnekleri
  • Gelişmiş Yerel Sunucu Yapılandırması
• Kimlik Doğrulama
• Sunuculara Göre Özellikler
• Daha fazla Cloudinary aracına mı ihtiyacınız var?
• Sorun Giderme
• Ücretli Özellikler
• Lisans

Dokümantasyon

Cloudinary'nin MCP sunucularını kullanmaya ilişkin ayrıntılı kılavuzlar, eğiticiler ve kapsamlı dokümantasyon için:

• Cloudinary MCP ve LLM Araç Dokümantasyonu - Cloudinary'yi yapay zeka/LLM uygulamalarıyla entegre etmek için eksiksiz kılavuz
• MediaFlows MCP Dokümantasyonu - MediaFlows (MCP) sunucusunu kullanmak için kurulum talimatları ve yönergeler

Kurulum

Uzaktan MCP Sunucuları (Önerilen)

Uzaktan 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 paketlerini kullanarak makinenizde çalışır. Daha fazla kontrol 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 gerekecektir.

Docker Görüntüleri

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

Docker Hub'da mevcuttur: Cloudinary MCP Docker Görüntüleri

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

• İzole ortamlar - MCP sunucularını sistem bağımlılıklarınızı etkilemeden kapsayıcılarda çalıştırın
• Kolay dağıtım - Minimum 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ı orkestrasyon 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. Belirli kullanım talimatları için Docker Hub'daki ilgili Docker görüntü dokümantasyonuna bakın.

Yapılandırma Örnekleri

Uzaktan MCP Sunucuları Yapılandırması

Uzaktan 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/sse"
    },
    "mediaflows": {
      "url": "https://mediaflows.mcp.cloudinary.com/v2/mcp"
    }
  }
}

Taşıma: Uzaktan sunucular iki uç noktayı destekler — /mcp (Streamable HTTP, önerilen, durumsuz) ve /sse (SSE, kullanımdan kaldırıldı, geriye dönük uyumluluk için korunuyor). /sse uç noktası ayrıca /mcp için bir takma ad olarak POST isteklerini kabul eder, böylece Streamable HTTP'yi /sse adresine gönderen istemciler çalışır. Yeni yapılandırmalar için /mcp kullanın.

Kimlik Doğrulamalı Uzaktan MCP Sunucuları

Cloudinary tarafından barındırılan uzaktan MCP sunucuları, kimlik doğrulama için varsayılan olarak OAuth2 kullanır. Ayrıca başlıklar aracılığıyla API anahtarlarını kullanarak kimlik doğrulaması yapabilirsiniz:

CLOUDINARY_URL Kullanma (En Basit)

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

Ayrı Başlıklar Kullanma

{
  "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ırma ile

{
  "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ı ile

API hız sınırı başlıklarını ve istek kimliklerini araç sonuçlarında görüntülemek için başlık yerleştirmeyi 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çerecektir:

{
  "_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ı Yapılandırması

Yerel sunucular, npm paketlerini kullanarak 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", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    }
  }
}

Seçenek 2: Ayrı 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 ötesinde ek yapılandırma seçeneklerini destekler.

SSE Sunucusu Olarak Çalıştırma

stdio yerine Server-Sent Events (SSE) taşımasını kullanarak yerel bir MCP sunucusu çalıştırmak için:

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

Özel bir bağlantı noktası belirtebilirsiniz (varsayılan 2718'dir):

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

Kullanılabilir Yapılandırma Seçenekleri

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

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

Kullanılabilir işaretlerin tam listesi:

USAGE
  mcp start [--transport stdio|sse] [--port value] [--tool 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]
            [--log-level debug|warning|info|error] [--env value]...

FLAGS
  --transport       The transport to use for communicating with the server
                    [stdio|sse, default = stdio]
  --port            The port to use when the SSE transport is enabled
                    [default = 2718]
  --tool...         Specify tools to mount on the server (repeatable)
  --scope           Mount tools/resources that match given scope
                    [admin|builder|librarian]
  --api-key         Sets the apiKey auth field for the API
  --api-secret      Sets the apiSecret auth field for the API
  --oauth2          Sets the oauth2 auth field for the API
  --cloud-name      Allows setting the cloudName parameter for all 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
  --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

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

CLOUDINARY_DEBUG=true npx -y --package @cloudinary/asset-management-mcp -- mcp start --transport sse --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

Kimlik Doğrulama

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

Seçenek 1: Ayrı 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şkenler olarak iletin (yukarıdaki yapılandırma örneklerine bakın)

Cloudinary kimlik bilgilerinizi Cloudinary Konsol Panosu altında Ayarlar > Güvenlik bölümünde bulabilirsiniz.

Sunuculara Göre Özellikler

Varlık Yönetimi Sunucusu

• Medya varlıklarını yükleyin ve yönetin (görüntüler, videolar, ham dosyalar)
• Gelişmiş filtreleme yetenekleriyle varlıkları arayın ve düzenleyin
• Varlık işlemlerini ve dönüşümlerini yönetin
• Klasörleri, etiketleri ve varlık ilişkilerini yönetin
• Arşivler ve indirme bağlantıları oluşturun

Ortam Yapılandırması Sunucusu

• Yükleme ön ayarlarını ve dönüşüm ayarlarını yapılandırın
• Akış profillerini ve webhook bildirimlerini 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
• Meta veri yapılandırmalarını düzenleyin ve arayın
• Meta veri alanı ilişkilerini ve sıralamasını yönetin

Analiz Sunucusu

• Etiketleme, moderasyon ve altyazı oluşturma dahil yapay zeka destekli içerik analizi
• Birden fazla yapay zeka 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 yetenekleri

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 anlayın

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

Bu MCP sunucularına daha fazla işlevsellik eklemeye devam ediyoruz. Geri bildirim bırakmak, bir hata bildirmek veya bir özellik isteği sağlamak isterseniz, lütfen bu depoda bir sorun açın.

Sorun Giderme

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

Bu mesajı görürseniz, 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 en çok, büyük varlık listeleri içeren varlık yönetimi sunucusu gibi birçok zincirleme araç çağrısını tetikleyen sunucularda görülür.

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

• Spesifik olmaya çalışın, sorgularınızı kısa tutun.
• Tek bir istek birden fazla aracı çağırıyorsa, yanıtları kısa tutmak için onu birkaç daha 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 zeka analiz özellikleri
• Yüksek hacimli API kullanımı
• Gelişmiş dönüştürme yetenekleri

Lisans

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