将助手应用连接到 Kluvan

所有者须先在 AI 设置启用全局同意。这与开启助手访问及选择密钥范围分开。全局停用也会阻止外部助手请求；撤销密钥不能收回已提供的信息。

如果使用支持 MCP（模型上下文协议）的助手，例如 Claude、ChatGPT 或其他 MCP 客户端，可允许它读取 Kluvan 数据，并询问“本周销售如何？”或“哪些库存不足？”。助手由您自己使用并向其提供商付费，Kluvan 不按问题收费。此连接只能读取。

开始之前

• 只有所有者可启用此功能并创建密钥。
• 此连接是新功能，遵循 MCP 标准，但尚未在所有助手应用中试用。如果您的助手无法连接，请联系支持。
• Claude 桌面应用要求电脑安装 Node.js。

步骤

1. 打开 Settings（设置）中的助手访问页面，地址以 /settings/ai 结尾。
2. 勾选允许访问的开关及下方声明，点击 Save（保存）。
3. 在 New key（新密钥）下输入容易识别的 Name（名称），例如“我的 ChatGPT”。
4. 勾选可查看的内容：Reports（报表）、Stock（库存）、Products（产品）、Customers（客户）、Bookings（预约）、Team（团队），或 Services & Maintenance（服务与维护）、Rentals（租赁）等应用记录。不需要的请取消勾选。
5. 可选：选择 Only this branch（仅此分支）和 Last day (optional)（最后有效日，可选）。
6. 点击 Make the key（创建密钥），再点击 Copy（复制）。密钥只显示这一次。
7. 打开对应助手的卡片：Claude desktop app、Claude on the web (claude.ai)、ChatGPT 或 Any other MCP client。卡片已填入您的地址和新密钥。
8. 按卡片步骤在助手应用操作，粘贴显示的内容并保存。
9. 在助手中问第一个问题，例如“使用我的 Kluvan 工具，查看哪些产品库存不足？”。

每个选项允许什么

• Reports：销售数字、对比和畅销商品。Stock：数量、低库存和到期日。Products：名称、价格和条码。
• Customers：姓名、电话和欠款。这是个人数据，因此默认关闭。未勾选时客户显示为 hidden（已隐藏）。
• Bookings 和 Team 仅在相应应用启用时可用。
• 应用记录（服务与维护、客户支持、表单、自动化、生产与装配、租赁、分析、贸易与批发）也需勾选 Customers，因为记录可能含个人数据，且对应应用必须启用。

注意事项

• 只读：助手不能通过此连接销售、退款、收款、修改设置或删除内容。
• 每把密钥的限制：每分钟 60 次、每天 2,000 次调用。列表最多 50 条，会提示助手缩小问题范围。最多可持有 10 把密钥。
• 滥用保护：一小时内 20 次请求未获授权的内容，会使密钥 Paused（暂停）。此后所有调用被拒绝，所有者收到提醒（须已启用），事件记录在 Team → Activity。检查助手收到的请求后，选择 Resume（恢复）或 Revoke（撤销）。
• 含密钥的地址本身就是密钥。 不要贴到任何公开位置。Revoke 立即停用；到期或创建它的所有者不再处于启用状态时，也会停用。
• 密钥权限不能扩大。如需更多权限，创建新密钥并撤销旧密钥。
• 页面底部活动列表显示最近 50 次调用：时间、密钥、请求内容类型、行数以及回答或拒绝状态。不保存问题本身。
• 关闭访问会拒绝所有密钥，直到重新开启。
• 如需自有软件写入记录，请使用开发者 API。