stackgate.ai
Alle integrationer

Squarespace

Hostet Squarespace Commerce MCP til Claude, ChatGPT og Cursor - OAuth eller Developer API-nøgle, produkter, ordrer, lager og kontakter.

OAuth 28 værktøjer

Eksempelspørgsmål

Prøv at spørge din AI-klient

  • Which Squarespace products were updated this week?

  • Did order 123 ever get fulfilled?

  • Write a draft product for Amalie's new merch drop - do not create it yet.

  • Which variants are out of stock right now?

  • Summarize unfulfilled orders from the last 2 days.

Overblik

Forbind Squarespace Commerce, så AI-klienter kan læse og opdatere den butik, du autoriserer: produkter, ordrer, lager, kontakter, rabatter og transaktioner. Brug denne integration når du har brug for en Squarespace MCP-server, Squarespace OAuth til ChatGPT eller Claude, eller en styret måde at forbinde Squarespace til AI-agenter uden en custom connector.

Almindelige anvendelser

  • Squarespace MCP til Cursor eller Claude Desktop - peg din klient mod POST /mcp/squarespace med et stackgate.ai bearer token.
  • Forbind Squarespace til ChatGPT - brug enhver HTTP MCP-klient; OAuth giver de commerce-scopes, du godkender.
  • Private gateway - tilgå Squarespace sammen med Trello, Gmail og andre værktøjer gennem én MCP-forbindelse med squarespace__*-navngivne værktøjer.

Forudsætninger

  • Et Squarespace-site med Commerce
  • En stackgate.ai-konto
  • Til OAuth: en Squarespace OAuth-klient registreret til denne hub (hub-operatører sætter SQUARESPACE_CLIENT_ID og SQUARESPACE_CLIENT_SECRET)
  • Til API-nøgle: Commerce Advanced Developer API Keys på sitet

Credentials

OAuth (anbefalet)

  1. Log ind på stackgate.ai.
  2. Gå til Mine integrationer og åbn Squarespace.
  3. Klik Aktivér, og derefter Forbind Squarespace. Vælg fuld adgang eller scoped værktøjer.
  4. På Squarespace: godkend de anmodede website.*-scopes. Hub-initieret connect sender ikke website_id.

OAuth access tokens varer ca. 30 minutter. Refresh tokens roterer ved hver refresh og udløber efter 7 dages inaktivitet. Hubben refresher tokens dagligt, så inaktive forbindelser holdes i live. Hvis et kald stadig returnerer 401, afbryd og genforbind Squarespace.

Developer API-nøgle (fallback)

Hvis OAuth ikke er konfigureret på denne hub, opret en Developer API-nøgle under Settings → Advanced → Developer API Keys og indsæt den på Squarespace-integrationssiden. API-nøgler udløber ikke.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/squarespace med Sanctum bearer token
  • Private gateway: én config til alle integrationer - brug squarespace__*-navngivne værktøjer

Se Dokumentation for HTTP-autentificering og opsætning af private gateway.

Fejlfinding

  • 422 integration not configured - gennemfør Forbind Squarespace OAuth eller gem en Developer API-nøgle i Mine integrationer.
  • 401 reconnect - OAuth refresh token er udløbet (7 dages inaktivitet) eller tilbagekaldt. Genforbind Squarespace.
  • 403 - tokenet mangler Write-scopes. Genforbind og vælg Write (eller de matchende værktøjer).
  • 429 - Squarespace tillader 300 kald pr. minut. Vent ca. et minut og prøv igen.
  • Opret produkt fejler for DIGITAL - Squarespace understøtter ikke oprettelse eller sletning af DIGITAL-produkter via API. Brug PHYSICAL, SERVICE eller GIFT_CARD.
  • Manglende storePageId - kald list_store_pages før create_product.
  • Lagerjustering afvist - send en unik idempotency_key og mindst én increment-, decrement-, set_finite- eller set_unlimited-operation.

Tilgængelige værktøjer

  • get_website

    Return the connected Squarespace site profile (id, title, url, currency, time zone).

  • list_store_pages

    List store pages. Use storePageId from this list when creating products.

  • list_products

    List products (up to 50 per page) ordered by modifiedOn. Filter by date range, type, or search query.

  • get_products

    Get specific products by comma-separated IDs (up to 50), including variants and images.

  • create_product

    Create a PHYSICAL, SERVICE, or GIFT_CARD product. DIGITAL create is not supported. Requires store_page_id from list_store_pages.

  • update_product

    Partially update a product (name, description, visibility, tags, slug, SEO).

  • delete_product

    Delete a product. DIGITAL products cannot be deleted via the API.

  • create_product_variant

    Create a variant on a product. Physical/service products need attributes defined first. sku is required.

  • update_product_variant

    Partially update a product variant (sku, pricing, stock, attributes).

  • delete_product_variant

    Delete a product variant.

  • list_orders

    List orders with optional modified-date and fulfillment-status filters. Cursor pagination.

  • get_order

    Get a single order by ID, including line items, customer, and fulfillments.

  • fulfill_order

    Create a fulfillment for an order. Optionally send a customer notification and attach shipments.

  • list_inventory

    List variant inventory stock levels. Cursor pagination.

  • get_inventory

    Get inventory for specific variants by comma-separated variant IDs.

  • adjust_inventory

    Adjust variant stock. Provide at least one of increment, decrement, set_finite, or set_unlimited operations. Requires a unique idempotency_key.

  • list_contacts

    List contacts (customers, subscribers, donors). Cursor pagination.

  • query_contacts

    Search contacts with a filter object (email, name, and similar fields).

  • get_contact

    Get a single contact by ID, including address book and marketing preferences.

  • create_contact

    Create a contact. Squarespace requires first_name, last_name, locale, and email (sent as primaryEmail).

  • update_contact

    Partially update a contact (JSON merge patch). Provide at least one of first_name, last_name, locale, email, or accepts_marketing.

  • list_discounts

    List discounts with offset/limit pagination.

  • get_discount

    Get a single discount by ID.

  • create_discount

    Create a discount. Pass a discount object with name, amount, and eligibility fields as required by Squarespace.

  • update_discount

    Replace a discount. Pass the full discount object (Squarespace uses PUT, not a partial POST).

  • delete_discount

    Delete a discount by ID.

  • list_transactions

    List financial transactions for orders and donations. Cursor pagination.

  • get_transaction

    Get a single transaction by ID.

MCP-endpoint: https://stackgate.ai/mcp/squarespace (HTTP) eller via private gateway.

Opret konto Dokumentation