用 HuaweiCloud DevKit MCP 一键领取华为开发者大赛代金券实战

本文记录一次真实可复现的操作：借助华为云 CodeArts 代码智能体内置的 HuaweiCloud DevKit MCP 工具集，在终端对话里用几条命令完成「安装 KooCLI → 配置访问密钥 → 领取华为开发者大赛·小红书 Skill 创新赛专属代金券」全流程，最终成功领取一张 ¥200 华为云代金券。全程无需打开控制台网页，适合想快速薅赛事羊毛、又想顺手把云开发环境配好的同学。

一、背景：开发者大赛代金券与 DevKit

华为开发者大赛·小红书 Skill 创新赛为参赛者准备了华为云代金券福利，可用于抵扣云资源消费。传统领取方式往往要在控制台多个页面间跳转，而 HuaweiCloud DevKit 把这套能力封装成了一组 MCP（Model Context Protocol）工具，任何接入了该 MCP 的智能体（如 CodeArts 代码智能体、Codex、OpenCode 等）都能直接调用，做到「一句话领券」。

DevKit 工具集里与本次任务相关的几个关键工具：

需要先说明：huaweicloud_competition_voucher_claim 的前置条件是用户已完成该赛事报名，未报名会返回 code=HDKIT_NOT_SIGNED_UP。所以请先去赛事页面报名，再按本文操作。

二、整体流程

① 安装 DevKit 插件 + KooCLI(hcloud)
        ↓
② 在控制台创建访问密钥(AK/SK)
        ↓
③ 用 auth_init 安全配置运行时凭据
        ↓
④ 调用 competition_voucher_claim 领取赛事代金券
        ↓
⑤ check_cli / voucher_status 验证结果

三、环境准备：安装 DevKit 插件与 KooCLI

3.1 一行命令安装 KooCLI

DevKit 插件本身通过 npx 即装即用，它依赖的命令行工具 KooCLI（hcloud） 可由插件自动安装：

npx huaweicloud-devkit install-hcloud

在 Linux 上会自动下载并解压到 ~/.local/bin/hcloud，macOS 落到 /usr/local/bin，Windows 落到 ~/hcloud。

坑点提示：较新的 DevKit 依赖 Node 内置的 node:sqlite 模块。Node 22.13 之前版本默认不开启该模块，直接跑会报 No such built-in module: node:sqlite。解决办法是加一个环境变量前缀：

NODE_OPTIONS="--experimental-sqlite" npx huaweicloud-devkit install-hcloud

推荐升级到 Node 22.13+ 或 23+ 一劳永逸。

安装成功的输出长这样：

╔══════════════════════════════════════════════╗
║     HuaweiCloud DevKit v1.1.8                 ║
║     https://github.com/huaweicloud            ║
╚══════════════════════════════════════════════╝
Installing KooCLI (hcloud)...
[Linux] Auto-installing to /root/.local/bin...
  Downloading https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/7.2.12/huaweicloud-cli-linux-arm64.tar.gz...
  Extracting...
  Installing...
Install complete.

3.2 首次运行接受隐私协议

KooCLI 首次运行会要求同意隐私协议，非交互会话里直接 hcloud version 会因拿不到输入而报 Invalid character。用管道喂一个 y 即可：

echo "y" | hcloud version

输出：

Run `hcloud update` to upgrade KooCLI to the latest version (7.3.12).
Current KooCLI version: 7.2.12

3.3 验证安装

调用 huaweicloud_check_cli，理想结果：

{
  "installed": true,
  "authenticated": true,
  "status": "ok",
  "kooCliVersion": "7.2.12",
  "versionMismatch": false
}

installed: true 且 versionMismatch: false 即代表 KooCLI 就位。

四、配置访问密钥（AK/SK）

4.1 在控制台创建访问密钥

AK/SK 不是「下载」来的，而是创建后下载：

1. 登录华为云控制台 https://console.huaweicloud.com
2. 右上角用户名 → 我的凭证 → 左侧 访问密钥
3. 点击 新增访问密钥（每账号最多 2 组）
4. 按提示下载 CSV，内含 Access Key Id 与 Secret Access Key

⚠️ Secret Access Key 仅创建时显示一次，关闭窗口后无法再查看，务必及时下载保存。AK/SK 等同于账号凭据，切勿提交到代码仓库或贴到公开聊天。

4.2 用 auth_init 安全配置运行时凭据

千万不要用 hcloud configure set --cli-access-key=xxx 这种方式——AK/SK 会留在 shell history 里。DevKit 提供了更安全的 huaweicloud_auth_init，把凭据仅保存在当前 MCP 会话内存中：

调用 huaweicloud_auth_init
  ak = HPUA****************************   ← 你的 Access Key Id
  sk = ********************************   ← 你的 Secret Access Key

返回：

{ "status": "ok", "message": "Runtime credentials set for this MCP session." }

运行时凭据优先级最高，覆盖环境变量与配置文件，且重启会话即失效，安全又方便。

五、领取华为开发者大赛·小红书 Skill 创新赛代金券

凭据就位后，直接调用赛事专属领券工具：

调用 huaweicloud_competition_voucher_claim

返回：

{
  "claimed": true,
  "voucherId": "CP26XXXXXXX",
  "amount": 200,
  "message": "领取成功"
}

搞定——一张 ¥200 华为云代金券到手。重复调用会返回「已领取」，不会重复发券。

六、状态验证与常见问题

6.1 一组验证工具

• huaweicloud_auth_status：统一查看凭据库、OBS、KooCLI、各 Agent MCP 注册状态，只返回脱敏信息。
• huaweicloud_voucher_status：查询通用代金券领取状态（与赛事券独立）。

注意区分：competition_voucher_claim 领的是赛事专属券，voucher_claim 领的是通用券（一人一次）。两者互不影响。

6.2 常见问题速查

6.3 一个真实遇到的额度限制

笔者在领完赛事券后顺手去领通用券，结果：

{
  "claimed": false,
  "message": "本月代金券总额度已用完，所有账号均无法领取，请下月再重试"
}

可见通用代金券有全局月度额度，赛事专属券则独立核算、不受此限——这也是本次走 competition_voucher_claim 的好处。

七、小结

整件事下来，真正干活的就三条调用：

1. install-hcloud 装好 KooCLI
2. auth_init 喂入 AK/SK
3. competition_voucher_claim 领券

从「想领券」到「¥200 到账」，不开控制台、不点网页，在终端对话里一气呵成。HuaweiCloud DevKit 把云账号、凭据、资源操作都收敛进 MCP 工具集，既保证了安全性（凭据不落 shell history、脱敏返回），又让智能体能直接「动手」而非只给步骤。对于参赛选手，这是把赛事福利和云开发环境一次性配齐的最短路径。

安全收尾建议：领券完成后，若本次 AK/SK 曾在不可控环境明文出现，建议到控制台「访问密钥」页将该密钥删除并重新创建，避免被他人盗用产生费用。