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

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

Meta Catalog + Cursor

Meta の商品カタログ（コマースマネージャ）を AI でチェック・管理します。価格、在庫、審査ステータス付きの商品、商品セット、データフィードとアップロードエラー、カタログの診断を確認できます。あなたの確認後に商品の一括更新、追加、削除も行えます（インストール時はオフ）。

前提条件

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

META_CATALOG_ACCESS_TOKEN, META_CATALOG_BUSINESS_ID

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

セットアップは約 10 分です。コマースマネージャに商品カタログがある Meta のビジネスポートフォリオと、Meta アプリが必要です。

1. developers.facebook.com/apps/creation を開き、ビジネスポートフォリオに接続したビジネスアプリを作成します。Meta Ads コネクターを使っている場合は、そのアプリを再利用できます。
2. おすすめは期限切れにならないトークンです。Business Settings で Users → System users を開き、システムユーザーを追加します。Assign assets → Catalogs でカタログを割り当てます（Manage catalog、AI に読み取りだけさせる場合は View catalog）。Generate token をクリックしてアプリを選び、有効期限に Never を選んで catalog_management と business_management にチェックを入れます。その前にビジネスポートフォリオの認証を求められることがあります。
3. トークンを META_CATALOG_ACCESS_TOKEN に貼り付けます。トークンは EA で始まります。Bearer という語は付けずに貼り付けてください。
4. ビジネスポートフォリオの ID を META_CATALOG_BUSINESS_ID に入力します。数字のみで、Business Settings → Business info、または business.facebook.com のアドレスバーにある business_id= で確認できます。システムユーザーのトークンでは meta_catalog_list_businesses が空のリストを返すため、ID は Business Settings から取得してください。
5. コネクターをインストールし、meta_catalog_check_permissions を実行します。2 つの権限がどちらも granted と表示されれば OK です。続いて meta_catalog_list_catalogs で、カタログと商品数が一覧表示されます。

ユーザートークンを使う場合: Graph API Explorer で作るユーザートークン（自分のアプリ、User Token、同じ 2 つの権限）の有効期間は 1 から 2 時間ほどです。任意の META_APP_ID と META_APP_SECRET（アプリの App settings → Basic）も入力すると、AnythingMCP が最初の呼び出しで約 60 日有効な長期トークンに交換し、残りが 10 日を切ると更新します。Meta Ads コネクターと同じ仕組みです。入力しない場合は Access Token Debugger（Extend Access Token）で自分で延長し、60 日が過ぎる前に差し替えてください。期限が近づくとコネクターのページに警告が出ます。システムユーザーのトークンでは、どちらも空のままにします。

読み取れるデータ: 自社が所有するカタログと、クライアントから共有されたカタログ（代理店やパートナーから見た形で、各カタログでのロール付き）。SKU（retailer_id）、商品名、価格とセール価格、在庫状況、在庫数、審査ステータス（approved、pending、rejected、outdated）、表示設定、エラーと却下理由を含む商品。フィルタールールと所属商品を含む商品セット。スケジュール、アップロード履歴（検出、保存、無効、削除された件数）、行番号と SKU 付きのアップロードエラーを含むデータフィード。そしてコマースマネージャに表示される MUST_FIX または OPPORTUNITY の診断です。

商品が表示されない理由を調べる: AI はまず meta_catalog_get_diagnostics を確認し、次にエラーのある商品や特定の審査ステータスの商品を一覧にして、meta_catalog_get_product で 1 つの商品の正確なエラーと却下理由を読み取ります。フィードの問題は meta_catalog_list_feeds、meta_catalog_list_feed_uploads、meta_catalog_list_upload_errors の順にたどります。

商品ごとに 2 つの ID: Meta は商品ごとに独自の ID を付け、あなたの SKU は retailer_id（フィードの id 列）になります。AI は個別の商品には Meta の ID を、一括変更やフィルターには SKU を使います。価格は 19.99 EUR のように通貨付きのテキストで返されます。

変更は広告とショップに反映されます: カタログは Advantage+ カタログ広告、Facebook と Instagram のショップ、商品タグ付けに使われるため、カタログの変更はそこにも表示されます。スケジュールされたフィードが提供する商品は、次のフィードアップロードで上書きされます。変更を残したい場合は、フィードの元データを直すか補助フィードを使ってください。

インストール時はオフ: meta_catalog_batch_update_items、meta_catalog_create_product、meta_catalog_update_product、meta_catalog_delete_product。これらは顧客が広告やショップで目にする内容を変え、削除した商品は元に戻せず、追加し直すしかありません。AI にカタログを編集させたい場合は、管理者が 1 つずつ有効にできます。

変更の前に必ず確認: 有効にすると、AI は対象のカタログ、商品（商品名と SKU）、変更前と変更後の値を示し、あなたの承認を待ちます。バッチは最大 5,000 件の変更を受け付け（推奨は 3,000 件未満）、バックグラウンドで処理されます。AI は meta_catalog_check_batch_status で完了まで追跡し、エラーを報告します。

制限: Meta は API の呼び出しを制限しています。エラーコード 4、17、613、80009、80014（バッチの上限）が出たら、数分待ってから再試行します。

よくあるエラー: コード 190 はトークンが無効か期限切れであることを示すため、新しいトークンを作成してください。サブコード 467、460、458（ログアウト、パスワード変更、アプリ削除）が付いている場合はセッションが完全に終了しており、新しいトークンを保存するまでコネクターはトークンを送信しません。コード 10 と 200 から 299 は、権限が足りないか、システムユーザーがそのカタログにアクセスできないことを示します。カタログを割り当ててトークンを再生成してください。コード 100 はパラメーター、フィールド、フィルターのいずれかが間違っていることを示します。

このコネクターは、カタログ、フィード、商品セットの作成や削除、フィードのスケジュール変更やフィードファイルのアップロード、ローカライズされたカタログ、ピクセル、イベントソースの管理、カタログ広告の運用（Meta Ads コネクターの担当です）、Instagram 投稿への商品タグ付けは行いません。

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

利用可能なツール

プロンプトの例

• 「メインカタログの商品が却下されたり表示されなかったりするのはなぜですか。MUST_FIX の問題と、それぞれ何件の商品に影響しているかを教えてください。」
• 「商品フィードの前回のアップロードは成功しましたか。エラーを行番号と SKU 付きで見せてください。」
• 「商品セット『夏のセール』で、今在庫切れになっている商品はどれですか。」
• 「SKU TSHIRT-RED-M を 2,980 円、在庫ありに変更してください。何かを変える前に、変更前と変更後の値を見せてください。」
• 「クライアントから共有されたカタログと、それぞれの商品数を一覧にしてください。」

FAQ

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

次のステップ

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