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 Microsoft Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Salsify in der geführten Einrichtung und trag deine MCP-URL in Microsoft Copilot 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 + Microsoft Copilot
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 Microsoft Copilot 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.
Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
Salsify-Tools braucht. - Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.
Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, 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.
Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.
Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.
Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.
Nächste Schritte
War dieser Guide hilfreich?