Guida al connettore7 minuti di lettura16 tool MCP7 lingue

Collegare Squarespace a Microsoft Copilot via MCP

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.

HCA cura del team HelpCodeAggiornato 7 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Squarespace Commerce

Squarespace Commerce

Squarespace Commerce APIs for one site: orders and fulfillment with tracking, inventory levels and stock adjustments, products and variants, customer profiles and contacts, and financial transactions. API key bearer.

tool

16

Regione

INTL

Categoria

E-commerce

Autenticazione

Bearer Token

Env vars richieste

SQUARESPACE_API_KEY
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

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 Microsoft Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Squarespace Commerce con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. 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.

Squarespace Commerce · live via MCP
Condividi
Opus 4.7

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 + Microsoft Copilot

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.

  1. 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.
  2. 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).
  3. 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 Microsoft Copilot

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 mostra YOUR_SERVER_ID.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

  1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
  2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
  3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
  4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
  5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Squarespace Commerce.
  6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

Strumenti disponibili

StrumentoCosa fa
squarespace_commerce_get_websiteLegge informazioni di base sul sito Squarespace a cui appartiene la chiave API: id, siteTitle, url, timeZone, currency, language e location.…
squarespace_commerce_list_ordersElenca gli ordini, modificati più di recente per primi, 50 per pagina: id, orderNumber, createdOn, modifiedOn, channel, customerEmail, customerId…
squarespace_commerce_get_orderLegge un ordine per id: gli stessi campi di squarespace_commerce_list_orders, con tutti gli articoli, sconti, note interne e evasioni
squarespace_commerce_fulfill_orderSegna 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_inventoryElenca 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_inventoryLegge lo stock in tempo reale di varianti specifiche: variantId, sku, descriptor, isUnlimited e quantity
squarespace_commerce_adjust_inventoryModifica 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_productsElenca i prodotti, 50 per pagina: id, type (FISICO, SERVIZIO, CARTA_REGALO, DIGITALE), storePageId, name, description, url, urlSlug, tags…
squarespace_commerce_get_productsLegge fino a 50 prodotti per id con le loro varianti, prezzi, stock, attributi e immagini
squarespace_commerce_list_profilesElenca i profili (clienti, iscritti alla mailing list, donatori), 50 per pagina: id, firstName, lastName, email, hasAccount, isCustomer…
squarespace_commerce_get_profilesLegge fino a 50 profili per id: nomi, email, indirizzo, consenso al marketing e transactionsSummary
squarespace_commerce_list_contactsElenca i contatti (il successore dei profili): id, firstName, lastName, email, phone, createdOn, defaultShippingAddress e marketing…
squarespace_commerce_search_contactsCerca 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_contactLegge un contatto: nomi, email, telefono, indirizzi e preferenze di marketing
squarespace_commerce_list_transactionsElenca le transazioni finanziarie raggruppate per ordine o donazione (un documento), 50 per pagina: id, createdOn, modifiedOn, customerEmail, salesOrderId…
squarespace_commerce_get_transactionsLegge 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.

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

Questa guida ti è stata utile?

Collega Squarespace Commerce a Microsoft Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Squarespace Commerce con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.

Guide correlate

Connettori

Collegare Squarespace a ChatGPT via MCP

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.

Connettori

Collegare Squarespace a Claude via MCP

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.

Connettori

Collegare Squarespace a Cursor via MCP

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.

Connettori

Collegare Squarespace a Gemini CLI via MCP

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.

Connettori

Collegare Squarespace a Meta Muse via MCP

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.

Connettori

Squarespace MCP server: ordini, scorte e prodotti

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.