Cloudinary

официальный

Взаимодействуйте с платформой управления медиа Cloudinary с помощью естественного языка.

Что можно делать с Cloudinary MCP?

Загружайте медиафайлы и управляйте ими — Загружайте изображения, видео и исходные файлы, а затем упорядочивайте их с помощью папок, тегов и связей между ресурсами.
Ищите ресурсы и преобразуйте их — Ищите ресурсы с помощью расширенных фильтров и применяйте к ним операции и преобразования.
Создавайте изображения с помощью ИИ — Создавайте изображения по текстовым запросам или референсным изображениям и сохраняйте их в своей учетной записи.
Анализируйте содержимое медиафайлов — Запускайте для ресурсов автоматическую разметку, модерацию, создание подписей, обнаружение объектов, а также анализ водяных знаков и качества.
Настраивайте параметры среды — Создавайте именованные преобразования, пресеты загрузки, профили потоковой передачи и триггеры вебхуков.
Управляйте структурированными метаданными — Создавайте поля метаданных, задавайте правила проверки и управляйте значениями источников данных для полей со списками.

Размещённый MCP-сервер

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

Устанавливается в Claude Code, Codex, Cursor и другие

Документация

MCP-серверы Cloudinary

Model Context Protocol (MCP) — это новый стандартизированный протокол для управления контекстом между большими языковыми моделями (LLM) и внешними системами. Этот репозиторий содержит комплексные MCP-серверы для платформы управления медиафайлами Cloudinary, позволяющие использовать естественный язык для загрузки, создания, преобразования, анализа и организации медиафайлов непосредственно из приложений на базе ИИ, таких как Cursor и Claude.

С помощью этих MCP-серверов вы можете легко управлять всем рабочим процессом с медиафайлами через диалоговый ИИ: загружать, создавать и преобразовывать изображения и видео, настраивать автоматизированные конвейеры обработки, анализировать контент с помощью инструментов на базе ИИ и организовывать ресурсы с помощью структурированных метаданных. Независимо от того, разрабатываете ли вы приложения с большим количеством медиафайлов, управляете крупными библиотеками ресурсов или автоматизируете рабочие процессы с контентом, эти серверы предоставляют прямой доступ ко всему набору возможностей Cloudinary для оптимизации и управления медиафайлами.

Для Cloudinary доступны следующие MCP-серверы:

Название сервера	Описание	Удалённый MCP-сервер
Управление ресурсами	Загружайте, управляйте, ищите и преобразуйте медиафайлы, а также создавайте изображения с помощью ИИ на основе текстовых запросов или эталонных изображений	asset-management
Конфигурация среды	Настраивайте и управляйте параметрами среды Cloudinary, пресетами загрузки и преобразованиями	environment-config
Структурированные метаданные	Создавайте, управляйте и запрашивайте поля структурированных метаданных для улучшенной организации ресурсов и поиска	structured-metadata
Анализ	Используйте возможности анализа контента на базе ИИ, модерации и автоматической маркировки медиафайлов	analysis
MediaFlows	Создавайте и управляйте автоматизированными рабочими процессами с минимальным объёмом кода для изображений и видео с помощью ИИ	mediaflows

Содержание

Документация
Установка
Примеры конфигурации
- Расширенная конфигурация локального сервера
Аутентификация
Возможности серверов
Нужен доступ к другим инструментам Cloudinary?
Устранение неполадок
Платные функции
Лицензия

Документация

Подробные руководства, учебные материалы и полную документацию по использованию MCP-серверов Cloudinary см. здесь:

Документация по Cloudinary MCP и инструментам LLM — полное руководство по интеграции Cloudinary с приложениями на базе ИИ/LLM
Документация по MediaFlows MCP — инструкции по настройке и рекомендации по использованию сервера MediaFlows (MCP)

Установка

Удалённые MCP-серверы (рекомендуется)

Удалённые MCP-серверы размещены на стороне Cloudinary и готовы к немедленному использованию. Локальная установка не требуется.

Локальные MCP-серверы

