# Cloudinary Structured Metadata

MCP-сервер Cloudinary Structured Metadata для Claude Code управляет структурированными метаданными Cloudinary. Он подключается к задачам с полями метаданных, их источниками значений и правилами для ресурсов.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: cloudinary
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cloudinary/structured-metadata-mcp
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/cloudinary-structured-metadata

## Что делает

Сервер открывает агенту инструменты Cloudinary Structured Metadata API: с их помощью можно просматривать, создавать, менять и удалять поля метаданных и правила. Он также работает с источниками значений полей, включая поиск и восстановление удалённых записей.

Для доступа нужны имя облака Cloudinary, API-ключ и API-секрет; вместо отдельных значений можно задать `CLOUDINARY_URL`. Локальный запуск требует Node.js 20.19.0 или новее. В Claude Code сервер можно добавить через удалённый HTTP-адрес или запустить через `npx` по протоколу stdio.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://structured-metadata.mcp.cloudinary.com/mcp`
- Переменные окружения: `CLOUDINARY_CLOUD_NAME`, `CLOUDINARY_API_KEY`, `CLOUDINARY_API_SECRET` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http structured-metadata-mcp https://structured-metadata.mcp.cloudinary.com/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env CLOUDINARY_CLOUD_NAME=<CLOUDINARY_CLOUD_NAME> --env CLOUDINARY_API_KEY=<CLOUDINARY_API_KEY> --env CLOUDINARY_API_SECRET=<CLOUDINARY_API_SECRET> --transport stdio cloudinary-structured-metadata -- npx -y @cloudinary/structured-metadata-mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add cloudinary-structured-metadata --url https://structured-metadata.mcp.cloudinary.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add cloudinary-structured-metadata --env CLOUDINARY_CLOUD_NAME=<CLOUDINARY_CLOUD_NAME> --env CLOUDINARY_API_KEY=<CLOUDINARY_API_KEY> --env CLOUDINARY_API_SECRET=<CLOUDINARY_API_SECRET> -- npx -y @cloudinary/structured-metadata-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cloudinary-structured-metadata": {
            "url": "https://structured-metadata.mcp.cloudinary.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cloudinary-structured-metadata": {
            "command": "npx",
            "args": [
                "-y",
                "@cloudinary/structured-metadata-mcp"
            ],
            "env": {
                "CLOUDINARY_CLOUD_NAME": "<CLOUDINARY_CLOUD_NAME>",
                "CLOUDINARY_API_KEY": "<CLOUDINARY_API_KEY>",
                "CLOUDINARY_API_SECRET": "<CLOUDINARY_API_SECRET>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "cloudinary-structured-metadata": {
            "type": "http",
            "url": "https://structured-metadata.mcp.cloudinary.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "cloudinary-structured-metadata": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@cloudinary/structured-metadata-mcp"
            ],
            "env": {
                "CLOUDINARY_CLOUD_NAME": "<CLOUDINARY_CLOUD_NAME>",
                "CLOUDINARY_API_KEY": "<CLOUDINARY_API_KEY>",
                "CLOUDINARY_API_SECRET": "<CLOUDINARY_API_SECRET>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http cloudinary-structured-metadata https://structured-metadata.mcp.cloudinary.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e CLOUDINARY_CLOUD_NAME=<CLOUDINARY_CLOUD_NAME> -e CLOUDINARY_API_KEY=<CLOUDINARY_API_KEY> -e CLOUDINARY_API_SECRET=<CLOUDINARY_API_SECRET> cloudinary-structured-metadata npx -y @cloudinary/structured-metadata-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- просмотреть поля метаданных в аккаунте Cloudinary
- создать поле с перечислением допустимых значений
- изменить источник значений поля
- настроить правило для автоматической маркировки ресурсов

## Примеры запросов агенту
- Покажи поля метаданных в моём аккаунте Cloudinary.
- Добавь значение `enterprise` в источник поля `category`.
- Создай правило, которое присваивает ресурсам из папки `products` категорию `product`.

## Похожие
- [cloudinary-docs](https://affpapa.org/nevibecode/skills/cloudinary-docs.md) — скилл · 1100 установок
- [cloudinary-transformations](https://affpapa.org/nevibecode/skills/cloudinary-transformations.md) — скилл · 906 установок
- [Web Search — Structured Results for AI Agents](https://affpapa.org/nevibecode/mcp/web-search-structured-results-for-ai-agents.md) — MCP-сервер · 4334 установки
- [Structured Output MCP Agent](https://affpapa.org/nevibecode/mcp/structured-output-mcp-agent.md) — MCP-сервер · 3042 установки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
