Skip to main content

Cloudinary Environment Config

Connect AI tools to Cloudinary’s product environment configuration with the Cloudinary Environment Config MCP server. Use natural language to manage upload presets, upload mappings, named transformations, webhook notifications, and streaming profiles—so you can configure and tune your media pipeline without leaving your IDE or AI client.

1. Overview​

Cloudinary Environment Config is a remote, vendor-hosted MCP server provided by Cloudinary. You connect to it from Cequence AI Gateway; the server runs in the cloud and uses SSE (Server-Sent Events) for real-time communication.

  • Server URL: https://environment-config.mcp.cloudinary.com/sse
  • Transport: SSE (Server-Sent Events)
  • Hosted by: Cloudinary

It is part of Cloudinary’s MCP server suite for managing environment configuration. Use it to create or update presets, transformations, webhooks, and streaming profiles from your preferred AI client.

2. Supported authentication types​

TypeSupportedNotes
OAuth 2.0YesRequired. Uses Dynamic Client Registration (DCR); sign in with your Cloudinary account.
API keyNoNot used for this remote MCP server.

When you add Cloudinary Environment Config in Cequence AI Gateway, authentication is handled via OAuth 2.0 with Dynamic Client Registration. You sign in with your Cloudinary account and grant access during the gateway flow.

3. What can you do with this MCP server​

With the Environment Config MCP server, you can:

  • Upload presets — Create or manage upload presets (e.g. default transformations, folder, signing).
  • Upload mappings — Configure upload mappings for consistent URLs and behavior.
  • Named transformations — Define and manage named transformations (e.g. thumbnail, hero, responsive) for reuse across assets.
  • Webhook notifications — Set up or update webhooks for events (e.g. upload, moderation, transformation).
  • Streaming profiles — Manage streaming profiles for video delivery and adaptive bitrate.

This server is useful for standardizing uploads, keeping transformations in sync across environments, and automating configuration changes as part of larger media workflows.

4. Prerequisites​

Before adding Cloudinary Environment Config in Cequence AI Gateway, ensure you have:

  • Access to Cequence AI Gateway (e.g. beta.aigateway.cequence.ai)
  • A Cloudinary account with admin or configuration access to the product
  • A modern browser to complete the OAuth authorization flow
  • For OAuth authentication: an auth app with client credentials (client ID and client secret) in your Cloudinary (vendor) account, unless the server supports Dynamic Client Registration (DCR).

5. Example workflows​

  • Preset: “Create an upload preset named ‘product-images’ that uses the ‘thumbnail’ transformation and uploads to the folder ‘products’.”
  • Transformation: “List all named transformations and add a new one called ‘card’ that crops to 400x300 and sets quality to auto.”
  • Webhook: “Add a webhook that fires on upload completion and posts to our internal URL.”
  • Streaming: “Show the current streaming profiles and create a new one for mobile-optimized delivery.”
  • Multi-step: “Create an upload preset for user avatars that uses the ‘avatar’ transformation and attach a webhook for moderation.”

6. Connecting MCP server from Cequence AI Gateway​

  1. Log in to Cequence AI Gateway.
  2. Choose your tenant.
  3. Go to App catalogue.
  4. Filter by Remote MCP server.
  5. Search for Cloudinary Environment Config and then select it.
  6. Click Create MCP server.
  7. Choose auth method. If OAuth, you need an auth app with client credentials in your vendor account (see Prerequisites).
  8. Complete the setup as prompted, select tools, and deploy.

Use the generated MCP server URL in your client as described in the Client Configuration docs. For detailed UI steps and screenshots, see Create a third-party MCP Server.

7. Additional information​