摘要
Salsify PXM API 适用于一个组织:产品及其属性值、数字资产、属性定义、列表成员、导出、导入运行和渠道运行。API 密钥(持有者)和组织 ID。
引导式设置
2 分钟将 Salsify 连接到 Cursor
开始 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
Salsify PXM API 适用于一个组织:产品及其属性值、数字资产、属性定义、列表成员、导出、导入运行和渠道运行。API 密钥(持有者)和组织 ID。
前提条件
查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
SALSIFY_ORG_ID, SALSIFY_API_TOKEN
第一步 — 获取凭据
设置大约需要 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 获取单个产品。属性 ID 是你在产品上看到的键;salsify_get_property 解释了一个。
产品: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 开始分页,每页最多 100;meta.total_entries 给出总数。分页在第 10,000 个结果处停止(422):对于更大的集合,请使用导出。组织可以在所有用户之间每小时发出 10,000 个请求(429 以上;头信息 x-ratelimit-remaining 和 x-ratelimit-reset)。错误以 422 形式返回,并附有错误列表;401 表示 API 密钥错误;400 伴随组织列表表示组织 ID 缺失或错误。
第二步 — 安装适配器
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
第三步 — 在 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 获取一个产品:所有属性值(属性 ID 和值对,多值属性的列表),系统字段… |
salsify_create_product | 从属性 ID 和值对创建一个产品;产品 ID 属性是必需的。不存在的属性 ID 会被创建为… |
salsify_update_product | 更新一个产品的属性值:仅发送的属性会发生变化;每个发送的值替换存储的值,null 移除它… |
salsify_upsert_products | 从属性值对象列表(每个对象都有产品 ID 属性)中创建或更新最多 100 个产品。返回… |
salsify_delete_product | 永久删除一个产品及其属性值。无法撤销。默认关闭 |
salsify_list_digital_assets | 列出数字资产(图像、视频、文档),可以通过过滤器进行缩小:salsify:id, salsify:name, salsify:url, salsify:format… |
salsify_get_digital_asset | 获取一个数字资产:salsify:id, salsify:name, salsify:url(下载链接),salsify:format, salsify:bytes, salsify:status(进行中… |
salsify_create_digital_asset | 从公共 URL 添加数字资产;Salsify 在后台下载它(salsify:status 进行中,然后完成)。可选 ID… |
salsify_update_digital_asset | 更新数字资产:自定义元数据、salsify:name 或 salsify:source_url 替换文件(这会创建一个新链接)。仅… |
salsify_get_property | 获取一个属性(属性)定义:salsify:id, salsify:name, salsify:data_type(字符串、富文本、数字、日期、布尔值、枚举… |
salsify_add_list_members | 通过 ID 将产品(或其他实体)添加到现有的 Salsify 列表中。列表 ID 是 Salsify 列表 URL 中的数字 |
salsify_remove_list_members | 从 Salsify 列表中移除产品(或其他实体)。产品本身保持不变 |
salsify_start_export | 启动产品、数字资产、属性(属性)、枚举值(attribute_value)或所有内容的导出文件。返回… |
salsify_get_export | 获取导出运行的状态:状态(运行中、完成、失败)、进度、预计剩余时间、失败原因,以及一旦… |
salsify_start_import_run | 运行已经在 Salsify 中配置的导入(例如从挂载点的 JSON 或 CSV 导入)。可以更改多个产品… |
salsify_get_import_run | 获取导入运行的状态:状态(运行中、完成、失败、已取消、已停止)、进度和错误。每 15… |
salsify_get_latest_channel_run | 获取渠道的最新运行(产品馈送或发布到零售商或网站):ID、状态(运行中、完成、失败)、时间戳… |
salsify_get_channel_run | 获取一个渠道的运行:状态、时间戳和产品导出 URL 一旦完成 |
salsify_start_channel_run | 启动一个新的渠道运行,重新生成其馈送,并且对于发布渠道,将其发送到零售商或网站。默认关闭… |
示例提示
- "品牌 Northwind 的哪些 Salsify 产品没有产品名称?"
- "显示产品 00012345678905 及其属性值。"
- "启动假日目录列表的导出,并告诉我何时准备好。"
- "我们零售商渠道的最后一次渠道运行何时结束,出现了哪些错误?"
- "将产品 00012345678905 和 00012345678912 添加到春季发布列表中。"
常见问题
令牌和组织 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 服务器吗? 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。
下一步
这份指南对你有帮助吗?