概要
1つの組織のためのSalsify PXM API:製品とそのプロパティ値、デジタル資産、プロパティ定義、リストメンバーシップ、エクスポート、インポートラン、チャネルラン。APIキー(ベアラー)と組織ID。
ガイド付きセットアップ
Salsify を Cursor に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Salsify を接続して、MCP URL を Cursor に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Salsify のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスして利用してください。 サインインし、Connectors → Salsifyをクリックし、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Salsify + Cursor
1つの組織のためのSalsify PXM API:製品とそのプロパティ値、デジタル資産、プロパティ定義、リストメンバーシップ、エクスポート、インポートラン、チャネルラン。APIキー(ベアラー)と組織ID。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアに表示されます)。このコネクタに必要な環境変数は次のとおりです:
SALSIFY_ORG_ID, SALSIFY_API_TOKEN
ステップ1 — 資格情報を取得する
セットアップには約3分かかります。
- Salsifyにサインインし(理想的には必要な権限のみを持つ専用の統合ユーザーとして)、プロフィールを開き、APIアクセス(https://app.salsify.com/app/profile/edit/api)を選択します。**APIキー**をコピーし(空の場合は生成してください)、`SALSIFY_API_TOKEN`に貼り付けます。このキーはそのユーザーの権限で動作し、再生成されるまで有効です。
- アドレスバーから組織IDをコピーします:
/orgs/の後の部分で、s-から始まります(例:s-1a2b3c4d-...)。これをSALSIFY_ORG_IDに貼り付けます。
APIアクセスはSalsifyライセンスに依存します。プロフィールにAPIキーが表示されない場合は、Salsifyの担当者に確認してください。トークンはベアラートークンとして送信されます。
開始する場所:salsify_list_products(フィルターあり、またはすべての製品)およびsalsify_get_productで1つの製品を取得します。プロパティIDは製品で見るキーです;salsify_get_propertyは1つのプロパティを説明します。
製品:salsify_list_products, salsify_get_product, salsify_create_product, salsify_update_product。値はプロパティIDでキー付けされます(例:Brand, Product Name);マルチバリューのプロパティはリストを取ります;nullは値をクリアします。未知のプロパティIDはテキストプロパティとして作成されるため、スペルを確認してください。salsify_upsert_products(バルク)およびsalsify_delete_productはインストール時にオフになっています。
デジタル資産:salsify_list_digital_assets, salsify_get_digital_asset, salsify_create_digital_asset(公開URLから;バックグラウンドで処理されます)、salsify_update_digital_asset。製品の資産プロパティを資産IDに設定することで、資産を製品にリンクします。
プロパティとリスト:salsify_get_property, salsify_add_list_members, salsify_remove_list_members。すべてのプロパティをリストするための文書化された呼び出しはありません:entity_type属性でエクスポートします。
エクスポートとインポート:salsify_start_exportの後にsalsify_get_exportを実行し、完了するまで待ちます;URLはファイルへの一時リンクです。salsify_get_import_runはインポートランを読み取ります;salsify_start_import_run(多くの製品にわたる構成されたインポートを実行)はオフになっています。
チャネル:salsify_get_latest_channel_runおよびsalsify_get_channel_runはチャネルの状態とフィードリンクを表示します;salsify_start_channel_runは、ランが小売業者に公開できるためオフになっています。チャネルルートはSalsifyの独自の統合で使用されますが、公開リファレンスでは部分的にしか説明されていません。
フィルター:Salsifyフィルター言語:='Brand':'Acme'(等しい)、='Product Name':^'Mug'(始まる)、='Price':>'10'、=list:12345(リストメンバー);AND条件をカンマで結合します。プロパティ名と値はシングルクォートで囲みます。
ページングと制限:ページは1から始まり、per_pageは最大100;meta.total_entriesは合計を示します。ページングは10,000件目の結果で停止します(422):より大きなセットにはエクスポートを使用してください。組織はすべてのユーザーに対して1時間あたり10,000リクエストを行うことができます(429以上;ヘッダーx-ratelimit-remainingおよびx-ratelimit-reset)。エラーは422でエラーリストとして返されます;401はAPIキーが間違っていることを意味します;400は組織IDが欠落または間違っていることを示します。
ステップ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" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、Cursor を再起動します。
- Cursor → Settings → MCP を開き、
anythingmcpが一覧にあり接続済みであることを確認します。 - チャットを始めましょう — エージェントが
Salsifyのツールを呼び出せるようになりました。
利用可能なツール
| ツール | 機能 |
|---|---|
salsify_list_products | 製品をリスト表示し、オプションでSalsifyフィルターで絞り込みます:各製品のプロパティ値をプロパティIDと値のペアとして表示し、システム… |
salsify_get_product | 製品IDで1つの製品を取得します:すべてのプロパティ値(プロパティIDと値のペア、マルチバリューのプロパティ用のリスト)、システムフィールド… |
salsify_create_product | プロパティIDと値のペアから製品を作成します;製品IDプロパティは必須です。まだ存在しないプロパティIDは作成されます… |
salsify_update_product | 1つの製品のプロパティ値を更新します:送信されたプロパティのみが変更されます;送信された各値は保存された値を置き換え、nullはそれを削除します… |
salsify_upsert_products | プロパティ値オブジェクトのリストから1回の呼び出しで最大100製品を作成または更新します(各オブジェクトには製品IDプロパティがあります)。応答には… |
salsify_delete_product | 1つの製品をそのプロパティ値とともに永久に削除します。元に戻すことはできません。インストール時はオフになっています |
salsify_list_digital_assets | デジタル資産(画像、動画、文書)をリスト表示し、オプションでフィルターで絞り込みます:salsify:id, salsify:name, salsify:url, salsify:format… |
salsify_get_digital_asset | 1つのデジタル資産を取得します:salsify:id, salsify:name, salsify:url(ダウンロードリンク)、salsify:format, salsify:bytes, salsify:status(in_progress… |
salsify_create_digital_asset | 公開URLからデジタル資産を追加します;Salsifyがバックグラウンドでダウンロードします(salsify:status in_progress、その後完了)。オプションのID… |
salsify_update_digital_asset | デジタル資産を更新します:カスタムメタデータ、salsify:name、またはファイルを置き換えるためのsalsify:source_url(新しいリンクを作成します)。送信された… |
salsify_get_property | 1つのプロパティ(属性)定義を取得します:salsify:id, salsify:name, salsify:data_type(string, rich_text, number, date, boolean, enumerated… |
salsify_add_list_members | 既存のSalsifyリストに製品(または他のエンティティ)をIDで追加します。リストIDはSalsifyのリストURLの番号です |
salsify_remove_list_members | Salsifyリストから製品(または他のエンティティ)を削除します。製品自体は残ります |
salsify_start_export | 製品、デジタル資産、プロパティ(属性)、列挙値(attribute_value)またはすべて(all)のエクスポートファイルを開始します。返される… |
salsify_get_export | エクスポートランの状態を取得します:ステータス(running, completed, failed)、進捗、estimated_time_remaining、failure_reason、そして一度… |
salsify_start_import_run | Salsifyで既に構成されているインポートを実行します(例えば、マウントポイントからのJSONまたはCSVインポート)。多くの製品を変更できます… |
salsify_get_import_run | インポートランの状態を取得します:ステータス(running, completed, failed, canceled, stopped)、進捗とエラー。15分ごとにポーリングしないでください… |
salsify_get_latest_channel_run | チャネルの最新のランを取得します(小売業者やサイトへの製品フィードまたは公開):ID、ステータス(running, completed, failed)、タイムスタンプ… |
salsify_get_channel_run | チャネルの1つのランを取得します:ステータス、タイムスタンプ、完了時のproduct_export_url |
salsify_start_channel_run | チャネルの新しいランを開始します。これによりフィードが再生成され、小売業者やサイトに公開チャネルが送信されます。インストール時はオフになっています… |
例のプロンプト
- "ブランドNorthwindのSalsify製品で、製品名がないものはどれですか?"
- "製品00012345678905とそのプロパティ値を表示してください。"
- "リストHoliday Catalogのエクスポートを開始し、準備ができたら教えてください。"
- "私たちの小売業者チャネルの最後のチャネルランはいつ終了し、どのようなエラーがありましたか?"
- "製品00012345678905と00012345678912をリストSpring Launchに追加してください。"
FAQ
トークンと組織IDはどこから来ますか? SalsifyプロフィールのAPIアクセスからのAPIキー、理想的には専用の統合ユーザーのものです;組織IDはアドレスの/orgs/の後の部分で、s-から始まります。APIアクセスはSalsifyライセンスに依存します。
何をカバーしていますか? 製品とそのプロパティ値、デジタル資産、プロパティ定義、リストメンバーシップ、エクスポート、インポートラン、チャネルラン。
どのツールがオフになっていますか? salsify_upsert_products、salsify_delete_product、salsify_start_import_run、およびsalsify_start_channel_runは、小売業者に公開できるためオフになっています。AIが使用する必要がある場合のみ、コネクタページでオンにしてください。
Cursor の無料プランでカスタム MCP サーバーは使えますか? はい — MCP は Hobby、Pro、Business の各プランで利用できます。
次のステップ
このガイドは役に立ちましたか?