MCP 経由で Fruugo を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Fruugo をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Fruugo + Cursor

AI エージェントから Fruugo マーケットプレイスで販売します。明細、顧客向け価格、配送先住所、出荷情報を含む注文を取得し、SKU の販売可否と在庫を確認できます。注文の確定と出荷登録も含まれますが、インストール時はオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

FRUUGO_USERNAME, FRUUGO_PASSWORD

ステップ 1 — 認証情報を取得

セットアップは約 2 分です。Fruugo の販売者アカウントと、Fruugo Retailer Portal のユーザーが必要です。

1. retailer.fruugo.com で Fruugo Retailer Portal にサインインします。Fruugo は連携用に別のポータルユーザーを用意することを推奨しているので、可能であれば AnythingMCP 用のユーザーを作成してください。
2. そのポータルユーザーのユーザー名を FRUUGO_USERNAME に、パスワードを FRUUGO_PASSWORD に入力します。Fruugo は呼び出しのたびに HTTP Basic でこれを確認します。
3. コネクターをインストールし、数日前の日付を from に指定して fruugo_download_orders を実行します。

読み取れるデータ: Fruugo の不正チェックを経てあなたに引き渡された注文（注文 ID と顧客注文 ID、日付、ステータス、顧客の言語、配送先住所と配送方法、送料、Fruugo と自社の商品 ID・SKU ID を含む明細、自社価格と顧客が自国通貨で見た価格、付加価値税、商品数のカウンター（保留、確定、出荷済み、キャンセル、返品予告、返品済み）、出荷情報）、そして稼働中の SKU（タイトル、販売可否 INSTOCK、OUTOFSTOCK、NOTAVAILABLE、フィードに含まれる場合は在庫数）です。Fruugo が税を徴収した注文には、通関申告用に Fruugo の税番号と EORI も含まれます。

1 回の取得は最大 60 日: Fruugo が注文を返す期間は最大 60 日で、それより長いと 400 Time range specified is too long が返ります。四半期分なら AI が 2 回に分けて取得し、合計します。

注文ステータス: PENDING は新規で対応待ち、PROCESSED は少なくとも一部が処理済み、EXCEPTION は Fruugo が API の外で手作業で処理する注文です。

在庫はフィードから: 在庫一覧は 1 ページ 1,000 SKU で返り、AI は必要なときだけ次のページを読みます。このコネクターは在庫も価格も変更しません。それらは商品フィードから反映されます。

インストール時はオフ: fruugo_confirm_order と fruugo_ship_order。どちらも実際の顧客の注文に作用します。前者は保留中の注文を確定し（出荷予定日も指定可能）、後者は追跡コードと追跡 URL、少なくとも配送業者名を付けて出荷済みにします。これらは Fruugo から顧客に伝えられます。どちらも注文全体または 1 商品単位で使えます。管理者が意図して有効にし、その場合でも AI は注文と変更内容を正確に示し、あなたの承認を待ちます。

よくあるエラー: 401 はポータルのユーザー名またはパスワードの誤りです。retailer.fruugo.com にサインインして確認してください。400 は問題をテキストで説明します。たとえば 60 日を超える期間や、適切な状態にない注文などです。

このコネクターは注文のキャンセルや返品の登録は行いません。どちらも顧客への返金を伴うため、Retailer Portal で行ってください。出品、価格、在庫の変更も行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Fruugo のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「過去 2 週間の Fruugo の注文で、まだ保留中で発送が必要なものはどれですか。」
• 「過去 30 日間に Fruugo で何件の注文がありましたか。どの国に送りましたか。」
• 「今 Fruugo で在庫切れになっている SKU はどれですか。」
• 「先週の注文を、顧客が自国通貨で支払った金額と各明細の付加価値税付きで見せてください。」
• 「9 月 1 日以降の注文で、キャンセルや返品があったものはどれですか。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続