Локальные MCP-серверы запускаются на вашем компьютере с помощью пакетов npm. Выберите этот вариант, если вам нужен больший контроль или возможность настройки.

Примечание: после установки необходимо настроить переменные среды (CLOUDINARY_CLOUD_NAME, CLOUDINARY_API_KEY, CLOUDINARY_API_SECRET), указав свои учётные данные.

Образы Docker

Официальные образы Docker для MCP-серверов Cloudinary доступны на Docker Hub и позволяют запускать MCP-серверы локально или в облачных средах в контейнерах.

Доступно на Docker Hub: Образы Docker для MCP Cloudinary

Образы Docker имеют ряд преимуществ:

Изолированные среды — запускайте MCP-серверы в контейнерах, не затрагивая системные зависимости
Простое развёртывание — быстрая настройка с минимальными требованиями к конфигурации
Единообразная среда выполнения — одинаковая среда на разных компьютерах и платформах
Масштабируемость — легко разворачивайте несколько экземпляров или интегрируйте их с системами оркестрации контейнеров

Чтобы использовать образы Docker, убедитесь, что Docker установлен в вашей системе, и передавайте учётные данные Cloudinary в виде переменных среды при запуске контейнеров. Инструкции по использованию см. в документации соответствующего образа Docker на Docker Hub.

Примеры конфигурации

Конфигурация удалённых MCP-серверов

Удалённые серверы размещены на стороне Cloudinary и доступны по URL:

{
  "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"
    }
  }
}

Транспорт: удалённые серверы поддерживают две конечные точки — /mcp (Streamable HTTP, рекомендуется, без сохранения состояния) и /sse (SSE, устаревший вариант, сохранённый для обратной совместимости). Конечная точка /sse также принимает запросы POST как псевдоним для /mcp, поэтому клиенты, отправляющие Streamable HTTP на /sse, будут работать. Для новых конфигураций используйте /mcp.

Аутентификация удалённых MCP-серверов

Удалённые MCP-серверы, размещённые на стороне Cloudinary, по умолчанию используют OAuth2 для аутентификации. Также можно пройти аутентификацию с помощью ключей API, передаваемых в заголовках:

Использование CLOUDINARY_URL (самый простой способ)

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

Использование отдельных заголовков

{
  "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"
      }
    }
  }
}

Пользовательская конфигурация

{
  "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"
      }
    }
  }
}

Отладочные заголовки

Чтобы включить в результаты инструментов заголовки с ограничениями частоты запросов API и идентификаторами запросов, включите добавление заголовков:

{
  "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"
      }
    }
  }
}

Каждый результат инструмента будет содержать поле _headers с информацией об ограничениях частоты запросов и отслеживании запросов:

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

Конфигурация локальных MCP-серверов

Локальные серверы запускаются на вашем компьютере с помощью пакетов npm:

Вариант 1: использование переменной среды CLOUDINARY_URL (рекомендуется)

{
  "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"
      }
    }
  }
}

Вариант 2: использование отдельных переменных среды

{
  "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"
      }
    }
  }
}

Вариант 3: использование аргументов командной строки

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

Для MediaFlows используйте следующую конфигурацию:

{
  "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"
      }
    }
  }
}

Расширенная конфигурация локального сервера

Каждый пакет npm поддерживает дополнительные параметры конфигурации помимо основных примеров настройки выше.

Запуск в качестве HTTP-сервера

Чтобы запустить локальный MCP-сервер с транспортом Streamable HTTP вместо stdio, используйте команду serve:

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

Сервер прослушивает порт http://localhost:2718/mcp. Можно указать другой порт:

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

Устаревший транспорт SSE по-прежнему доступен через mcp start --transport sse (тот же флаг --port, значение по умолчанию — 2718), но он считается устаревшим. Для новых конфигураций используйте mcp serve:

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

Доступные параметры конфигурации

Чтобы просмотреть все доступные параметры конфигурации для любого пакета:

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

Полный список доступных флагов (@cloudinary/asset-management-mcp; другие пакеты поддерживают подмножество этих флагов):

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

