MCP 経由で noon Marketplace を Meta Muse に接続する方法

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

noon Marketplace + Meta Muse

noon Partner API を通じて、AI エージェントから noon.com（UAE、サウジアラビア、エジプト）で販売できます。倉庫、カタログコンテンツと商品グループ、オファー、価格、在庫、FBPI 注文と出荷、発注書（purchase order）、返品の照会、一括エクスポートに対応します。サービスアカウントと署名付き JWT でログインし、価格・在庫・商品・注文の書き込みはインストール時にオフです。

前提条件

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

NOON_KEY_ID, NOON_PRIVATE_KEY, NOON_PROJECT_CODE

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

セットアップは約 5 分です。noon Partner ポータルにアクセスできる noon.com（UAE、サウジアラビア、エジプト）のセラーアカウントと、noon Partner API 用のサービスアカウントキーが必要です。

1. noon Partner ポータルにサインインし、Access App（または User & Access > User access）を開いて、左サイドバーの API Users を選びます。
2. Add Service Account をクリックし、表示名とユーザー名を入力してロールを選びます。読み取りツールだけなら Project Viewer で足ります。書き込みツールには、カタログ、価格、在庫、注文を変更できるロールが必要です（Project Owner はすべてを許可します）。キーを IP アドレスで制限したり、有効期限を付けたりできます。どちらも設定しなければ、どの IP からでも使え、期限切れになりません。各パートナーが作成できるサービスアカウントは 1 つで、キーは最大 5 つです。
3. Add をクリックすると .json のキーファイルがダウンロードされます。表示されるのは一度だけなので、紛失したら新しいキーを作成してください。
4. そのファイルの 3 つのフィールドをコピーします。key_id を NOON_KEY_ID に、private_key を NOON_PRIVATE_KEY に、project_code を NOON_PROJECT_CODE に設定します。秘密鍵は -----BEGIN PRIVATE KEY----- から -----END PRIVATE KEY----- までの PEM 全体です。ファイルにある \n のシーケンスをそのまま残して 1 行で貼り付けてもかまいません。
5. コネクターをインストールし、noon_marketplace_whoami を実行します。セッションのサービスアカウント（ユーザーコードとユーザー名）が表示されます。

ログインの仕組み: 固定の API キーはありません。ログインのたびに、コネクターは秘密鍵で新しい RS256 JWT（サブジェクトにキー ID、現在時刻、ランダムなトークン ID）に署名し、プロジェクトコードと一緒に noon のログインエンドポイントへ送ります。noon はセッション Cookie を返し、以降のすべての呼び出しでそれが送られます。セッションの有効期間は 30 日で、コネクターは期限が切れる前と、呼び出しが 401 を返したときに再ログインします。さらにすべてのリクエストには、noon のコンテンツ API が必須とする X-Project ヘッダー（値はプロジェクトコード）が付きます。

識別子: partner_sku はすべての商品で一意な自社の SKU で、価格、在庫、オファーはこれに紐づきます。sku_parent（Z で始まる）はすべてのバリエーションを含む商品に noon が付ける ID で、コンテンツと商品グループで使います。noon SKU（sku、N で始まる）と psku_code（P で始まる）は 1 つのバリエーションを表します。warehouse_code は noon_marketplace_list_warehouses で取得します。FBPI の注文と出荷はインテグレーション倉庫に属します。country_code は小文字の ae、sa、eg で、価格は SKU と国ごとに AED、SAR、EGP で設定されます。注文と出荷は fbpi_order_nr、mp_item_nr（注文内の 1 明細）、自社で付ける integration_shipment_nr で識別します。

読み取れるデータ: サービスアカウントと倉庫、noon カタログのすべてのカテゴリコード、カテゴリが必要とする属性とその値の検証ルール、商品コンテンツの完成度・QC ステータス・公開されていない理由、商品グループ（1 ページにまとめて表示されるバリエーション）、partner SKU ごとの各国のオファー（価格、在庫、公開状態、オフラインになっている原因）、SKU と国ごとの価格・MSRP（取り消し線で表示される参考価格）・有効状態、倉庫と SKU ごとの在庫、FBPI 注文（自社倉庫から出荷する注文）の明細・注文の顧客・出荷、発注書（purchase order）、AWB 番号または返品バーコードによる返品商品、カタログインポートのステータスです。いくつかの読み取りは JSON ボディ付きの POST リクエストですが、これは noon の API の仕様で、データは何も変更しません。

