In breve
API PXM di Salsify per un'organizzazione: prodotti e i loro valori di proprietà, risorse digitali, definizioni di proprietà, appartenenza a liste, esportazioni, esecuzioni di importazione e esecuzioni di canale. Chiave API (bearer) e id dell'organizzazione.
Configurazione guidata
Collega Salsify a Gemini in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Salsify con la configurazione guidata e aggiungi il tuo URL MCP a Gemini. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Salsify
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Salsify, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Salsify + Gemini
API PXM di Salsify per un'organizzazione: prodotti e i loro valori di proprietà, risorse digitali, definizioni di proprietà, appartenenza a liste, esportazioni, esecuzioni di importazione e esecuzioni di canale. Chiave API (bearer) e id dell'organizzazione.
Requisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nel negozio dell'app quando selezioni il connettore). Le variabili ambientali richieste per questo connettore sono:
SALSIFY_ORG_ID, SALSIFY_API_TOKEN
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 3 minuti.
- Accedi a Salsify (idealmente come utente di integrazione dedicato con solo i diritti necessari) e apri il tuo profilo, Accesso API (https://app.salsify.com/app/profile/edit/api). Copia la chiave API (generane una se è vuota) in
SALSIFY_API_TOKEN. Essa agisce con i permessi di quell'utente e rimane valida fino a quando non viene rigenerata. - Copia l'id dell'organizzazione dalla barra degli indirizzi: la parte dopo
/orgs/, che inizia cons-(per esempios-1a2b3c4d-...). Incollalo inSALSIFY_ORG_ID.
L'accesso API dipende dalla tua licenza Salsify; chiedi al tuo contatto Salsify se il profilo non mostra alcuna chiave API. Il token viene inviato come bearer token.
Dove iniziare: salsify_list_products (con un filtro, o senza per tutti) e salsify_get_product per un prodotto. Gli id delle proprietà sono le chiavi che vedi sui prodotti; salsify_get_property ne spiega una.
Prodotti: salsify_list_products, salsify_get_product, salsify_create_product, salsify_update_product. I valori sono indicizzati per id di proprietà (per esempio Brand, Product Name); una proprietà a più valori richiede una lista; null cancella un valore. Gli id delle proprietà sconosciute vengono creati come proprietà di testo, quindi controlla l'ortografia. salsify_upsert_products (in blocco) e salsify_delete_product sono installati disattivati.
Risorse digitali: salsify_list_digital_assets, salsify_get_digital_asset, salsify_create_digital_asset (da un URL pubblico; elaborato in background), salsify_update_digital_asset. Collega un asset a un prodotto impostando la proprietà asset del prodotto all'id dell'asset.
Proprietà e liste: salsify_get_property, salsify_add_list_members, salsify_remove_list_members. Non esiste una chiamata documentata per elencare ogni proprietà: esporta con l'attributo entity_type.
Esportazioni e importazioni: salsify_start_export poi salsify_get_export fino al completamento; l'url è un link temporaneo al file. salsify_get_import_run legge un'esecuzione di importazione; salsify_start_import_run (esegue un'importazione configurata, possibilmente su molti prodotti) è disattivato.
Canali: salsify_get_latest_channel_run e salsify_get_channel_run mostrano lo stato e il link del feed di un canale; salsify_start_channel_run è disattivato perché un'esecuzione può pubblicare su un rivenditore. Le rotte del canale sono utilizzate dalle integrazioni di Salsify ma sono solo parzialmente descritte nella documentazione pubblica.
Filtri: Linguaggio di filtro Salsify: ='Brand':'Acme' (uguale), ='Product Name':^'Mug' (inizia con), ='Price':>'10', =list:12345 (membri della lista); unisci le condizioni con una virgola per AND. I nomi e i valori delle proprietà devono essere racchiusi tra virgolette singole.
Paging e limiti: pagina da 1 e per_page fino a 100; meta.total_entries fornisce il totale. Il paging si interrompe al 10.000° risultato (422): usa un'esportazione per set più grandi. L'organizzazione può effettuare 10.000 richieste all'ora tra tutti i suoi utenti (429 sopra; intestazioni x-ratelimit-remaining e x-ratelimit-reset). Gli errori vengono restituiti come 422 con un elenco di errori; 401 significa che la chiave API è errata; 400 con un elenco di organizzazioni significa che l'id dell'organizzazione è mancante o errato.
Passo 2 — Installa l'adattatore
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
Passo 3 — Aggiungi il connettore in Gemini
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di
YOUR_MCP_API_KEY. - Salva il file e riavvia
gemini. - Esegui
/mcpin Gemini CLI (oppuregemini mcp listdal terminale):anythingmcpdovrebbe risultare connesso. - Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di
Salsify.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
salsify_list_products | Elenca i prodotti, eventualmente ristretti da un filtro Salsify: ogni valore di proprietà di ciascun prodotto come coppie di id e valori di proprietà, più sistema… |
salsify_get_product | Ottieni un prodotto tramite il suo id prodotto: tutti i valori di proprietà (coppie di id e valori di proprietà, liste per proprietà a più valori), campi di sistema… |
salsify_create_product | Crea un prodotto da coppie di id e valori di proprietà; la proprietà id prodotto è obbligatoria. Un id di proprietà che non esiste ancora viene creato come… |
salsify_update_product | Aggiorna i valori di proprietà di un prodotto: solo le proprietà inviate cambiano; ciascun valore inviato sostituisce quello memorizzato, null lo rimuove.… |
salsify_upsert_products | Crea o aggiorna fino a 100 prodotti in una sola chiamata da un elenco di oggetti valore di proprietà (ciascuno con la proprietà id prodotto). Risponde con il… |
salsify_delete_product | Elimina un prodotto in modo permanente, con i suoi valori di proprietà. Non può essere annullato. Installato disattivato |
salsify_list_digital_assets | Elenca risorse digitali (immagini, video, documenti), eventualmente ristrette da un filtro: salsify:id, salsify:name, salsify:url, salsify:format… |
salsify_get_digital_asset | Ottieni una risorsa digitale: salsify:id, salsify:name, salsify:url (link di download), salsify:format, salsify:bytes, salsify:status (in_progress… |
salsify_create_digital_asset | Aggiungi una risorsa digitale da un URL pubblico; Salsify la scarica in background (salsify:status in_progress, poi completata). Id opzionale… |
salsify_update_digital_asset | Aggiorna una risorsa digitale: metadati personalizzati, salsify:name, o salsify:source_url per sostituire il file (che crea un nuovo link). Solo il… |
salsify_get_property | Ottieni una definizione di proprietà (attributo): salsify:id, salsify:name, salsify:data_type (stringa, rich_text, numero, data, booleano, enumerato… |
salsify_add_list_members | Aggiungi prodotti (o altre entità) a un elenco Salsify esistente tramite i loro id. L'id della lista è il numero nell'URL della lista in Salsify |
salsify_remove_list_members | Rimuovi prodotti (o altre entità) da una lista Salsify. I prodotti stessi rimangono |
salsify_start_export | Avvia un file di esportazione di prodotti, risorse digitali, proprietà (attributo), valori enumerati (attribute_value) o tutto (tutto). Restituisce… |
salsify_get_export | Ottieni lo stato di un'esecuzione di esportazione: stato (in esecuzione, completato, fallito), progresso, tempo_stimato_rimanente, motivo_fallimento e, una volta… |
salsify_start_import_run | Esegui un'importazione già configurata in Salsify (ad esempio un'importazione JSON o CSV da un punto di montaggio). Può cambiare molti prodotti a… |
salsify_get_import_run | Ottieni lo stato di un'esecuzione di importazione: stato (in esecuzione, completato, fallito, annullato, fermato), progresso e errori. Non interrogare più di ogni 15… |
salsify_get_latest_channel_run | Ottieni l'ultima esecuzione di un canale (un feed di prodotto o pubblicazione a un rivenditore o sito): id, stato (in esecuzione, completato, fallito), timestamp… |
salsify_get_channel_run | Ottieni un'esecuzione di un canale: stato, timestamp e product_export_url una volta completato |
salsify_start_channel_run | Avvia una nuova esecuzione di un canale, che rigenera il suo feed e, per i canali di pubblicazione, lo invia al rivenditore o al sito. Installato disattivato… |
Esempi di prompt
- "Quali prodotti Salsify del marchio Northwind non hanno nome prodotto?"
- "Mostra il prodotto 00012345678905 con i suoi valori di proprietà."
- "Avvia un'esportazione dell'elenco Catalogo Festivo e dimmi quando è pronta."
- "Quando è finita l'ultima esecuzione del canale del nostro canale rivenditore, e con quali errori?"
- "Aggiungi i prodotti 00012345678905 e 00012345678912 all'elenco Lancio Primaverile."
FAQ
Da dove provengono il token e l'id dell'organizzazione? La chiave API dal tuo profilo Salsify, Accesso API, idealmente di un utente di integrazione dedicato; l'id dell'organizzazione è la parte dell'indirizzo dopo /orgs/, che inizia con s-. L'accesso API dipende dalla tua licenza Salsify.
Cosa copre? Prodotti e i loro valori di proprietà, risorse digitali, definizioni di proprietà, appartenenza a liste, esportazioni, esecuzioni di importazione e esecuzioni di canale.
Quali strumenti sono installati disattivati? salsify_upsert_products, salsify_delete_product, salsify_start_import_run e salsify_start_channel_run, perché un'esecuzione di canale può pubblicare su un rivenditore. Attivali nella pagina del connettore solo se l'AI deve usarli.
Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.
Prossimi passi
Questa guida ti è stata utile?