使用说明
@补充雷达/mcp服务器
将AI代理连接到实时 补给雷达 库存数据。适用于Claude Desktop、OpenClaw和任何兼容MCP的客户端。
设置
- 从获取API密钥 补货雷达>设置>API键.
- 将此服务器添加到MCP客户端配置中。在Claude Desktop中,打开 设置>开发人员>编辑配置:
{
"mcpServers": {
"replenishradar": {
"command": "npx",
"args": ["-y", "@replenishradar/mcp-server"],
"env": {
"REPLENISHRADAR_API_KEY": "rr_sk_your_key_here"
}
}
}
}
- 重新启动Claude Desktop并询问:“我的最大缺货风险是什么?”
还没有补货雷达帐户?在配置服务器之前,使用公共代理入口端点请求一个短期只读沙盒密钥:
POST https://api.replenishradar.com/api/public/agent-intake
可用工具
阅读
标准包括有限的读取API访问权限。增长增加了诊断/状态读取工具。
| 工具 | 说明 |
|---|---|
rr_get_stockout_risk |
SKU的缺货风险水平 |
rr_get_inventory_position |
按地点分类的商品库存 |
rr_get_demand_forecast |
需求预测统计数据 |
rr_get_suggested_purchase_orders |
建议PO |
rr_get_replenishment_actions |
典型的买家补货行动 |
rr_get_replenishment_action |
一次带有事件历史记录的补货操作 |
rr_get_alerts |
活动警报 |
rr_list_items |
列出库存项目 |
rr_get_sync_status |
最近的同步历史记录 |
rr_list_suppliers |
列出供应商/供货商 |
rr_list_purchase_orders |
列出采购订单 |
rr_get_purchase_order |
包含行项目的单个采购订单 |
rr_get_po_pdf |
PO PDF信息 |
rr_get_po_documents |
采购订单所附文件 |
rr_get_po_notes |
采购订单所附注释 |
rr_get_sales_history |
销售历史 |
rr_get_top_sellers |
畅销SKU |
rr_get_slow_movers |
移动缓慢的SKU |
rr_get_inventory_value |
存货价值明细 |
rr_get_sku_health |
SKU级别运行状况摘要 |
rr_get_lost_sales |
估计缺货造成的销售损失 |
rr_get_store_health |
存储连接和同步运行状况 |
rr_get_data_freshness |
按数据维度划分的新鲜度状态 |
rr_get_setup_status |
设置里程碑和下一步 |
rr_get_recent_activity |
最近的警报、PO和同步汇总 |
search_knowledge |
补充雷达产品知识搜索 |
rr_evaluate_fit |
确定性ICP+层级匹配判断(无组织数据) |
基础写作(标准层及以上)
安全,低爆炸半径写-没有钱或股票突变。
| 工具 | 说明 |
|---|---|
rr_acknowledge_alert |
确认警报 |
rr_add_po_note |
在采购订单中添加备注 |
rr_request_approval |
请求人工批准采购订单 |
rr_add_replenishment_action_note |
在补货操作中添加注释 |
rr_dismiss_replenishment_action |
取消补货操作 |
rr_prepare_replenishment_action |
预览操作并获取其当前状态 updated_at 执行前 |
rr_execute_replenishment_action |
执行一个动作。 mode="draft" (默认)创建采购订单和/或转让草案; mode="autonomous" 当密钥具有敏感写入+操作工具组+启用的预算并且所有防护措施都通过时(否则起草回退或硬拒绝),也会发送PO/提交传输。过时、陈旧的国家保护 |
rr_resolve_replenishment_action |
将一个行动视为没有理由的行动;幂等、过时状态保护 |
rr_retry_replenishment_action |
通过草稿执行路径重试被阻止或失败的操作;幂等、过时状态保护 |
rr_get_document_upload_url |
获取采购订单文档的上传URL |
rr_record_pi_review |
记录形式发票详细信息 |
敏感写入(增长层及以上)
货币/股票突变。
| 工具 | 说明 |
|---|---|
rr_trigger_sync |
触发库存同步 |
rr_create_purchase_order |
创建采购订单草稿 |
rr_update_purchase_order |
更新采购订单草案 |
rr_send_purchase_order |
发送已批准的采购订单 |
rr_cancel_purchase_order |
取消订单 |
rr_create_location |
创建手动库存位置 |
rr_set_stock_at_location |
在手动位置设置库存 |
PO创建总是从 草案. rr_send_purchase_order 只发送已经经过人工批准的PO。
动作执行有两种模式。 rr_execute_replenishment_action 与 mode="draft" (默认)为行动的项目创建采购订单草案和/或转账草案,从不自动发送给供应商或承诺库存。随着 mode="autonomous" 它还发送PO或提交传输,但仅当密钥具有 sensitive_write +运营工具组+按关键预算启用(autonomous_enabled=true)每道护栏都通过;否则,它将留下草稿并返回 rr_request_approval 提示(draft_fallback)或拒绝而不变异(hard_refuse).呼叫 rr_prepare_replenishment_action 首先获取动作的当前状态 updated_at,然后将其作为 expected_updated_at 因此,在任何写入之前,过时的操作都会被拒绝。通过马厩 idempotency_key 因此,重试的调用会重放原始结果,而不是重复创建工件或重复发送。
代理上下文存储
一个小型的、组织范围的、可审计的键/值内存,因此代理可以记住有界的工作流状态。 rr_get_agent_context / rr_list_agent_context 具有读取能力; rr_set_agent_context / rr_delete_agent_context 是基本的写作。这四个人都在 agent_context 工具组。
| 工具 | 说明 |
|---|---|
rr_get_agent_context |
通过以下方式获取一个条目 namespace + key;过期的条目将被省略 |
rr_set_agent_context |
将有界JSON对象存储在 namespace + key (可选 scope_ref, ttl_seconds) |
rr_list_agent_context |
列出ONE的实时条目 namespace (必填),有界 limit (最多200) |
rr_delete_agent_context |
删除一个条目 namespace + key记录演员的来源 |
规则和限制:
- 命名空间由代码拥有,并按每个键分配。 管理员必须在“设置”>“API密钥”中的每个命名空间上授予API密钥读/写/删除权限。仅同一组织访问权限 不 足够了。
- 没有秘密,没有原始个人身份信息。 看起来像令牌、密码、私钥、凭据或原始电子邮件/电话/地址的写入将被拒绝。
value必须是 JSON对象 (不是标量或数组),上限为 16千磅 序列化。ttl_seconds是可选的,上限为 90天;如果没有TTL,则该条目在组织存在时仍然存在。rr_list_agent_context需要namespace并且从不跨命名空间列出。scope_ref仅是描述性元数据 不 唯一性的一部分-将每个作用域条目编码到key(例如supplier_rules/sku:ABC123).- 敏感命名空间(例如
sourcing_economics)另外需要掌握敏感经济阅读能力+工具组的钥匙。
支出预算(由管理员管理,无MCP工具)
Per-API-主要支出预算-Per-PO价值上限,滚动24小时每日上限,最大转移数量增量 autonomous_enabled 标记和供应商/目的地/传输源(或路由对)的分配列表-约束自治密钥可以购买或移动的内容。他们被管理 仅 在“设置”>“API密钥”(JWT-admin设置API)中由管理员管理;没有MCP工具可以读取或更改预算,并且API密钥无法到达预算路线,即使对于其自身的上限也是如此。预算仅由自主发送/提交消耗,默认情况下自主模式处于关闭状态,被拒绝的自主操作只会收到一个简短的决策原因,而不会收到上限金额、分配列表或其他密钥的分类账。
速率限制
- 标准 (99美元/月):10次通话/小时,读+基本写工具
- 成长 (199美元/月):100个电话/小时,读+基本+敏感读/写+诊断/状态工具
- 规模 (499美元/月):1000次呼叫/小时,完整的读写功能集