Admin MCP v2

Cotti Admin 后台 MCP：读 + 私域新品配置写操作（Playwright UI）。

工具

读 / 查

工具	说明
admin_login	强制刷新 SSO
admin_status	Session 状态
coupon_template_list / coupon_template_get	券模板（country）
activity_list / activity_get	活动
activity_get_full	活动 + 解析 landing（h5Url/longLink）
private_domain_find_reference	找最近一条【私域】新品折扣 + 参考券

写（Phase 2，Playwright UI Save）

工具	说明
coupon_copy_save	复制参考券 → 只改名称/文案/SPU → Save
activity_copy_save	复制参考活动 → 改名称/时间/挂券 → saveGeneralActivity
activity_edit_save	修改已有活动（时间/落地页）
activity_set_online	上架 / 下架

国家参数

country: ID | MY | VN | HK | MO | SG | AU（新品日历）

安装

cd mcp/admin
npm install
npx playwright install chromium

Credentials via env: ADMIN_USERNAME, ADMIN_PASSWORD (or DAVINCI_*).

Cursor 配置

{
  "mcpServers": {
    "admin": {
      "command": "node",
      "args": ["/path/to/mcp/admin/src/index.js"],
      "env": {
        "ADMIN_USERNAME": "...",
        "ADMIN_PASSWORD": "..."
      }
    }
  }
}

Skill

配套 Skill：~/.codex/skills/cotti-private-domain-rollout/

Ops 脚本

scripts/ops/ — MCP 写工具底层，也可 CLI：

COUNTRY=ID ACTIVITY_DATE=20260714 SOURCE_TEMPLATE_NO=CT20260612000001 SOURCE_ID=1203 \
PRODUCTS_JSON='[{"spuCode":"SP4680","spuName":"Blueberry & Mulberry Americano"}]' \
node scripts/ops/coupon-copy-save.js

机制

Session: ~/.admin-mcp/session.json（Playwright SSO，约 2h）

券/活动保存必须走 UI Save，裸 API 会丢字段或校验失败。