CLI 工具管理员配置指南

为企业自建应用配置 CLI 所需的授权与权限。

概述

💡 CLI 工具通过企业自建应用完成身份授权。
管理员完成应用创建与权限配置后，员工即可在本机 Agent 中操作 CRM。
合理配置授权范围与 IP 允许清单，可控制访问来源与数据边界。

开始之前

[!IMPORTANT]

• 角色权限：您需要拥有「应用列表」权限的管理员账号。
• 前置配置：员工本机已安装 Node.js 与 CLI 工具。
• 影响范围：授权模式与 API 权限的变更，对接入该应用的员工立即生效。

第一步：创建企业自建应用

1. 登录 CRM 后台，前往 应用列表 管理页面。

2. 点击 创建企业自建应用。

[!TIP]
也可以在已有应用上追加配置，无需重复创建。

3. 输入应用名称。

4. 创建完成后，重新进入应用编辑页面。

第二步：开启开发者模式

1. 在应用编辑页面中，开启 开发者模式。
2. 在授权模式中选择 Device Flow。
3. 按需配置 IP 允许清单。

[!NOTE]
如需允许全部 IP 访问，将允许清单留空，或填写 0.0.0.0-255.255.255.255。

第三步：配置 API 权限

1. 在应用编辑页面中，进入 API 权限 配置区。
2. 按业务需要勾选权限项。

3. 点击 保存。

[!WARNING]
权限范围决定 AI 能操作的数据边界。
请遵循最小权限原则，只开放业务真正需要的权限。

第四步：提交灰度申请

CLI 功能需要企业侧灰度开通。

1. 提交 sharecrm CLI 产品灰度申请工单。
2. 联系相关负责人完成审批。
3. 等待线上灰度配置生效。

[!NOTE]
灰度配置一般在当日 23:00 更新。审批通过后当晚生效。

验证方法

1. 让一位已安装 CLI 的员工执行 sharecrm auth login。
2. 确认浏览器授权页中出现该应用。
3. 确认员工可选择该应用并完成授权。
4. 确认授权后终端返回登录成功信息。

注意事项

• 授权页中无可选应用时，检查应用是否已创建，以及员工是否在应用使用范围内。
• 灰度申请未通过或配置未生效时，登录授权会提示企业未灰度。
• 修改授权模式后，已授权的员工需重新登录。

相关主题

• CLI 工具概述
• CLI 工具快速上手
• CLI 工具用户操作指南
• MCP 服务管理员配置指南