mcloud-auth — Claude Code skill: what it does, how to install
mcloud-auth — a skill for Medusa Cloud CLI authentication and context commands: login, logout, status checks, switching organizations and projects.
no license 429 installs ★ 237 updated 2026-10-21
npx skills add medusajs/medusa-agent-skills --skill mcloud-auth -a claude-codeWhat mcloud-auth does
Executes mcloud login, logout, whoami, use, version, and signup via terminal. Checks whether the user is authenticated, which organization and project are active, switches context between environments. Before any operation the skill calls mcloud whoami --json | jq -e '.auth.kind != "none"' to verify authentication.
Interactive commands (mcloud login without flags, mcloud use without arguments) require a TTY and fail in CI, Docker, or piped input. For non-interactive login the skill uses MCLOUD_TOKEN or the --token flag. When the MCLOUD_TOKEN environment variable is set, file-based credentials are ignored — to switch accounts unset it.
The skill relies on jq to parse JSON responses and build context-checking scripts. Without jq installed status verification scripts will not run.
What it helps with
- verify Medusa Cloud authentication status before running commands
- switch active organization, project or environment in the CLI
- log in via token in CI or Docker without opening a browser
- retrieve CLI version and platform metadata
- clear saved context and log out of the account
Example prompts for the agent
- Check if I'm logged into Medusa Cloud
- Switch context to organization
org_123, projectmy-store, environmentproduction - Log out of Medusa Cloud
How to install mcloud-auth
1Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-auth -a claude-code2Manually: put the files in place
~/.claude/skills/mcloud-auth/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mcloud-auth/
1Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-auth -a codex2Manually: put the files in place
.agents/skills/mcloud-auth/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-auth -a cursor2Manually: put the files in place
.cursor/skills/mcloud-auth/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install medusajs/medusa-agent-skills plugins/medusa-cloud/skills/mcloud-auth2Manually: put the files in place
.github/skills/mcloud-auth/SKILL.md1Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-auth -a gemini-cli2Platform CLI
gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/medusa-cloud/skills/mcloud-authManually: put the files in place
.devin/skills/mcloud-auth/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-auth -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mcloud-auth
How to install mcloud-auth in Claude Code?
Run npx skills add medusajs/medusa-agent-skills --skill mcloud-auth -a claude-code, then check the file ~/.claude/skills/mcloud-auth/SKILL.md.
What does the mcloud-auth skill do?
Runs Medusa Cloud CLI authentication and context management commands: login, logout, status checks, switching organizations, projects and environments.
Why does mcloud login fail in Docker?
The command requires a TTY to open a browser. In non-interactive environments use MCLOUD_TOKEN or the --token flag.