一括エクスポートと AWB: noon_marketplace_list_export_categories でエクスポートできるレポートの種類を一覧し、noon_marketplace_create_export で開始し、noon_marketplace_get_export_status でファイルの準備ができたかどうかと download_url を確認します。noon_marketplace_generate_awbs は noon の配送業者に渡す荷物用の AWB（航空運送状）番号を発行します。どちらもデータを変更しないため、オンのままです。

インストール時はオフ: noon_marketplace_upsert_product、noon_marketplace_upsert_product_group、noon_marketplace_upsert_prices、noon_marketplace_update_stock、noon_marketplace_mark_items_unavailable、noon_marketplace_create_shipment、noon_marketplace_cancel_shipment。価格、在庫、商品、注文、出荷の書き込みは、顧客が目にして購入するもの（公開中の価格、販売可能数、公開コンテンツ）を変えたり、実際の注文に作用したりします。元に戻せないものもあります。商品を在庫切れとしてマークすると顧客に対してキャンセルされ、出荷をキャンセルするとその中のすべての商品がキャンセルされます。ワークスペースに必要なものは、管理者がコネクターのツール設定でオンにします。出荷を作成した後、noon の集荷用マニフェストは Seller Lab で完了させます。

バッチの結果: 価格、在庫、商品の呼び出しは、一部の項目が失敗しても 200 を返します。返された各項目のステータスを確認し、失敗したものだけを再送してください。noon_marketplace_update_stock は絶対数量を設定し、現在の数量に加算はしません。noon_marketplace_upsert_prices では、省略した項目や null で送った項目は値が保たれます。status_id 3 で保存された商品にはコンテンツの問題があり、noon_marketplace_get_content で確認できます。

制限: 一覧系のツールは next_token を返し、AI はそれが空になるまで、同じフィルターにそれを付けて呼び出しを繰り返します。レート制限はプロジェクトとエンドポイントごとに、メインのウィンドウと短いバーストウィンドウの両方で判定されます。ほとんどのエンドポイントは 60 秒あたり 1500 リクエスト、noon_marketplace_list_warehouses は 60 秒あたり 30 リクエスト（バーストは 30 秒あたり 15）です。429 が返ったら X-Ratelimit-Retry-After ヘッダーの秒数だけ待ちます。単一項目の呼び出しを何度も行うより、バッチ呼び出しを 1 回行うほうが適しています。

よくあるエラー: 401 はログインまたはセッションの失敗です。キー ID と秘密鍵が別々のキーファイルのものである、キーが無効化または期限切れになっている、あるいはサーバーの時計が noon の時計と 5 分以上ずれていて署名済みトークンが拒否された、といった原因が考えられます。403 PERMISSION_DENIED はサービスアカウントにその呼び出しのロールがないことを示します。Partner ポータルの User Access > Manage Role でロールを追加してください。400 INVALID_ARGUMENT は対象のフィールドと理由を示します。価格項目の NOT_FOUND は、その国でその SKU の価格レコードがまだないことを意味するので、先に価格を設定してください。

ステップ 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 — Muse にコネクタを追加

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

Muse はリモート MCP サーバーをカスタムコネクタとして追加し、OAuth でサインインします。

1. Muse で Settings → Connectors を開き、Add custom connector を選びます。
2. MCP サーバーの URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を貼り付けます。
3. Muse が AnythingMCP のサインインページを開きます。サインインしてアクセスを承認します。
4. チャットで、noon Marketplace のツールが必要になる依頼を Muse にしてみましょう。

チャットから設定することもできます（Web、iOS・Android アプリ、WhatsApp）。Muse に次のメッセージを送ってください:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Muse は Meta のクラウドから接続するため、localhost は使えません。

利用可能なツール

プロンプトの例

• 「ドバイ倉庫で partner SKU TS-100-BLK、TS-100-WHT、TS-100-RED の在庫を確認して、10 個未満のものを教えてください。」
• 「SKU TS-100-BLK の UAE とサウジアラビアでの価格を確認してください。価格、MSRP、各オファーが公開中かどうか、オフラインのオファーがあればその原因も教えてください。」
• 「インテグレーション倉庫の今日の FBPI 注文を明細とステータス付きで一覧にして、まだ出荷していないものを教えてください。」
• 「エクスポートできるレポートの種類を見せてください。私が選んだものを開始して、ダウンロードリンクが用意できるまでステータスを確認してください。」
• 「新しいスマホケースを出品する前に、適切なカテゴリコードを探して、必須属性と、英語とアラビア語の両方の値が必要な属性を教えてください。」

FAQ

Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。

Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。

次のステップ

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