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

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

ManoMano + Cursor

ヨーロッパの DIY・ガーデニング マーケットプレイス ManoMano での販売を AI エージェントから行えます。注文の受付・発送・返金、出品の価格と在庫、他の販売者に対する競争力、EAN によるカタログ検索、ManoFulfillment の在庫、顧客向け請求書に対応します。セラー契約ごとに 1 回インストールします。

前提条件

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

MANOMANO_API_KEY, MANOMANO_SELLER_CONTRACT_ID

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

1. https://toolbox.manomano.com の ManoMano Toolbox に、Admin ロールを持つユーザーでサインインします。
2. Settings > API keys を開き、Create API key をクリックして AnythingMCP などの名前を付け、Generate API key をクリックします。キーはすぐにコピーしてください。ManoMano がキーを表示するのは一度だけです。コピーしたキーを MANOMANO_API_KEY に貼り付けます。
3. セラー契約 ID を MANOMANO_SELLER_CONTRACT_ID に入力します。Toolbox に表示される数字で、たとえば 110841 のような形式です。
4. コネクターをインストールし、まず manomano_list_orders を実行します。

契約ごとに 1 インストール: ManoMano では、プラットフォーム（manomano.fr、.es、.it、.de、.co.uk）と配送方法ごとにセラー契約が作られます。そのため、複数のプラットフォームで販売している場合は契約も複数になります。コネクターは契約ごとに 1 回インストールし、それぞれに契約名を付けてください（例: ManoMano FR）。契約 ID はすべての呼び出しに付加され、キーは ManoMano にのみ送信されます。

注文の流れ: 新しい注文は PENDING です。受け付けると PREPARATION に進み、拒否すると顧客に返金されます（REFUNDING の後 REFUSED）。発送では、配送業者、追跡番号と追跡 URL、梱包した商品を小包ごとに登録し、注文は SHIPPED になります。返金は一部またはすべての商品が対象です（REFUNDING の後 REFUNDED）。毎日の作業リストとして、AI は PENDING と PREPARATION の注文を一覧にします。発送や返金にはそれぞれの商品の seller_sku と数量が必要なため、AI は事前に注文を読み込みます。

まず確認: 注文の受付・拒否・発送・返金、出品の変更・凍結解除・置き換え、請求書のアップロードは、実際のマーケットプレイスに反映されます。これらを実行する前に、AI は変更内容（注文、商品と数量、追跡番号、SKU ごとの変更前後の価格や在庫、アップロードする書類）を示し、あなたの承認を待ちます。拒否と返金は取り消せません。

価格と在庫: manomano_update_offers は既存 SKU の価格、在庫、またはその両方を変更します。初期設定では新しい値が凍結され、その後の商品フィードのインポートで上書きされなくなります。manomano_unfreeze_offers を使うと、値の管理がフィードに戻ります。ManoMano は変更をバックグラウンドで反映するため、AI は返された request_id を使って manomano_list_offers で状況を確認します（IN PROGRESS、エラー内容付きの ERROR、または COMPLETED）。出品を新規作成または完全に置き換える manomano_upsert_offers は、インストール時はオフです。

競合、カタログ、フルフィルメント: 選んだ SKU をその商品の最良オファーと比較したり、指定期間に競争状況が変わったすべての出品を一覧にしたりできます。一度に最大 200 件の EAN を照会して、商品がすでに ManoMano のカタログにあるか、出品できるかを確認できます。ManoFulfillment 倉庫の在庫は、ManoFulfillment 契約でのみ利用できます。

顧客向け請求書: AI は、顧客が待っている請求書を古い依頼から順に一覧にします。請求書は発送から 3 営業日以内に提供する必要があります。AI は URL から PDF をアップロードします。書類は以前のものに追加され、顧客に通知が届きます。

制限: API キーごとに、注文 API は 1 時間あたり約 250 リクエスト、出品 API は約 200 リクエストまでです。これを超えると ManoMano は 429 を返します。注文は 1 ページ最大 50 件で取得します。このコネクターは本番 API を使い、ManoMano のサンドボックスは使いません。

よくあるエラー: 401 は ManoMano がキーを拒否したことを示します。キーを確認するか、Toolbox で新しいキーを作成してください（削除したキーはすぐに使えなくなります）。403: キーは有効ですが、この契約を操作する権限がありません。契約 ID が、キーを作成したセラーアカウントのものか確認してください。400: 契約 ID が数字のセラー契約 ID になっているか確認してください。429: リクエストが多すぎます。しばらく待ってから再試行してください。

ステップ 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. チャットを始めましょう。エージェントが ManoMano のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「まだ PENDING の ManoMano の注文はどれですか？準備中の注文のうち 2 日以上経っているものも教えてください。」
• 「注文 M240915123 を Colissimo、追跡番号 6A12345678901 で発送してください。商品はすべて 1 つの小包に入っています。」
• 「SKU DRILL-18V の価格を 89.90 ユーロ、在庫を 25 に設定して、更新が反映されたか確認してください。」
• 「この 5 つの SKU で、私の出品は ManoMano の最良オファーになっていますか？上回っている販売者とその価格を見せてください。」

FAQ

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

次のステップ

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