内容
# @replenishradar/mcp-server
将 AI 代理连接到 ReplenishRadar 的实时库存数据。可与 Claude Desktop、OpenClaw 以及任何兼容 MCP 的客户端配合使用。
## 设置
1. 从 **ReplenishRadar > 设置 > API 密钥** 获取您的 API 密钥。
2. 将此服务器添加到您的 MCP 客户端配置中。在 Claude Desktop 中，打开 **设置 > 开发者 > 编辑配置**：
```json
{
"mcpServers": {
"replenishradar": {
"command": "npx",
"args": ["-y", "@replenishradar/mcp-server"],
"env": {
"REPLENISHRADAR_API_KEY": "rr_sk_your_key_here"
}
}
}
}
```
3. 重启 Claude Desktop 并询问：“我的库存风险最高的产品有哪些？”
如果您还没有 ReplenishRadar 账户，请使用公共代理接入端点请求一个短期、只读的沙盒密钥，然后再配置服务器：
```text
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` | 建议的采购订单 |
| `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` | 采购订单 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` | 最近的警报、采购订单和同步汇总 |
| `search_knowledge` | ReplenishRadar 产品知识搜索 |
| `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"` 还会发送采购订单/提交转移，当密钥具有 `sensitive_write` + 操作工具组 + 已启用的预算且所有防护措施通过时（否则回退草稿或硬拒绝）。幂等，防过时保护 |
| `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` | 在手动位置设置库存 |
采购订单创建始终以**草稿**开始。只有 `rr_send_purchase_order` 才会发送已经人工审批的采购订单。
行动执行有两种模式。`rr_execute_replenishment_action` 使用 `mode="draft"`（默认）创建草稿采购订单和/或草稿转移从不自动发送给供应商或提交库存。使用 `mode="autonomous"` 还会发送采购订单或提交转移，但前提是密钥具有 `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` | 在 `namespace` + `key` 下存储有界 JSON 对象（可选 `scope_ref`、`ttl_seconds`） |
| `rr_list_agent_context` | 列出一个 `namespace`（必填）的实时条目，有限 `limit`（最多 200） |
| `rr_delete_agent_context` | 通过 `namespace` + `key` 删除一个条目；记录操作凭证 |
规则和限制：
- **命名空间由代码所有并按密钥允许列表。** 人类管理员必须在设置 > API 密钥中授予您的 API 密钥对每个命名空间的读取/写入/删除权限。同一组织的访问权限不足。
- **不允许存储秘密、原始个人身份信息。** 看起来像令牌、密码、私钥、凭证或原始电子邮件/电话/地址的写入将被拒绝。
- `value` 必须是 **JSON 对象**（不是标量或数组），上限为 **16 KiB** 序列化。
- `ttl_seconds` 是可选的，上限为 **90 天**；如果没有 TTL，条目将持续到组织存在。
- `rr_list_agent_context` **需要** `namespace`，并且永远不会跨命名空间列出。
- `scope_ref` 仅是描述性元数据，**不是**唯一性的一部分 - 将特定于范围的条目编码到 `key` 中（例如 `supplier_rules/sku:ABC123`）。
- 敏感命名空间（例如 `sourcing_economics`）还需要密钥持有敏感经济读取能力 + 工具组。
## 支出预算（管理员管理，无 MCP 工具）
每个 API 密钥的支出预算 - 每个采购订单价值上限、24 小时滚动每日上限、最大转移数量增量、`autonomous_enabled` 标志以及供应商/目的地/转移源（或路由对）的允许列表 - 限制了自主密钥可以购买或移动的内容。它们仅由人类管理员在设置 > API 密钥中管理（JWT 管理员设置 API）；没有 MCP 工具可以读取或更改预算，并且 API 密钥甚至不能访问预算路由。
## 速率限制
- **标准版**（99 美元/月）：10 次调用/小时，读取 + 基本写入工具
- **成长版**（199 美元/月）：100 次调用/小时，读取 + 基本 + 敏感读取/写入 + 诊断/状态工具
- **规模版**（499 美元/月）：1000 次调用/小时，完整的读取 + 写入能力集
## 了解更多
- [MCP 设置指南](https://replenishradar.com/blog/connect-ai-agent-amazon-shopify-inventory)
- [ReplenishRadar](https://replenishradar.com)
