In breve
API di Squarespace Commerce per un sito: ordini e evasione con tracciamento, livelli di inventario e aggiustamenti di stock, prodotti e varianti, profili e contatti dei clienti, e transazioni finanziarie. Portatore di chiave API.
Configurazione guidata
Collega Squarespace Commerce a Cursor in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Squarespace Commerce con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. 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 Squarespace Commerce
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 → Squarespace Commerce, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Squarespace Commerce + Cursor
API di Squarespace Commerce per un sito: ordini e evasione con tracciamento, livelli di inventario e aggiustamenti di stock, prodotti e varianti, profili e contatti dei clienti, e transazioni finanziarie. Portatore di chiave API.
Requisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili ambientali richieste per questo connettore sono:
SQUARESPACE_API_KEY
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 3 minuti.
- Accedi al sito Squarespace. Nella navigazione a sinistra apri Impostazioni, scorri fino a Avanzate e clicca su Chiavi API per sviluppatori. Le chiavi API necessitano di un piano Commerce Advanced.
- Clicca su Genera chiave, assegnale un nome e scegli le autorizzazioni: Ordini (Leggi e Scrivi per evadere), Inventario (Leggi e Scrivi per modificare lo stock), Prodotti (Solo lettura), Profili, Contatti e Transazioni (Solo lettura).
- Copia la chiave in
SQUARESPACE_API_KEY. Squarespace la mostra solo una volta; non scade finché il sito è attivo.
Ogni chiamata include Authorization: Bearer con la chiave e un'intestazione User-Agent, che Squarespace richiede.
Dove iniziare: squarespace_commerce_get_website per confermare il sito, poi squarespace_commerce_list_orders con fulfillment_status PENDING per gli ordini da spedire.
Ordini: squarespace_commerce_list_orders, squarespace_commerce_get_order, e squarespace_commerce_fulfill_order (aggiunge spedizioni con tracciamento e segna l'ordine come evaso; può inviare un'email al cliente). Usa l'id dell'ordine nelle chiamate; orderNumber è ciò che vede il cliente. I rimborsi e le cancellazioni non fanno parte dell'API.
Inventario: squarespace_commerce_list_inventory, squarespace_commerce_get_inventory, squarespace_commerce_adjust_inventory. Ogni aggiustamento necessita di un nuovo idempotency_key (un UUID): reinviare la stessa chiave non fa nulla, il che rende i tentativi sicuri.
Prodotti: squarespace_commerce_list_products e squarespace_commerce_get_products (API Prodotti v2: tipi FISICO, SERVIZIO, CARTA_REGALO e DIGITALE; prezzi e stock su ogni variante). Le modifiche ai prodotti non sono incluse.
Persone: squarespace_commerce_list_contacts, squarespace_commerce_search_contacts, squarespace_commerce_get_contact (API Contatti) e il più vecchio squarespace_commerce_list_profiles, squarespace_commerce_get_profiles (API Profili, in modalità di manutenzione ma ancora quella con i totali degli ordini per cliente).
Denaro: squarespace_commerce_list_transactions e squarespace_commerce_get_transactions leggono pagamenti, rimborsi e commissioni per ordine o donazione; nulla qui muove denaro.
Paging e date: le liste restituiscono fino a 50 record con pagination.hasNextPage e pagination.nextPageCursor; passa il cursore da solo per ottenere la pagina successiva. modified_after e modified_before devono essere forniti insieme e sono in UTC ISO 8601. I valori monetari sono oggetti con currency e value (una stringa decimale). Gli strumenti di ricerca per id accettano fino a 50 id separati da virgole.
Limite di richiesta: 300 richieste al minuto per chiave; oltre a questo Squarespace risponde 429 e blocca la chiave per un minuto.
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 Cursor
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.
Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:
{
"mcpServers": {
"anythingmcp": {
"url": "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 Cursor.
- Apri Cursor → Settings → MCP e verifica che
anythingmcpsia elencato e connesso. - Inizia a chattare: l'agente ora può usare i tool di
Squarespace Commerce.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
squarespace_commerce_get_website | Legge informazioni di base sul sito Squarespace a cui appartiene la chiave API: id, siteTitle, url, timeZone, currency, language e location.… |
squarespace_commerce_list_orders | Elenca gli ordini, modificati più di recente per primi, 50 per pagina: id, orderNumber, createdOn, modifiedOn, channel, customerEmail, customerId… |
squarespace_commerce_get_order | Legge un ordine per id: gli stessi campi di squarespace_commerce_list_orders, con tutti gli articoli, sconti, note interne e evasioni |
squarespace_commerce_fulfill_order | Segna un ordine come evaso e aggiunge spedizioni con data di spedizione, corriere, servizio, numero di tracciamento e URL di tracciamento. should_send_notification… |
squarespace_commerce_list_inventory | Elenca lo stock per tutte le varianti di prodotto, 50 per pagina: variantId, sku, descriptor (nome del prodotto e opzioni), isUnlimited e quantity. Prossimo… |
squarespace_commerce_get_inventory | Legge lo stock in tempo reale di varianti specifiche: variantId, sku, descriptor, isUnlimited e quantity |
squarespace_commerce_adjust_inventory | Modifica lo stock delle varianti in una chiamata: incrementa o decrementa di una quantità, imposta una quantità finita, o rende le varianti illimitate. Necessita di un… |
squarespace_commerce_list_products | Elenca i prodotti, 50 per pagina: id, type (FISICO, SERVIZIO, CARTA_REGALO, DIGITALE), storePageId, name, description, url, urlSlug, tags… |
squarespace_commerce_get_products | Legge fino a 50 prodotti per id con le loro varianti, prezzi, stock, attributi e immagini |
squarespace_commerce_list_profiles | Elenca i profili (clienti, iscritti alla mailing list, donatori), 50 per pagina: id, firstName, lastName, email, hasAccount, isCustomer… |
squarespace_commerce_get_profiles | Legge fino a 50 profili per id: nomi, email, indirizzo, consenso al marketing e transactionsSummary |
squarespace_commerce_list_contacts | Elenca i contatti (il successore dei profili): id, firstName, lastName, email, phone, createdOn, defaultShippingAddress e marketing… |
squarespace_commerce_search_contacts | Cerca contatti per nome o testo email, ordinati come richiesto: gli stessi campi di squarespace_commerce_list_contacts. Solo lettura anche se è un… |
squarespace_commerce_get_contact | Legge un contatto: nomi, email, telefono, indirizzi e preferenze di marketing |
squarespace_commerce_list_transactions | Elenca le transazioni finanziarie raggruppate per ordine o donazione (un documento), 50 per pagina: id, createdOn, modifiedOn, customerEmail, salesOrderId… |
squarespace_commerce_get_transactions | Legge fino a 50 documenti di transazione per id, con pagamenti, rimborsi, commissioni e articoli. Solo lettura |
Esempi di prompt
- "Quali ordini di Squarespace sono ancora in attesa di essere evasi?"
- "Evasione dell'ordine 1047 con tracciamento USPS 9400111899223197428490 e invia un'email al cliente."
- "Quali prodotti hanno meno di 5 unità in stock?"
- "Aggiungi 20 unità allo stock della variante SKU MUG-WHT-12."
- "Mostra le transazioni del mese scorso e le commissioni totali di elaborazione."
FAQ
Quale piano è necessario? Le chiavi API di Squarespace Developer necessitano del piano Commerce Advanced. Genera una chiave sotto Impostazioni, Avanzate, Chiavi API per sviluppatori con le autorizzazioni di cui hai bisogno; viene mostrata una sola volta.
Cosa copre? Un sito Squarespace: ordini e evasione con tracciamento, aggiustamenti di inventario e stock, prodotti e varianti (lettura), profili e contatti dei clienti, e transazioni finanziarie.
Quali strumenti vengono installati disattivati? Nessuno. I prodotti sono solo in lettura, e l'evasione degli ordini o la modifica dello stock ti vengono mostrati prima che vengano eseguiti.
Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.
Prossimi passi
Questa guida ti è stata utile?