主题
Refly AI 接入
Refly AI 是开源的 AI Native 创作平台(GitHub: refly-ai/refly),支持画布式工作流、多模型、MCP 工具集成。
一、获取 Refly
两种方式:
- 云端版:直接登录 refly.ai 注册(最省事)
- 自托管:
git clone仓库后按 README 用 Docker Compose 起一套(数据完全自有)

二、配置 AI 大模型
- 顶部头像 → Settings → Model Providers
- 选一家供应商(OpenAI / Anthropic / DeepSeek / Qwen 等)→ 填 API Key → Verify

三、配置 Keepamore MCP
- Settings → MCP Servers → 右上角 + Add Server
- 选 Streamable HTTP 类型
- 表单:
| 字段 | 值 |
|---|---|
| Name | Keepamore Keepa |
| URL | https://mcp.keepamore.com/mcp |
| Headers | 新增一行:X-API-Key = km_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |

- 点 Test Connection 看到 13 个工具被识别 → Save
- 回到列表,把开关打开
四、配置 Skill / Agent
Refly 通过 Skill 把 prompt 与工具组合成可复用的智能体:
- 顶部 Skills → Create Skill
- 名称:
Keepa Data Analyst - System Prompt 粘贴 Keepa 数据分析师 prompt
- Tools 区域勾选刚才配置的
Keepamore Keepa服务下的所有keepa_*工具 - 保存

五、在画布中使用
Refly 的特色是"画布工作流":
- 进入任意 Canvas → 添加一个 Chat / AI Node
- Node 上选刚创建的 Keepa Data Analyst Skill
- 输入:
帮我对比 B08N5WRWNW、B0CHX2F5QR、B0BDHB9Y8H 三个 ASIN 在美国站的价格与排名AI 会一次性发起并发的 keepa_get_product 调用,结果以表格 + 图表(如启用 keepa_graph_image)呈现到画布。

故障排查
| 现象 | 原因 | 处理 |
|---|---|---|
| MCP 列表里没有工具 | URL / Header 错 | 检查 JSON / 字段拼写,重新 Test Connection |
| Skill 看不到 keepa_* 工具 | MCP 服务未启用 | 回到 MCP Servers 页确认开关绿色,再回 Skill 编辑页刷新 |
| 自托管版连接超时 | 服务器出口防火墙 | 容器宿主机执行 curl https://mcp.keepamore.com/health 验证 |
| Canvas 调用一直 loading | 模型 / 工具任一环节挂 | Refly 右下角 Logs 面板查看具体报错 |