fluf

fluf-mcp — AI エージェント向け FLUF Connect

Model Context Protocol サーバーです。AI エージェント（Claude、Cursor、Windsurf、Cline など、MCP に対応するもの）が FLUF Connect アカウントを操作できます。在庫の確認、複数のマーケットプレイスにまたがる商品の一覧表示、注文の確認、FLUF 独自のアシスタントへの質問、サポートチケットの作成が可能です。

1 つのアカウントと 1 つのトークンで、接続済みのすべてのマーケットプレイスを利用できます。エージェントはマーケットプレイスごとの API を覚える必要がなく、マーケットプレイスの認証情報を扱うこともありません。

基本となるのは 6 つのツールです。成果につながるのは 5 つのレシピです。レシピはツールを適切な順序で連携させる名前付きのワークフローで、クライアントではスラッシュコマンドとして表示されます。多くのユーザーにはレシピがおすすめです。

レシピ

レシピは MCP プロンプトとして提供されます。Claude Desktop と Claude Code ではスラッシュコマンドとして、Cursor などのクライアントではプロンプト選択画面に表示されます。

レシピ	成果	引数
dead_stock	実際に販売につながっているチャネルに出品されていない在庫を見つけ、優先してクロスリストする商品順に並べます。	period、limit
morning_sales	昨日の取引状況を 90 秒で把握できます。注文、売上、チャネル構成、公正な基準値と比べた変化を確認します。	date、compare
listing_failures	出品の失敗や停滞を調査し、根本原因ごとに分類して、それぞれの原因に対する解決策を提案します。	channel、period
expansion	新たに接続したマーケットプレイスに出品する商品を、既存の販売実績に合わせて選びます。	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

エージェントが販売者の信頼を失う原因となるため、レシピでは特に次の 2 点を厳守しています。

• 確認なしに出品することはありません。 dead_stock と expansion は調査と提案を行い、あなたが承認した後にのみ crosslist を呼び出します。
• キューに入ったものは、キューに入ったと報告します。 拡張機能を先に使うチャネルでは、処理を完了するためにご自身のブラウザーが必要です。そのため、商品が受け付けられていても、まだ公開されていない場合があります。レシピは成功したと断言せず、その状況を伝えます。また、再送信もしません（繰り返すと出品が重複する可能性があります）。

ツール

ツール	機能
list_channels	このアカウントが接続しているマーケットプレイスと、出品可能なマーケットプレイスを確認します。
list_products	各商品がすでに公開されているチャネルとともに、商品を一覧表示します。
crosslist	1 つ以上の商品を、1 つ以上のマーケットプレイスに出品します。
get_orders	接続済みのすべてのマーケットプレイスにまたがる注文を、統一された形式で取得します。
list_drafts	修正可能な理由（サイズ、ブランド、カテゴリ、価格、表現）でマーケットプレイスに拒否された出品と、その理由および編集可能な項目を表示します。承認待ちの項目も確認できます。
approve_draft	下書きの項目を修正し、マーケットプレイスに送信します。
ask_intesa	アカウントについて、FLUF 独自のアシスタントに自由形式で質問します。チャネルの同期が止まった理由、出品エラーの意味、売れた商品と販売先などを尋ねられます。
report_bug	FLUF サポートに代わりにバグを報告します。あなたから問題の報告があった場合のほか、エージェント自身が行き詰まり、作業を完了できない場合にも利用します。

トークンの取得

https://fluf.io/connect/developers でトークンを作成します。FLUF Connect では、左側のサイドバーから More → Developers を選択してください。トークンは一度だけ表示されるため、パスワードと同様に保管してください。同じ画面からいつでも無効化できます。

有効なプランの FLUF Connect アカウントが必要です。API は有料機能です。

インストール

導入方法は 2 つあります。特別な理由がなければ、最初の方法を選んでください。

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_..." }
    }
  }
}

環境変数

Var	必須	デフォルト	備考
FLUF_API_TOKEN	はい	—	個人用アクセストークンです。
FLUF_BASE_URL	いいえ	https://fluf.io	ステージング環境用に上書きします。

使用方法

目的を達成したい場合は、レシピを利用してください。ツールを呼び出す順序と注意点が定義されています。それ以外の場合は、自然な言葉で質問すれば、エージェントがツールを選びます。

「在庫のうち、まだ eBay に出品していないものは何ですか？最も安いものを10件挙げてください。」

「先週売れたものをすべて表示し、どのチャネルで売れたか教えてください。」

「Vinted で直近5件の出品が失敗したのはなぜですか？」

知っておくとよいことが3つあります。

• 最初に必ず list_channels を呼び出してください。 利用可能なマーケットプレイスはアカウントごとに異なり、時間の経過とともに変化するため、一覧をハードコードしないでください。
• crosslist は常に即時に完了するとは限りません。 一部のチャネルでは、処理を完了するためにユーザー自身のブラウザーセッションに引き継がれるため、レスポンスが listed ではなく queued と示す場合があります。チャネルごとのステータスを確認し、成功したと決めつけないでください。
• ask_intesa は時間がかかりますが、賢いツールです。 質問を FLUF 内のアシスタントである 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 にレシピごとのエントリを追加するだけで、登録手順は不要です。エージェント向けのプレーンテキストなので、編集してもクライアントを変更する必要はありません。

サポート

[email protected]

ライセンス

MIT — LICENSEを参照してください。© FLUF.io。

サーバー自体はオープンですが、接続先のアカウントはオープンではありません。機能を利用するには、有効なプランの FLUF Connect アカウントが必要です。