Как подключить Cloudinary к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, откройте Connectors → Cloudinary, установите коннектор, нажмите Authorize with Provider и подтвердите доступ в Cloudinary, затем создайте MCP API key. Без Docker, без git clone, без локального сервера.

Cloudinary + Gemini

Загружайте изображения и видео в Cloudinary и получайте публичный URL, ищите и упорядочивайте медиатеку, генерируйте изображения с помощью ИИ и создавайте трансформации из Claude, ChatGPT или Copilot через официальный MCP-сервер Cloudinary.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

(нет: после установки вы входите через Cloudinary)

Шаг 1 — Войдите через Cloudinary

Cloudinary поддерживает собственный официальный удалённый MCP-сервер для медиатеки, Asset Management MCP server, по адресу https://asset-management.mcp.cloudinary.com/mcp. Этот коннектор подключает его: инструменты предоставляет Cloudinary, а AnythingMCP размещает их за вашим сервером AnythingMCP с OAuth для Claude и ChatGPT, ролями для каждого инструмента и журналом аудита.

1. Установите коннектор. Вставлять ничего не нужно: ни API-ключа, ни client ID, ни secret.
2. На странице коннектора нажмите Authorize with Provider. AnythingMCP регистрируется в Cloudinary и перенаправляет вас на страницу входа Cloudinary. Настраивать redirect URI не нужно.
3. Войдите, выберите product environment (cloud), с которым должен работать ИИ, и подтвердите доступ. После возврата в AnythingMCP список инструментов заново загружается с сервера Cloudinary. Cloudinary со временем добавляет инструменты: кнопка Discover tools на странице коннектора подтягивает новые.
4. Чтобы проверить работу, запустите cloudinary_get_usage_details. Он показывает кредиты, хранилище и трафик относительно вашего тарифа.

Для чего он нужен: многие API принимают файл только по публичному URL, например при публикации в Instagram и Facebook. cloudinary_upload_asset принимает публичный URL, data URI в Base64 или приватный путь в S3 или Google Cloud Storage и возвращает secure_url, HTTPS-ссылку, которую может открыть кто угодно. Instagram требует JPEG, поэтому ссылки для него используют f_jpg вместо f_auto.

Чей это доступ: тот, кто входит, становится пользователем Cloudinary для всех, кто пользуется этим коннектором, в product environment, выбранном при входе. Для общего коннектора входите под пользователем Cloudinary, роль которого покрывает только то, что должен делать ИИ. Чтобы сменить environment, снова нажмите Authorize with Provider и выберите другой.

Публично по умолчанию: файл, загруженный со стандартным delivery type upload, доступен любому, у кого есть его URL. Для конфиденциальных файлов задайте для type значение authenticated или private либо используйте access_control; такие ссылки требуют подписи и бесполезны для API, которые получают файлы по URL.

Отключены при установке: cloudinary_delete_asset, cloudinary_delete_derived_assets, cloudinary_delete_folder и cloudinary_delete_asset_relations. Загрузка, переименование и изменение тегов и метаданных остаются включены. cloudinary_asset_rename меняет URL ассета, поэтому уже отправленные ссылки перестают работать.

Тариф: бесплатного тарифа Cloudinary достаточно. Для ИИ-изображений (cloudinary_generate_image, cloudinary_generate_image_from_images) нужно дополнение Image Generation, и они расходуют кредиты. ИИ не может читать файлы на вашем компьютере; cloudinary_sign_upload возвращает подписанные параметры, чтобы отправить такой файл напрямую в Cloudinary.

Без входа: сервер Cloudinary также принимает API-ключ. В настройках коннектора переключите аутентификацию на API key, укажите имя заголовка cloudinary-url и вставьте значение API environment variable из Settings, API Keys в Cloudinary Console (cloudinary://<api_key>:<api_secret>@<cloud_name>).

Другие MCP-серверы Cloudinary, для настройки окружения (upload presets, именованные трансформации, вебхуки), структурированных метаданных и анализа медиа, не входят в этот коннектор; при необходимости добавьте их как пользовательские MCP-коннекторы.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Cloudinary.

Доступные инструменты

Примеры запросов

• «Загрузите фото товара по этой ссылке в папку products/2026, добавьте тег summer и дайте мне публичный URL.»
• «Найдите все изображения с тегом summer, загруженные за последнюю неделю, и перечислите их public ID и размеры файлов.»
• «Сколько кредитов, хранилища и трафика из нашего тарифа Cloudinary мы уже израсходовали?»
• «Сделайте квадратную JPEG-ссылку 1080 на 1080 нашего последнего главного баннера для Instagram и покажите её мне, прежде чем я опубликую пост.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT