fluf

fluf-mcp — 面向 AI Agent 的 FLUF Connect

一个 Model Context Protocol 服务，让 AI Agent（Claude、Cursor、Windsurf、Cline 以及任何支持 MCP 的工具）能够操作 FLUF Connect 账户：读取库存、列出各个 marketplace 上的商品、读取订单、向 FLUF 自带的助手提问，以及提交 支持工单。

一个账户、一个令牌，覆盖你已连接的所有 marketplace——Agent 无需了解每个 marketplace 的 API，也不会接触你的 marketplace 凭据。

六个工具是基础功能。五个配方是最终成果——它们是按正确顺序串联工具的命名工作流，并以斜杠命令的形式显示在客户端中。大多数人需要的是配方。

配方

配方以 MCP 提示词的形式提供。在 Claude Desktop 和 Claude Code 中，它们会显示为斜杠命令；在 Cursor 和其他客户端中，则显示在提示词选择器里。

配方	结果	参数
dead_stock	找出尚未在实际为你带来销量的渠道上架的库存，并按优先交叉刊登的顺序排序。	period、limit
morning_sales	用九十秒回顾昨天的交易情况：订单、收入、渠道构成，以及相较合理基准发生的变化。	date、compare
listing_failures	调查刊登失败和卡住的情况，按根本原因分组，并针对每种原因提出解决方案。	channel、period
expansion	决定要在新连接的 marketplace 上铺哪些商品，并根据你现有的畅销商品进行选择。	channel （必填）、batch_size
support	通过 Intesa 诊断问题，然后附上相关证据提交支持工单。	problem （必填）

除特别标注外，所有参数均为可选项；每个配方都有合理的默认值——单独使用 /dead_stock 也能正常运行。

/dead_stock period="30 days" limit=10
/morning_sales compare=previous_week
/expansion channel=vinted batch_size=25

配方有两项刻意设置的严格规则，因为违反它们会让 Agent 失去卖家的信任：

• 未经确认，不会刊登任何商品。 dead_stock 和 expansion 会进行调研并给出建议；只有在你同意后，它们才会调用 crosslist。
• 排队中会如实报告为排队中。 优先使用扩展程序的渠道会在你自己的 浏览器中完成操作，因此商品可能已被接受，但尚未正式上线。配方会明确说明这一点，而不会谎称成功，也不会重复推送（重复操作可能导致刊登重复）。

工具

工具	功能
list_channels	查看此账户已连接哪些 marketplace，以及可在哪些 marketplace 上刊登商品。
list_products	查看你的商品，以及每件商品已在哪些渠道上线。
crosslist	在一个或多个 marketplace 上刊登一件或多件商品。
get_orders	以统一格式查看你在所有已连接 marketplace 上的订单。
list_drafts	查看 marketplace 因可修正原因（尺寸、品牌、类别、价格、措辞）而拒绝的刊登，并了解拒绝原因和可编辑字段，以及任何等待你批准的项目。
approve_draft	修正草稿字段并将其发送到 marketplace。
ask_intesa	向 FLUF 自带的助手询问有关你账户的开放式问题——例如渠道为何停止同步、刊登错误意味着什么、哪些商品卖出了以及在哪些渠道卖出。
report_bug	代表你向 FLUF 支持团队提交 Bug——既可以在你报告问题时提交，也可以在 Agent 自身卡住、无法完成任务时提交。

获取令牌

前往 https://fluf.io/connect/developers 创建令牌——在 FLUF Connect 中，入口位于左侧边栏的 更多 → 开发者。令牌只会显示一次，请像密码一样妥善保存。你可以随时在同一页面撤销令牌。

你需要拥有一个订阅有效套餐的 FLUF Connect 账户；API 是一项付费功能。

安装

有两种接入方式。除非你有特殊原因，否则请选第一种。

Claude Desktop — 一键安装，无需 Node（推荐）

从最新版本下载 fluf-mcp-<version>.mcpb 并打开。 Claude Desktop 会显示安装对话框，并在表单字段中要求你输入令牌，然后就完成了——无需终端、无需 JSON，也无需安装 Node：Claude Desktop 自带 Node 运行时，并会将其用于已安装的程序包。

其他所有场景 — npx

适用于 Cursor、Claude Code、Windsurf、Cline，或者你想自行管理的情况。 此方式需要你的计算机上安装 Node 18+——Claude Desktop 自带的运行时仅用于已安装的 .mcpb 程序包，不适用于 claude_desktop_config.json 条目；此类条目会从系统 PATH 启动 command。

npm install -g fluf-mcp

配置

仅 npx 方式需要配置——.mcpb 程序包会自行完成配置。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "fluf": {
      "command": "npx",
      "args": ["-y", "fluf-mcp"],
      "env": { "FLUF_API_TOKEN": "fluf_pat_..." }
    }
  }
}

Claude Code

claude mcp add fluf --env FLUF_API_TOKEN=fluf_pat_... -- npx -y fluf-mcp

Cursor

~/.cursor/mcp.json（或项目专属的 .cursor/mcp.json）：

{
  "mcpServers": {
    "fluf": {
      "command": "npx",
      "args": ["-y", "fluf-mcp"],
      "env": { "FLUF_API_TOKEN": "fluf_pat_..." }
    }
  }
}

环境变量

变量	必填	默认值	说明
FLUF_API_TOKEN	是	—	你的个人访问令牌。
FLUF_BASE_URL	否	https://fluf.io	用于覆盖为预发布环境。

使用方法

需要达成某个结果时，请使用配方——它们规定了工具调用顺序和注意事项。否则，直接用自然语言提问，Agent 会选择合适的工具：

“我有哪些库存商品还没在 eBay 上架？列出价格最低的 10 件。”

“显示上周售出的所有商品，以及它们的销售渠道。”

“我最近发布的 5 条 Vinted 商品信息为什么失败了？”

有三点值得注意：

• 始终先调用 list_channels。 可用的交易平台因账户而异，也会随时间变化；不要将列表写死。
• crosslist 不一定会立即完成。 某些渠道会交由你自己的浏览器会话完成，因此响应可能显示 queued（已排队），而不是 listed（已上架）。请查看各渠道的状态；不要默认操作已成功。
• ask_intesa 是速度较慢但更智能的工具。 它会将问题交给 FLUF 内置的助手 Intesa。Intesa 会先进行多步调查再作答，因此它能解释事情为何发生，而不只是报告结果。回复最多可能需要 1 分钟。简单查询请使用直接工具；遇到诊断性或开放式问题时再使用它。

开发

npm install
npm run build
FLUF_API_TOKEN=... node dist/index.js

无需 MCP 客户端即可进行冒烟测试：

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
  | FLUF_API_TOKEN=... node dist/index.js

echo '{"jsonrpc":"2.0","id":1,"method":"prompts/list"}' \
  | FLUF_API_TOKEN=... node dist/index.js

配方位于 src/prompts.ts 中——RECIPES 内每个配方对应一个条目，无需注册步骤。它们是面向 Agent 的纯文本，因此编辑配方无需更改客户端。

支持

[email protected]

许可证

MIT — 请参阅 LICENSE。© FLUF.io。

服务本身是开源的；它所连接的账户并非如此。你仍需拥有有效套餐的 FLUF Connect 账户，才能使用任何功能。