Motivation MoneyCLI 命令行工具
安装和配置 Motivation Money 命令行界面。
Motivation Money CLI (mp) 提供对薪资发放批次、团队管理、资金库、审计日志和 Webhook 的终端访问。专为偏好命令行的运营人员和通过 Shell 执行操作的 AI 智能体设计。
安装
npm install -g @motivation-money/cli此命令全局安装 mp 命令。
认证
使用 Motivation Money 仪表盘中的 API 密钥（设置 > API 密钥）进行认证：
mp auth login --key mpk_live_<your-key>凭证存储在 ~/.mp/credentials.json，文件权限受限（模式 0600）。CLI 使用与 REST API 相同的 API 密钥作用域。
检查认证状态：
mp auth status注销（清除已存储的凭证）：
mp auth logout配置
查看当前配置：
mp config设置 API 基础 URL（适用于自托管或预发布环境）：
mp config --set-url https://your-instance.example.com/api/v1设置默认输出格式：
mp config --set-format json配置存储在 ~/.mp/config.json。默认基础 URL 为 https://motivation-money.vercel.app/api/v1。
输出格式
每个命令通过 -f, --format 支持三种输出格式：
| 格式 | 描述 |
|---|---|
table | 人类可读的 ASCII 表格（终端默认） |
json | 结构化 JSON（管道传输时默认） |
csv | 逗号分隔值 |
CLI 自动检测管道输出并切换为 JSON，因此 mp runs list | jq '.data[0]' 等命令无需额外标志即可工作。
全局选项
| 选项 | 描述 |
|---|---|
--base-url <url> | 为单次命令覆盖 API 基础 URL |
-f, --format <fmt> | 输出格式：table、json 或 csv |
错误处理
CLI 自动重试失败请求（最多 2 次）。速率限制响应（429）遵循 Retry-After 头。未认证时，命令返回：
Not authenticated. Run: mp auth login --key <your-api-key>下一步
查看命令参考了解完整命令列表。