Cloudinary

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

Servidores MCP de Cloudinary

El Protocolo de Contexto de Modelos (MCP) es un protocolo nuevo y estandarizado para gestionar el contexto entre modelos de lenguaje grandes (LLM) y sistemas externos. Este repositorio proporciona servidores MCP completos para la plataforma de gestión de medios de Cloudinary, lo que le permite usar lenguaje natural para subir, transformar, analizar y organizar sus activos de medios directamente desde aplicaciones de IA como Cursor y Claude.

Con estos servidores MCP, puede gestionar sin problemas todo su flujo de trabajo de medios mediante IA conversacional, desde la subida y transformación de imágenes y vídeos, hasta la configuración de canalizaciones de procesamiento automatizadas, el análisis de contenido con herramientas impulsadas por IA y la organización de activos con metadatos estructurados. Tanto si está creando aplicaciones ricas en medios, gestionando grandes bibliotecas de activos o automatizando flujos de trabajo de contenido, estos servidores le proporcionan acceso directo al conjunto completo de capacidades de optimización y gestión de medios de Cloudinary.

Los siguientes servidores MCP están disponibles para Cloudinary:

Nombre del servidor	Descripción	Servidor MCP remoto
Gestión de activos	Suba, gestione y transforme sus activos de medios con capacidades avanzadas de búsqueda y organización	asset-management
Configuración del entorno	Configure y gestione los ajustes de entorno de Cloudinary, los ajustes preestablecidos de subida y las transformaciones	environment-config
Metadatos estructurados	Cree, gestione y consulte campos de metadatos estructurados para mejorar la organización y la capacidad de búsqueda de activos	structured-metadata
Análisis	Aproveche las capacidades de análisis de contenido, moderación y etiquetado automático impulsadas por IA para sus activos de medios	analysis
MediaFlows	Cree y gestione automatizaciones de flujos de trabajo de código bajo para imágenes y vídeos con asistencia impulsada por IA	mediaflows

Tabla de contenido

• Documentación
• Instalación
  • Servidores MCP remotos (recomendado)
  • Servidores MCP locales
  • Imágenes de Docker
• Ejemplos de configuración
  • Configuración avanzada del servidor local
• Autenticación
• Funciones por servidor
• ¿Necesita acceso a más herramientas de Cloudinary?
• Solución de problemas
• Funciones de pago
• Licencia

Documentación

Para obtener guías detalladas, tutoriales y documentación completa sobre el uso de los servidores MCP de Cloudinary:

• Documentación de herramientas MCP y LLM de Cloudinary - Guía completa para integrar Cloudinary con aplicaciones de IA/LLM
• Documentación de MCP de MediaFlows - Instrucciones de configuración y pautas para usar el servidor MediaFlows (MCP)

Instalación

Servidores MCP remotos (recomendado)

Los servidores MCP remotos están alojados por Cloudinary y listos para usar de inmediato. No se requiere instalación local.

Servidores MCP locales

Los servidores MCP locales se ejecutan en su máquina mediante paquetes npm. Elija esta opción si necesita más control o personalización.

Nota: Deberá configurar sus variables de entorno (CLOUDINARY_CLOUD_NAME, CLOUDINARY_API_KEY, CLOUDINARY_API_SECRET) con sus credenciales reales después de la instalación.

Imágenes de Docker

Las imágenes oficiales de Docker para los servidores MCP de Cloudinary están disponibles en Docker Hub, lo que proporciona una opción de implementación contenerizada para ejecutar servidores MCP localmente o en entornos de nube.

Disponibles en Docker Hub: Imágenes de Docker MCP de Cloudinary

Las imágenes de Docker ofrecen varios beneficios:

• Entornos aislados - Ejecute servidores MCP en contenedores sin afectar las dependencias de su sistema
• Implementación sencilla - Configuración rápida con requisitos mínimos de configuración
• Entorno de ejecución consistente - Garantiza el mismo entorno en diferentes máquinas y plataformas
• Escalabilidad - Implemente fácilmente múltiples instancias o intégrelas en sistemas de orquestación de contenedores

Para usar las imágenes de Docker, asegúrese de tener Docker instalado en su sistema y pase sus credenciales de Cloudinary como variables de entorno al ejecutar los contenedores. Consulte la documentación individual de cada imagen de Docker en Docker Hub para obtener instrucciones de uso específicas.

Ejemplos de configuración

Configuración de servidores MCP remotos

Los servidores remotos están alojados por Cloudinary y se accede a ellos mediante 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/sse"
    },
    "mediaflows": {
      "url": "https://mediaflows.mcp.cloudinary.com/v2/mcp"
    }
  }
}

Transporte: Los servidores remotos admiten dos endpoints: /mcp (HTTP Streamable, recomendado, sin estado) y /sse (SSE, obsoleto, mantenido por compatibilidad con versiones anteriores). El endpoint /sse también acepta solicitudes POST como alias de /mcp, por lo que los clientes que envían HTTP Streamable a /sse funcionarán. Use /mcp para configuraciones nuevas.

Servidores MCP remotos con autenticación

Los servidores MCP remotos alojados por Cloudinary usan OAuth2 de forma predeterminada para la autenticación. También puede autenticarse mediante claves de API a través de encabezados:

