Skip to content

improve: fix docs skill title, clarify mcp.json placeholders, add installation steps to README #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
yaron-reichert-cld wants to merge 2 commits into
base: main
Choose a base branch
from
Open

improve: fix docs skill title, clarify mcp.json placeholders, add installation steps to README #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2ab1df2
improve: fix docs skill title, clarify mcp.json placeholders, add ins…
yaron-reichert-cld Mar 12, 2026
db11c02
Merge branch 'main' into improve/onboarding-and-ux
ranrub Jun 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 23 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,26 @@ Two skills are included to give the agent deep Cloudinary knowledge:

## Getting Started

1. Install this plugin in Cursor/Claude Code.
2. On first use, approve the OAuth login prompt for the MCP servers. For `cloudinary-mediaflows`, add your credentials to its headers in `mcp.json`.
3. Ask your agent anything about Cloudinary — uploads, transformations, metadata, analysis, and more. The agent will automatically use the right skill and MCP server for the job.
### Cursor

1. Copy the contents of `mcp.json` into your project's `.cursor/mcp.json` (create the file if it doesn't exist).
2. Copy the `skills/` directory into your project root.
3. In `.cursor/rules/`, create one rule file per skill — each pointing to its `SKILL.md`. Cursor will use the rule description to decide when to invoke the skill.
4. For `cloudinary-mediaflows`, replace `YOUR_CLOUD_NAME`, `YOUR_API_KEY`, and `YOUR_API_SECRET` in `mcp.json` with your Cloudinary credentials (found in the [Cloudinary Console](https://console.cloudinary.com/settings/api-keys)).
5. On first use, approve the OAuth login prompt that Cursor shows for the other four MCP servers.

### Claude Code

1. Run: `claude --plugin-dir /path/to/cloudinary-plugin`
2. For `cloudinary-mediaflows`, replace the credential placeholders in `mcp.json` before starting.
3. On first use, complete the OAuth login for the other four MCP servers.

Once installed, ask your agent anything about Cloudinary — uploads, transformations, metadata, analysis, and more. The agent will automatically use the right skill and MCP server for the job.
Comment on lines +32 to +46

@sveta-slepner sveta-slepner Mar 12, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This entire section is incorrect. Both Cursor/Claude have a marketplace included, and the installation is built in inside.


### Example prompts

- "Upload this image to my Cloudinary account and resize it to 800px wide: [URL]"
- "Remove the background from my product photo and replace it with a white padded square at 1000x1000"
- "Debug this Cloudinary URL — it's not cropping correctly: [URL]"
- "How do I set up the Cloudinary Node.js SDK in my Express app?"
- "List all images in my account uploaded in the last 7 days"
6 changes: 3 additions & 3 deletions mcp.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,9 @@
"cloudinary-mediaflows": {
"url": "https://mediaflows.mcp.cloudinary.com/v2/mcp",
"headers": {
"cld-cloud-name": "cloud_name",
"cld-api-key": "api_key",
"cld-secret": "api_secret"
"cld-cloud-name": "YOUR_CLOUD_NAME",
"cld-api-key": "YOUR_API_KEY",
"cld-secret": "YOUR_API_SECRET"
}
}
}
Expand Down
2 changes: 1 addition & 1 deletion skills/cloudinary-docs/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ metadata:
version: '1.0.1'
---

# Cloudinary Documentation
# Cloudinary Documentation Skill

Helps developers integrate Cloudinary into their applications by providing documentation and code examples retrieved directly from the optimized markdown files in the Cloudinary documentation.

Expand Down