Отладка

Для подробной отладки сетевых данных используйте переменную среды CLOUDINARY_DEBUG:

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

Для комплексного устранения неполадок можно сочетать режим отладки с другими параметрами:

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

Примечание: эти параметры конфигурации применяются ко всем локальным пакетам MCP:

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

Аутентификация

При локальном запуске MCP-серверов аутентификацию можно настроить несколькими способами:

Вариант 1: отдельные переменные среды (рекомендуется)

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

Вариант 2: переменная среды CLOUDINARY_URL

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

Вариант 3: аргументы командной строки

Передайте учётные данные непосредственно в аргументах (см. примеры конфигурации выше)

Учётные данные Cloudinary можно найти в панели управления Cloudinary Console в разделе Settings > Security.

Возможности серверов

Сервер управления ресурсами

Загружайте медиафайлы и управляйте ими (изображения, видео, исходные файлы)
Ищите и организуйте ресурсы с помощью расширенной фильтрации и визуального поиска
Создавайте изображения с помощью ИИ на основе текстовых запросов или эталонных изображений и сохраняйте их непосредственно в своей учётной записи
Выполняйте операции с ресурсами и преобразования
Управляйте папками, тегами и связями между ресурсами
Создавайте архивы и ссылки для скачивания

Сервер конфигурации среды

Создавайте именованные преобразования и пресеты загрузки и управляйте ими
Управляйте профилями потоковой передачи и триггерами (уведомлениями вебхуков)
Настраивайте сопоставления загрузки

Сервер структурированных метаданных

Создавайте поля структурированных метаданных и управляйте ими
Настраивайте условные правила для метаданных и проверку данных
Управляйте значениями источников данных для полей метаданных типа «список»
Организуйте конфигурации метаданных и выполняйте поиск по ним

Сервер анализа

Анализ контента на базе ИИ, включая маркировку, модерацию и создание подписей
Обнаружение и распознавание объектов с помощью нескольких моделей ИИ
Анализ качества изображений и обнаружение водяных знаков
Модерация контента и анализ безопасности
Обнаружение моды, текста и анатомических объектов
Обнаружение логотипов и классификация товаров (для покупок)

Сервер MediaFlows

Создавайте автоматизированные рабочие процессы и управляйте ими с помощью естественного языка
Запрашивайте существующие автоматизации PowerFlow в своей среде
Создавайте условную логику на основе метаданных, тегов и свойств ресурсов
Автоматизируйте модерацию ресурсов, утверждение и рабочие процессы уведомлений
Отлаживайте существующие конфигурации автоматизации и разбирайтесь в них

Нужен доступ к другим инструментам Cloudinary?

Мы продолжаем добавлять новые возможности в эти MCP-серверы. Чтобы оставить отзыв, сообщить об ошибке или предложить новую функцию, создайте issue в этом репозитории.

Устранение неполадок

«Ответ Claude был прерван…»

Если вы видите это сообщение, вероятно, Claude достиг ограничения длины контекста и остановился на середине ответа. Чаще всего это происходит на серверах, которые запускают множество последовательных вызовов инструментов, например на сервере управления ресурсами при работе с большими списками ресурсов.

Чтобы снизить вероятность возникновения этой проблемы:

Формулируйте запросы конкретно и кратко.
Если один запрос вызывает несколько инструментов, попробуйте разбить его на несколько более коротких вызовов, чтобы ответы были короче.
Используйте параметры фильтрации, чтобы ограничить область поиска и списков ресурсов.

Проблемы с аутентификацией

Убедитесь, что учётные данные Cloudinary настроены правильно и обладают необходимыми разрешениями для выполняемых операций.

Платные функции

Для некоторых функций может потребоваться платный тариф Cloudinary. Убедитесь, что уровень подписки вашей учётной записи Cloudinary позволяет использовать нужные вам функции, например:

Расширенные возможности анализа с помощью ИИ
Высокая интенсивность использования API
Расширенные возможности преобразования

Лицензия

Лицензия MIT. Подробности см. в файле LICENSE.