如何通过 MCP 将 Cloudinary 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录后打开 Connectors → Cloudinary 并安装，点击 Authorize with Provider 并在 Cloudinary 中批准，然后生成 MCP API key。无 Docker、无 git clone、无本地服务器。

Cloudinary + Gemini

通过 Cloudinary 官方 MCP 服务器，在 Claude、ChatGPT 或 Copilot 中把图片和视频上传到 Cloudinary 并获取公开 URL，搜索和整理你的媒体库，生成 AI 图片并创建变换。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

(无：安装后使用 Cloudinary 登录即可)

步骤 1 — 使用 Cloudinary 登录

Cloudinary 为媒体库运营着自己的官方远程 MCP 服务器，即位于 https://asset-management.mcp.cloudinary.com/mcp 的 Asset Management MCP server。此连接器把它桥接进来：工具来自 Cloudinary，AnythingMCP 把它们放在你的 AnythingMCP 服务器之后，并提供面向 Claude 和 ChatGPT 的 OAuth、按工具划分的角色和审计日志。

1. 安装连接器。无需粘贴任何内容：不需要 API 密钥、客户端 ID 或客户端密钥。
2. 在连接器页面点击 Authorize with Provider。AnythingMCP 会在 Cloudinary 注册，并把你带到 Cloudinary 登录页。无需配置重定向 URI。
3. 登录，选择 AI 要使用的产品环境（cloud），然后批准。回到 AnythingMCP 后，工具列表会从 Cloudinary 的服务器重新加载。Cloudinary 会陆续添加工具：在连接器上点击 Discover tools 可以获取新工具。
4. 要确认连接正常，运行 cloudinary_get_usage_details。它会显示相对于你套餐的额度、存储和带宽用量。

用途：很多 API 只接受公开 URL 形式的文件，例如在 Instagram 和 Facebook 上发布内容。cloudinary_upload_asset 接受公开 URL、Base64 data URI，或 S3、Google Cloud Storage 中的私有路径，并返回 secure_url，一个任何人都能获取的 HTTPS 链接。Instagram 需要 JPEG，因此给它用的链接使用 f_jpg 而不是 f_auto。

用的是谁的权限：登录的人就是所有使用此连接器的人的 Cloudinary 用户，作用于登录时选择的产品环境。如果连接器是共用的，请用一个角色只涵盖 AI 应做之事的 Cloudinary 用户登录。要切换环境，请再次点击 Authorize with Provider 并选择另一个环境。

默认公开：以默认交付类型 upload 上传的文件，任何拿到其 URL 的人都能访问。机密文件请把 type 设为 authenticated 或 private，或者使用 access_control；这样的链接需要签名，对按 URL 获取文件的 API 没有用处。

安装时默认关闭：cloudinary_delete_asset、cloudinary_delete_derived_assets、cloudinary_delete_folder 和 cloudinary_delete_asset_relations。上传、重命名以及标签和元数据的修改保持开启。cloudinary_asset_rename 会改变资源的 URL，因此已经分享出去的链接会失效。

套餐：Cloudinary 免费套餐即可使用。AI 图片（cloudinary_generate_image、cloudinary_generate_image_from_images）需要 Image Generation 附加组件，并会消耗额度。AI 无法读取你电脑上的文件；cloudinary_sign_upload 会返回签名参数，用于把这类文件直接发送到 Cloudinary。

不登录的方式：Cloudinary 的服务器也接受 API 密钥。在连接器设置中把认证方式切换为 API key，将请求头名称设为 cloudinary-url，然后粘贴 Cloudinary Console 中 Settings、API Keys 下 API environment variable 的值（cloudinary://<api_key>:<api_secret>@<cloud_name>）。

Cloudinary 的其他 MCP 服务器（用于环境配置，如上传预设、命名变换和 Webhook，以及结构化元数据和媒体分析）不属于此连接器；如有需要，请将它们添加为自定义 MCP 连接器。

步骤 2 — 安装 adapter

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 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

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

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Cloudinary 的工具。

可用工具

示例提示

• “把这个链接里的产品照片上传到 products/2026 文件夹，打上 summer 标签，然后把公开 URL 给我。”
• “找出上周上传的所有带 summer 标签的图片，列出它们的 public ID 和文件大小。”
• “我们的 Cloudinary 套餐到目前为止用了多少额度、存储和带宽？”
• “为 Instagram 把我们最新的主横幅做成 1080 x 1080 的方形 JPEG 链接，在我发布之前先给我看看。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT