Zusammenfassung
Salsify PXM API für eine Organisation: Produkte und deren Eigenschaftswerte, digitale Assets, Eigenschaftsdefinitionen, Listenmitgliedschaften, Exporte, Importläufe und Kanalläufe. API-Schlüssel (Bearer) und Organisations-ID.
Geführte Einrichtung
Salsify in 2 Minuten mit Meta Muse verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Salsify in der geführten Einrichtung und trag deine MCP-URL in Meta Muse ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für Salsify
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → Salsify, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
Salsify + Meta Muse
Salsify PXM API für eine Organisation: Produkte und deren Eigenschaftswerte, digitale Assets, Eigenschaftsdefinitionen, Listenmitgliedschaften, Exporte, Importläufe und Kanalläufe. API-Schlüssel (Bearer) und Organisations-ID.
Voraussetzungen
Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:
SALSIFY_ORG_ID, SALSIFY_API_TOKEN
Schritt 1 — Zugangsdaten erhalten
Die Einrichtung dauert etwa 3 Minuten.
- Melde dich bei Salsify an (idealerweise als dedizierter Integrationsbenutzer mit nur den Rechten, die er benötigt) und öffne dein Profil, API-Zugriff (https://app.salsify.com/app/profile/edit/api). Kopiere den API-Schlüssel (generiere einen, wenn er leer ist) in
SALSIFY_API_TOKEN. Er agiert mit den Berechtigungen dieses Benutzers und bleibt gültig, bis er regeneriert wird. - Kopiere die Organisations-ID aus der Adresszeile: den Teil nach
/orgs/, beginnend mits-(zum Beispiels-1a2b3c4d-...). Füge sie inSALSIFY_ORG_IDein.
Der API-Zugriff hängt von deiner Salsify-Lizenz ab; frage deinen Salsify-Kontakt, wenn das Profil keinen API-Schlüssel anzeigt. Das Token wird als Bearer-Token gesendet.
Wo anfangen: salsify_list_products (mit einem Filter oder ohne für alle) und salsify_get_product für ein Produkt. Die Eigenschafts-IDs sind die Schlüssel, die du bei Produkten siehst; salsify_get_property erklärt eine.
Produkte: salsify_list_products, salsify_get_product, salsify_create_product, salsify_update_product. Werte sind nach Eigenschafts-ID geordnet (zum Beispiel Brand, Product Name); eine mehrwertige Eigenschaft nimmt eine Liste; null löscht einen Wert. Unbekannte Eigenschafts-IDs werden als Text-Eigenschaften erstellt, also überprüfe die Schreibweise. salsify_upsert_products (Bulk) und salsify_delete_product sind standardmäßig deaktiviert.
Digitale Assets: salsify_list_digital_assets, salsify_get_digital_asset, salsify_create_digital_asset (von einer öffentlichen URL; im Hintergrund verarbeitet), salsify_update_digital_asset. Verlinke ein Asset mit einem Produkt, indem du die Asset-Eigenschaft des Produkts auf die Asset-ID setzt.
Eigenschaften und Listen: salsify_get_property, salsify_add_list_members, salsify_remove_list_members. Es gibt keinen dokumentierten Aufruf, um jede Eigenschaft aufzulisten: exportiere mit dem Attribut entity_type.
Exporte und Importe: salsify_start_export dann salsify_get_export, bis abgeschlossen; die URL ist ein temporärer Link zur Datei. salsify_get_import_run liest einen Importlauf; salsify_start_import_run (führt einen konfigurierten Import aus, möglicherweise über viele Produkte) ist deaktiviert.
Kanäle: salsify_get_latest_channel_run und salsify_get_channel_run zeigen den Status und den Feed-Link eines Kanals; salsify_start_channel_run ist deaktiviert, da ein Lauf an einen Einzelhändler veröffentlichen kann. Die Kanalrouten werden von Salsifys eigenen Integrationen verwendet, sind aber nur teilweise in der öffentlichen Referenz beschrieben.
Filter: Salsify-Filter-Sprache: ='Brand':'Acme' (gleich), ='Product Name':^'Mug' (beginnt mit), ='Price':>'10', =list:12345 (Listenmitglieder); Bedingungen mit einem Komma für UND verbinden. Eigenschaftsnamen und Werte stehen in einfachen Anführungszeichen.
Paging und Limits: Seite von 1 und per_page bis zu 100; meta.total_entries gibt die Gesamtzahl an. Paging stoppt beim 10.000. Ergebnis (422): benutze einen Export für größere Mengen. Die Organisation kann 10.000 Anfragen pro Stunde über alle ihre Benutzer hinweg stellen (429 darüber; Header x-ratelimit-remaining und x-ratelimit-reset). Fehler kommen als 422 mit einer Fehlerliste; 401 bedeutet, dass der API-Schlüssel falsch ist; 400 mit einer Liste von Organisationen bedeutet, dass die Organisations-ID fehlt oder falsch ist.
Schritt 2 — Adapter installieren
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
Schritt 3 — Connector in Muse hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.
- Öffne in Muse Settings → Connectors und wähle Add custom connector.
- Füge die MCP-Server-URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDein. - Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
- Bitte Muse im Chat um etwas, wofür es die
Salsify-Tools braucht.
Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:
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
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
salsify_list_products | Listet Produkte auf, optional eingegrenzt durch einen Salsify-Filter: jeder Eigenschaftswert jedes Produkts als Eigenschafts-ID und Wertpaare, plus System… |
salsify_get_product | Holt ein Produkt nach seiner Produkt-ID: alle Eigenschaftswerte (Eigenschafts-ID und Wertpaare, Listen für mehrwertige Eigenschaften), Systemfelder… |
salsify_create_product | Erstellt ein Produkt aus Eigenschafts-ID und Wertpaaren; die Produkt-ID-Eigenschaft ist erforderlich. Eine Eigenschafts-ID, die noch nicht existiert, wird als… |
salsify_update_product | Aktualisiert Eigenschaftswerte eines Produkts: nur die gesendeten Eigenschaften ändern sich; jeder gesendete Wert ersetzt den gespeicherten, null entfernt ihn.… |
salsify_upsert_products | Erstellt oder aktualisiert bis zu 100 Produkte in einem Aufruf aus einer Liste von Objekten mit Eigenschaftswerten (jedes mit der Produkt-ID-Eigenschaft). Antworten mit den… |
salsify_delete_product | Löscht ein Produkt dauerhaft, mit seinen Eigenschaftswerten. Kann nicht rückgängig gemacht werden. Standardmäßig deaktiviert |
salsify_list_digital_assets | Listet digitale Assets (Bilder, Videos, Dokumente) auf, optional eingegrenzt durch einen Filter: salsify:id, salsify:name, salsify:url, salsify:format… |
salsify_get_digital_asset | Holt ein digitales Asset: salsify:id, salsify:name, salsify:url (Download-Link), salsify:format, salsify:bytes, salsify:status (in_progress… |
salsify_create_digital_asset | Fügt ein digitales Asset von einer öffentlichen URL hinzu; Salsify lädt es im Hintergrund herunter (salsify:status in_progress, dann abgeschlossen). Optionale ID… |
salsify_update_digital_asset | Aktualisiert ein digitales Asset: benutzerdefinierte Metadaten, salsify:name oder salsify:source_url, um die Datei zu ersetzen (was einen neuen Link erstellt). Nur die… |
salsify_get_property | Holt eine Eigenschaft (Attribut) Definition: salsify:id, salsify:name, salsify:data_type (string, rich_text, number, date, boolean, enumerated… |
salsify_add_list_members | Fügt Produkte (oder andere Entitäten) einer bestehenden Salsify-Liste nach ihren IDs hinzu. Die Listen-ID ist die Nummer in der Listen-URL in Salsify |
salsify_remove_list_members | Entfernt Produkte (oder andere Entitäten) aus einer Salsify-Liste. Die Produkte selbst bleiben |
salsify_start_export | Startet eine Exportdatei von Produkten, digitalen Assets, Eigenschaften (Attribut), enumerierten Werten (attribute_value) oder allem (alle). Gibt… |
salsify_get_export | Holt den Status eines Exportlaufs: Status (laufend, abgeschlossen, fehlgeschlagen), Fortschritt, geschätzte verbleibende Zeit, Fehlerursache und, sobald… |
salsify_start_import_run | Führt einen Import aus, der bereits in Salsify konfiguriert ist (zum Beispiel einen JSON- oder CSV-Import von einem Mount-Punkt). Es kann viele Produkte ändern… |
salsify_get_import_run | Holt den Status eines Importlaufs: Status (laufend, abgeschlossen, fehlgeschlagen, abgebrochen, gestoppt), Fortschritt und Fehler. Poll nicht mehr als alle 15… |
salsify_get_latest_channel_run | Holt den letzten Lauf eines Kanals (eines Produkt-Feeds oder einer Veröffentlichung an einen Einzelhändler oder eine Website): ID, Status (laufend, abgeschlossen, fehlgeschlagen), Zeitstempel… |
salsify_get_channel_run | Holt einen Lauf eines Kanals: Status, Zeitstempel und product_export_url, sobald abgeschlossen |
salsify_start_channel_run | Startet einen neuen Lauf eines Kanals, der seinen Feed regeneriert und, für veröffentlichende Kanäle, ihn an den Einzelhändler oder die Website sendet. Standardmäßig deaktiviert… |
Beispiel-Eingabeaufforderungen
- "Welche Salsify-Produkte der Marke Northwind haben keinen Produktnamen?"
- "Zeige Produkt 00012345678905 mit seinen Eigenschaftswerten."
- "Starte einen Export der Liste Holiday Catalog und sag mir, wenn er bereit ist."
- "Wann hat der letzte Kanallauf unseres Einzelhandelskanals geendet, und mit welchen Fehlern?"
- "Füge die Produkte 00012345678905 und 00012345678912 der Liste Spring Launch hinzu."
FAQ
Woher kommen das Token und die Organisations-ID? Der API-Schlüssel aus deinem Salsify-Profil, API-Zugriff, idealerweise von einem dedizierten Integrationsbenutzer; die Organisations-ID ist der Teil der Adresse nach /orgs/, beginnend mit s-. Der API-Zugriff hängt von deiner Salsify-Lizenz ab.
Was deckt es ab? Produkte und deren Eigenschaftswerte, digitale Assets, Eigenschaftsdefinitionen, Listenmitgliedschaften, Exporte, Importläufe und Kanalläufe.
Welche Tools sind standardmäßig deaktiviert? salsify_upsert_products, salsify_delete_product, salsify_start_import_run und salsify_start_channel_run, da ein Kanallauf an einen Einzelhändler veröffentlichen kann. Schalte sie auf der Connector-Seite nur ein, wenn die KI sie verwenden soll.
Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.
Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.
Nächste Schritte
War dieser Guide hilfreich?