Usando CLOUDINARY_URL (lo más sencillo)

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

Usando encabezados individuales

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

Con configuración personalizada

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

Con encabezados de depuración

Para mostrar los encabezados de límite de velocidad de la API y los ID de solicitud en los resultados de las herramientas, habilite la incrustación de encabezados:

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

Cada resultado de herramienta incluirá un campo _headers con información de límite de velocidad y seguimiento de solicitudes:

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

Configuración de servidores MCP locales

Los servidores locales se ejecutan en su máquina mediante paquetes npm:

Opción 1: Usando la variable de entorno CLOUDINARY_URL (recomendado)

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

Opción 2: Usando variables de entorno individuales

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

Opción 3: Usando argumentos de línea de comandos

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

Configuración del servidor MCP de MediaFlows

Para MediaFlows, use la siguiente configuració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"
      }
    }
  }
}

Configuración avanzada del servidor local

Cada paquete npm admite opciones de configuración adicionales más allá de los ejemplos de configuración básica anteriores.

Ejecución como servidor SSE

Para ejecutar un servidor MCP local usando el transporte de Eventos Enviados por el Servidor (SSE) en lugar de stdio:

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

Puede especificar un puerto personalizado (el valor predeterminado es 2718):

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

Opciones de configuración disponibles

Para ver todas las opciones de configuración disponibles para cualquier paquete:

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

Lista completa de indicadores disponibles:

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

Depuración

Para una depuración detallada de la carga útil de red, use la variable de entorno CLOUDINARY_DEBUG:

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

Puede combinar el modo de depuración con otras opciones para una solución de problemas integral:

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

Nota: Estas opciones de configuración se aplican a todos los paquetes MCP locales:

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

Autenticación

Al ejecutar servidores MCP localmente, la autenticación se puede configurar de varias maneras:

Opción 1: Variables de entorno individuales (recomendado)

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

Opción 2: Variable de entorno CLOUDINARY_URL

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

Opción 3: Argumentos de línea de comandos

Pase las credenciales directamente como argumentos (consulte los ejemplos de configuración anteriores)

Puede encontrar sus credenciales de Cloudinary en su Panel de la consola de Cloudinary en Configuración > Seguridad.

Funciones por servidor

Servidor de gestión de activos

• Suba y gestione activos de medios (imágenes, vídeos, archivos sin procesar)
• Busque y organice activos con capacidades avanzadas de filtrado
• Gestione operaciones y transformaciones de activos
• Gestione carpetas, etiquetas y relaciones entre activos
• Genere archivos y enlaces de descarga

Servidor de configuración del entorno

• Configure ajustes preestablecidos de subida y ajustes de transformación
• Gestione perfiles de streaming y notificaciones de webhook
• Configure asignaciones de subida

Servidor de metadatos estructurados

• Cree y gestione campos de metadatos estructurados
• Configure reglas de metadatos condicionales y validación
• Organice y busque configuraciones de metadatos
• Gestione relaciones y orden de campos de metadatos

Servidor de análisis

• Análisis de contenido impulsado por IA, incluido etiquetado, moderación y subtitulado
• Detección y reconocimiento de objetos con múltiples modelos de IA
• Análisis de calidad de imagen y detección de marcas de agua
• Moderación de contenido y análisis de seguridad
• Capacidades de detección de moda, texto y anatomía

Servidor de MediaFlows

• Cree y gestione automatizaciones de flujos de trabajo usando lenguaje natural
• Consulte las automatizaciones PowerFlow existentes en su entorno
• Cree lógica condicional basada en metadatos, etiquetas y propiedades de activos
• Automatice flujos de trabajo de moderación, aprobación y notificación de activos
• Depure y comprenda las configuraciones de automatización existentes

¿Necesita acceso a más herramientas de Cloudinary?

Seguimos añadiendo más funcionalidades a estos servidores MCP. Si desea dejar comentarios, informar de un error o proporcionar una solicitud de función, abra un issue en este repositorio.

Solución de problemas

"La respuesta de Claude se interrumpió..."

Si ve este mensaje, es probable que Claude haya alcanzado su límite de longitud de contexto y se haya detenido a mitad de la respuesta. Esto ocurre con mayor frecuencia en servidores que activan muchas llamadas de herramientas encadenadas, como el servidor de gestión de activos con listados de activos grandes.

Para reducir la probabilidad de encontrarse con este problema:

• Intente ser específico y mantenga sus consultas concisas.
• Si una sola solicitud llama a varias herramientas, intente dividirla en varias llamadas de herramientas más pequeñas para mantener las respuestas breves.
• Use parámetros de filtrado para limitar el alcance de las búsquedas y listados de activos.

Problemas de autenticación

Asegúrese de que sus credenciales de Cloudinary estén configuradas correctamente y tengan los permisos necesarios para las operaciones que intenta realizar.

Funciones de pago

Algunas funciones pueden requerir un plan de pago de Cloudinary. Asegúrese de que su cuenta de Cloudinary tenga el nivel de suscripción necesario para las funciones que pretende usar, como:

• Funciones avanzadas de análisis de IA
• Uso de API de alto volumen
• Capacidades avanzadas de transformación

Licencia

Licenciado bajo la Licencia MIT. Consulte el archivo LICENSE para obtener más detalles.