mcpField
M
mcloud-auth

mcloud-auth

github.com/medusajsクラウド・DevOps234173 回インストール1 週間前に更新
リポジトリ

mcloud-auth について

mcloud-authは、Medusa Cloud CLIの認証とコンテキスト操作を説明するガイドです。CIやDockerなどの非対話環境と対話操作の両方を対象に、ログイン、認証状態と範囲の確認、組織・プロジェクト・環境の設定を扱います。

主な機能

  1. 01ブラウザーでのログインと登録
  2. 02アクセスキーによる認証
  3. 03MCLOUD_TOKENによる認証
  4. 04認証状態とアクティブコンテキストの確認
  5. 05コマンドコンテキストの設定と解除
  6. 06JSON出力オプション

活用シーン

  1. 01状態変更コマンド前の認証確認
  2. 02CIやDockerでの認証設定
  3. 03組織・プロジェクト・環境の切り替え
  4. 04現在のアカウントと操作範囲の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/medusajs/medusa-agent-skills --skill mcloud-auth

インストール後、Claude Code で/mcloud-authを入力して読み込まれたか確認します。

詳細

Cloud CLI：認証とコンテキストのコマンド

Medusa Cloud CLI の認証とコンテキストのコマンドを実行します。

制約事項

  • mcloud login、mcloud signup、および mcloud use（フラグなし）には TTY が必要です。CI、Docker、またはパイプ入力では失敗します。代わりに MCLOUD_TOKEN を使用するか、フラグを明示的に指定してください。
  • MCLOUD_TOKEN が設定されている場合、ファイルベースの認証情報は無視され、mcloud login は拒否されます。アカウントを切り替えるには、これを解除してください。
  • 状態を変更するコマンドを実行する前に、必ず認証を確認してください：mcloud whoami --json | jq -e '.auth.kind != "none"'

コマンド

whoami

認証済みユーザー、認証方式、およびアクティブなコンテキスト（組織、プロジェクト、環境）を表示します。

mcloud whoami --json

オプション：

  • --json — JSON 形式で出力します

認証とスコープの確認に使用：

mcloud whoami --json | jq -e '.auth.kind != "none" and .organization.id != null'

終了コード 0 = 認証済みでスコープが設定されています。ゼロ以外 = 停止してユーザーに確認してください。

use

アクティブな組織、プロジェクト、および／または環境を設定し、以降のコマンドでこれらのフラグを省略できるようにします。

mcloud use \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --environment <environment-handle>

重要： フラグなしの mcloud use は対話型であり、CI、Docker、またはパイプ入力では失敗します。必ずフラグを明示的に指定してください。

オプション：

  • -o/--organization <id> — アクティブな組織を設定します
  • -p/--project <id-or-handle> — アクティブなプロジェクトを設定します
  • -e/--environment <handle> — アクティブな環境を設定します
  • --clear — すべてのアクティブなコンテキストをクリアします
  • --json — JSON 形式で出力します

コンテキストをクリア：

mcloud use --clear
version

CLI のバージョンとプラットフォームのメタデータを表示します。

mcloud version --json

オプション：

  • --json — JSON 形式で出力します
login

Medusa Cloud で認証します。認証を完了するため、ブラウザーが開きます。

TTY が必要です。 CI、Docker、または非対話型環境では実行できません。非対話型の認証には、代わりに MCLOUD_TOKEN を使用してください。

mcloud login

非対話型の代替方法：

export MCLOUD_TOKEN=<access-key>

オプション：

  • -t/--token <token> — ブラウザーを使わずにアクセストークンで認証します（非対話型）
  • --json — JSON 形式で出力します
logout

保存されている認証情報を削除します。

mcloud logout --json

オプション：

  • --json — JSON 形式で出力します
signup

新しい Medusa Cloud アカウントを作成します。ブラウザーが開きます。

TTY が必要です。 非対話型環境では実行できません。

mcloud signup

認証方式

方式使用場面
mcloud login（ブラウザー）対話型のセットアップ。TTY が必要です
mcloud login --token <key>アクセストークンを使った非対話型ログイン
MCLOUD_TOKEN=<key> 環境変数CI/CD、Docker、スクリプト実行環境

例

# Check authentication and active context
mcloud whoami --json

# Verify auth before running commands
mcloud whoami --json | jq -e '.auth.kind != "none" and .organization.id != null'

# Set full context (org + project + environment)
mcloud use \
  --organization org_123 \
  --project my-store \
  --environment production

# Set context by resolving names
ORGANIZATION_ID=$(mcloud organizations list --json | jq -r '.[] | select(.name == "My Org") | .id')
PROJECT_HANDLE=$(mcloud projects list --organization "$ORGANIZATION_ID" --json | jq -r '.[] | select(.name == "My Store") | .handle')
ENVIRONMENT_HANDLE=$(mcloud environments list --organization "$ORGANIZATION_ID" --project "$PROJECT_HANDLE" --json | jq -r '.[] | select(.name == "Production") | .handle')

mcloud use \
  --organization "$ORGANIZATION_ID" \
  --project "$PROJECT_HANDLE" \
  --environment "$ENVIRONMENT_HANDLE"

# Clear context
mcloud use --clear

# Check CLI version
mcloud version --json

# Non-interactive login with token
mcloud login --token <access-key>

# Logout
mcloud logout

コメント

Markdown 対応