关于 mcloud-organizations
此技能介绍如何使用 mcloud CLI 列出组织并查询组织详情,面向管理 Cloud 组织的用户。内容说明了身份验证限制及 JSON 返回字段。
主要功能
- 01列出可访问的组织
- 02按 ID 获取组织详情
- 03查看成员与订阅字段
- 04以 JSON 输出结果
适用场景
- 01查找账户可访问的组织
- 02检查组织成员与订阅方案
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ medusajs/ medusa-agent-skills --skill mcloud-organizations安装后在 Claude Code 中输入/mcloud-organizations确认已加载。
详细介绍
Cloud CLI:组织命令
执行 mcloud organizations 命令以列出和获取 Cloud 组织。
限制
organizations list需要个人身份验证(浏览器登录或个人访问密钥)。组织访问密钥在执行此命令时会返回 401。- 使用组织访问密钥通过
MCLOUD_TOKEN进行身份验证时,请使用mcloud whoami --json获取组织 ID。
命令
organizations list
列出你的帐户有权访问的所有组织。
mcloud organizations list --json
选项:
--json— 以 JSON 格式输出
organizations get
按 ID 获取单个组织。返回元数据、订阅详情和成员信息。
mcloud organizations get <organization-id> --json
参数:
organization— 组织 ID(必填)
选项:
-o/--organization <id>— 覆盖当前活动上下文中的组织(必须与参数匹配)--json— 以 JSON 格式输出
组织字段(JSON)
| 字段 | 说明 |
|---|---|
id | 组织 ID |
name | 组织显示名称 |
billing_email | 账单联系邮箱 |
status | active 或其他状态 |
members | 成员对象数组,包含 id、role、user.email |
subscription | 当前方案、周期和 is_active 标志 |
account_holder | 账单帐户持有人详情 |
示例
# List all organizations
mcloud organizations list --json
# Set context to first organization
ORGANIZATION_ID=$(
mcloud organizations list --json \
| jq -r '.[0].id'
)
mcloud use --organization "$ORGANIZATION_ID"
# Find organization ID by name
ORGANIZATION_ID=$(
mcloud organizations list --json \
| jq -r '.[] | select(.name == "My Organization") | .id'
)
# Get organization details (subscription, members)
mcloud organizations get org_123 --json
# List member emails
mcloud organizations get org_123 --json \
| jq -r '.members[].user.email'
# Check subscription plan
mcloud organizations get org_123 --json \
| jq '{plan: .subscription.plan.name, status: .subscription.is_active}'
评论
支持 Markdown