通过 MCP 将 AI 助手连接到 DropRFID
通过模型上下文协议(MCP),助手可以查询组织的扫描会话、浏览 SKU 目录,并根据扫描到的标签识别商品。
1. 创建组织 API 密钥
以组织管理员身份登录,打开「API 密钥」,选择「创建 API 密钥」。为助手单独创建一个密钥,并在密钥显示时复制。该密钥也可用于访问公共 API,你可以随时在同一页面撤销它。
管理员 → API 密钥在 Bash 或 Zsh 中运行第一行,粘贴密钥并按回车。输入的字符不会显示。然后运行第二行,让客户端可以读取密钥。
read -rs DROP_RFID_API_KEY export DROP_RFID_API_KEY
2. 连接 MCP 客户端
选择支持 Streamable HTTP 和自定义 Authorization 请求头的客户端。如果使用 Claude Code,请将以下服务器配置添加到项目根目录的 .mcp.json 文件中,然后从刚才导出密钥的终端启动 Claude Code。
{
"mcpServers": {
"droprfid": {
"type": "http",
"url": "https://www.droprfid.com/api/v1/public/mcp",
"headers": {
"Authorization": "Bearer ${DROP_RFID_API_KEY}"
}
}
}
}如需连接预发布环境,请使用该环境的 API 密钥,并将 URL 改为 https://staging.droprfid.com/api/v1/public/mcp
3. 检查连接
Claude Code 提示时,请批准连接 droprfid 服务器,然后打开 /mcp 确认连接状态。试着问「最近三次扫描会话的情况如何?」如果组织还没有扫描记录,返回的会话列表将为空。
list_recent_sessions— 查看最近的扫描会话、状态和标签数量。list_skus— 分页浏览 SKU 目录。lookup_tag— 根据 RFID 标签的 EPC 或条形码查找 SKU。
如果收到 HTTP 401,请检查密钥是否属于所选环境且仍然有效。HTTP 429 表示该密钥已达到公共 API 的共享速率限制,请在 X-RateLimit-Reset 指定的时间后重试。
