Кратко
Salsify PXM API для одной организации: продукты и их значения свойств, цифровые активы, определения свойств, членство в списках, экспорты, запуски импорта и каналы. API-ключ (bearer) и идентификатор организации.
Пошаговая настройка
Подключи Salsify к Claude за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Salsify в пошаговой настройке и добавь свой MCP URL в Claude. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
AnythingMCP есть в каталоге коннекторов Claude: добавьте его в Claude в один клик (откроется в новой вкладке), затем войдите и выберите, какие MCP-серверы может использовать Claude.
Попробуй спросить
Примеры промптов для Salsify
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Salsify, вставь свои учетные данные, создай MCP API-ключ, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Salsify + Claude
Salsify PXM API для одной организации: продукты и их значения свойств, цифровые активы, определения свойств, членство в списках, экспорты, запуски импорта и каналы. API-ключ (bearer) и идентификатор организации.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
SALSIFY_ORG_ID, SALSIFY_API_TOKEN
Шаг 1 — Получи учетные данные
Настройка занимает около 3 минут.
- Войди в Salsify (желательно как выделенный пользователь интеграции с только необходимыми правами) и открой свой профиль, API доступ (https://app.salsify.com/app/profile/edit/api). Скопируй API-ключ (сгенерируй один, если пусто) в
SALSIFY_API_TOKEN. Он действует с правами этого пользователя и остается действительным, пока не будет сгенерирован заново. - Скопируй идентификатор организации из адресной строки: часть после
/orgs/, начинающуюся сs-(например,s-1a2b3c4d-...). Вставь его вSALSIFY_ORG_ID.
Доступ к API зависит от твоей лицензии Salsify; спроси своего контактного лица в Salsify, если в профиле нет API-ключа. Токен отправляется как bearer токен.
С чего начать: salsify_list_products (с фильтром или без для всех) и salsify_get_product для одного продукта. Идентификаторы свойств — это ключи, которые ты видишь на продуктах; salsify_get_property объясняет одно из них.
Продукты: salsify_list_products, salsify_get_product, salsify_create_product, salsify_update_product. Значения индексируются по идентификатору свойства (например, Brand, Product Name); многозначное свойство принимает список; null очищает значение. Неизвестные идентификаторы свойств создаются как текстовые свойства, поэтому проверь написание. salsify_upsert_products (оптом) и salsify_delete_product установлены выключенными.
Цифровые активы: salsify_list_digital_assets, salsify_get_digital_asset, salsify_create_digital_asset (из публичного URL; обрабатывается в фоновом режиме), salsify_update_digital_asset. Свяжи актив с продуктом, установив свойство актива продукта на идентификатор актива.
Свойства и списки: 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): используй экспорт для больших наборов. Организация может делать 10,000 запросов в час для всех своих пользователей (429 выше; заголовки x-ratelimit-remaining и x-ratelimit-reset). Ошибки приходят как 422 с списком ошибок; 401 означает, что API-ключ неверен; 400 со списком организаций означает, что идентификатор организации отсутствует или неверен.
Шаг 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 — Добавь коннектор в Claude
URL твоего сервера: в AnythingMCP открой MCP Servers → сервер, на котором находится этот коннектор, и скопируй его URL (
https://cloud.anythingmcp.com/mcp/…). Используй его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Рекомендуемый путь: работает на claude.ai web без редактирования любого конфигурационного файла.
- В Claude открой Plugins (на некоторых тарифах пока Customize) → Connectors.
- Нажми + Add, затем Add custom connector.
- Введи имя, например
Salsify, и URL удаленного MCP сервераhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Continue, оставь найденные настройки и снова нажми Continue. - Выбери Sign in now, нажми Add и войди в AnythingMCP (OAuth), чтобы разрешить доступ.
Все инструменты ниже появятся в твоем чате: начни вводить подсказки.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
salsify_list_products | Перечисляет продукты, возможно, сужая по фильтру Salsify: каждое значение свойства каждого продукта в виде пар идентификатор свойства и значение, плюс система… |
salsify_get_product | Получает один продукт по его идентификатору продукта: все значения свойств (пары идентификатор свойства и значение, списки для многозначных свойств), системные поля… |
salsify_create_product | Создает продукт из пар идентификатор свойства и значения; свойство идентификатора продукта обязательно. Идентификатор свойства, который еще не существует, создается как… |
salsify_update_product | Обновляет значения свойств одного продукта: только отправленные свойства изменяются; каждое отправленное значение заменяет сохраненное, null удаляет его.… |
salsify_upsert_products | Создает или обновляет до 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 (in_progress… |
salsify_create_digital_asset | Добавляет цифровой актив из публичного URL; Salsify загружает его в фоновом режиме (salsify:status in_progress, затем завершено). Необязательный идентификатор… |
salsify_update_digital_asset | Обновляет цифровой актив: пользовательские метаданные, salsify:name или salsify:source_url для замены файла (что создает новую ссылку). Только… |
salsify_get_property | Получает одно определение свойства (атрибута): salsify:id, salsify:name, salsify:data_type (строка, rich_text, число, дата, логическое, перечисленное… |
salsify_add_list_members | Добавляет продукты (или другие сущности) в существующий список Salsify по их идентификаторам. Идентификатор списка — это номер в URL списка в Salsify |
salsify_remove_list_members | Удаляет продукты (или другие сущности) из списка Salsify. Продукты остаются сами по себе |
salsify_start_export | Запускает экспортный файл продуктов, цифровых активов, свойств (атрибутов), перечисленных значений (attribute_value) или всего (всех). Возвращает… |
salsify_get_export | Получает состояние запуска экспорта: статус (в процессе, завершено, не удалось), прогресс, estimated_time_remaining, failure_reason и, как только… |
salsify_start_import_run | Запускает импорт, который уже настроен в Salsify (например, импорт JSON или CSV из точки монтирования). Он может изменить много продуктов… |
salsify_get_import_run | Получает состояние запуска импорта: статус (в процессе, завершено, не удалось, отменено, остановлено), прогресс и ошибки. Не опрашивай чаще, чем раз в 15… |
salsify_get_latest_channel_run | Получает последний запуск канала (фид продукта или публикация в ритейлере или на сайте): id, статус (в процессе, завершено, не удалось), временные метки… |
salsify_get_channel_run | Получает один запуск канала: статус, временные метки и product_export_url после завершения |
salsify_start_channel_run | Запускает новый запуск канала, который регенерирует его фид и, для публикуемых каналов, отправляет его ритейлеру или на сайт. Установлен выключенным… |
Примеры подсказок
- "Какие продукты Salsify бренда Northwind не имеют названия продукта?"
- "Покажи продукт 00012345678905 с его значениями свойств."
- "Начни экспорт списка Holiday Catalog и сообщи мне, когда он будет готов."
- "Когда завершился последний запуск канала нашего ритейлера и с какими ошибками?"
- "Добавь продукты 00012345678905 и 00012345678912 в список Spring Launch."
Часто задаваемые вопросы
Работает ли это с Claude Code так же, как и с Claude Desktop? Да, укажи оба на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Откуда берутся токен и идентификатор организации? API-ключ из твоего профиля Salsify, API доступ, желательно от выделенного пользователя интеграции; идентификатор организации — это часть адреса после /orgs/, начинающаяся с s-. Доступ к API зависит от твоей лицензии Salsify.
Что это охватывает? Продукты и их значения свойств, цифровые активы, определения свойств, членство в списках, экспорты, запуски импорта и каналы.
Какие инструменты установлены выключенными? salsify_upsert_products, salsify_delete_product, salsify_start_import_run и salsify_start_channel_run, потому что запуск канала может публиковать в ритейлер. Включай их на странице коннектора только если ИИ должен их использовать.
Следующие шаги
- Страница коннектора
- Подключение к ChatGPT
- Подключение к Cursor
- Подключение к Gemini
- Подключение к Meta Muse
- Подключение к Microsoft Copilot
Это руководство помогло?