Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add medusajs/medusa-agent-skills --skill mcloud-auth -a claude-code
Open on GitHub

What 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, project my-store, environment production
  • 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-code

2Manually: put the files in place

~/.claude/skills/mcloud-auth/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mcloud-auth/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →
Faable — Deploy & Auth faablecloud Faable — Deploy & Auth is an MCP server for Claude Code and Codex that ships GitHub apps and manages users through Faable Auth. CX Codex +1 ★ 1repo stars Anythink all-in-one backend: data, auth, files, workflows, payments, APIs anythink-cloud Anythink all-in-one backend: data, auth, files, workflows, payments, APIs is an MCP server for Claude Code that connects an agent to a headless backend for data, files and payments from the terminal. CX Codex +1 ★ 6repo stars auth-wechat-miniprogram TencentCloudBase auth-wechat-miniprogram — a skill that tells the agent how native auth works in CloudBase WeChat Mini Programs: openid and unionid arrive in the cloud function on their own. CX Codex +1 2,200installs auth-tool-cloudbase TencentCloudBase auth-tool-cloudbase is a Claude Code skill for configuring CloudBase auth providers and checking login readiness. It runs before a client or server auth flow when provider settings need confirmation. CX Codex +1 1,000installs Phase Two Keycloak p2-inc Phase Two Keycloak is an MCP server for automating Keycloak configurations via AI agents. It connects to the Phase Two cloud platform to manage SSO, access policies, and infrastructure. CX Codex +1 ★ 5repo stars mixpanel-auth official Mixpanel mixpanel-auth — a skill for Codex and ChatGPT that manages Mixpanel Headless authentication via auth_manager.py: checks session state, switches accounts and projects, runs OAuth login. CX Codex GP ChatGPT +1 ★ 8,052repo stars

From the same set17

The whole set →
mcloud-logs Teaches your agent to read backend and storefront logs with mcloud logs, filter them by time or deployment, and pipe them to JSON. CX Codex +1 1,600installs mcloud-projects mcloud-projects is a Claude Code skill that runs Cloud project commands through mcloud. It lists projects, looks up handles by name, retrieves details, or deletes a project. CX Codex +1 1,600installs mcloud-environments Manage mcloud environments from your agent: inspect, create, or remove them, then rerun a deployment or start a fresh build. Useful when changing environment settings or shipping committed code. CX Codex +1 1,600installs mcloud-variables An agent skill that drives mcloud variables for Medusa Cloud environments: list keys, read one, write, delete, export to .env. CX Codex +1 1,600installs mcloud-deployments mcloud-deployments is a Claude Code skill that lists deployments, checks their status, and fetches build logs. It runs when inspecting a deployment or investigating a failed build. CX Codex +1 1,600installs mcloud-local Run a Medusa Cloud build on your machine with mcloud local build. Use the skill to investigate a failed build or test build-variable changes before pushing. CX Codex +1 1,100installs creating-internal-agents creating-internal-agents — a skill for building an admin-side AI agent in Medusa: conversation models, module service, streamText() runtime, NDJSON route and a chat page. CX Codex +1 500installs medusa-dev The medusa-dev plugin gives Claude Code guidance for building Medusa backends, admin interfaces, and storefronts. Use it while adding features to a Medusa project. ★ 237repo stars

Project sponsors

Companies that keep this analytics open