Resumen
APIs de Squarespace Commerce para un sitio: pedidos y cumplimiento con seguimiento, niveles de inventario y ajustes de stock, productos y variantes, perfiles y contactos de clientes, y transacciones financieras. Portador de la clave API.
Configuración guiada
Conecta Squarespace Commerce a Cursor en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Squarespace Commerce con la configuración guiada y añade tu URL MCP a Cursor. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Squarespace Commerce
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Squarespace Commerce, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Squarespace Commerce + Cursor
APIs de Squarespace Commerce para un sitio: pedidos y cumplimiento con seguimiento, niveles de inventario y ajustes de stock, productos y variantes, perfiles y contactos de clientes, y transacciones financieras. Portador de la clave API.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
SQUARESPACE_API_KEY
Paso 1 — Obtener credenciales
La configuración tarda aproximadamente 3 minutos.
- Inicia sesión en el sitio de Squarespace. En la navegación izquierda, abre Configuración, desplázate a Avanzado y haz clic en Claves API de desarrollador. Las claves API necesitan un plan Commerce Advanced.
- Haz clic en Generar clave, asígnale un nombre y elige los permisos: Pedidos (Leer y Escribir para cumplir), Inventario (Leer y Escribir para cambiar stock), Productos (Solo Lectura), Perfiles, Contactos y Transacciones (Solo Lectura).
- Copia la clave en
SQUARESPACE_API_KEY. Squarespace la muestra solo una vez; no caduca mientras el sitio esté activo.
Cada llamada lleva Authorization: Bearer con la clave y un encabezado User-Agent, que Squarespace requiere.
Dónde empezar: squarespace_commerce_get_website para confirmar el sitio, luego squarespace_commerce_list_orders con fulfillment_status PENDING para pedidos a enviar.
Pedidos: squarespace_commerce_list_orders, squarespace_commerce_get_order, y squarespace_commerce_fulfill_order (agrega envíos con seguimiento y marca el pedido como cumplido; puede enviar un correo al cliente). Usa el id del pedido en las llamadas; orderNumber es lo que ve el cliente. Los reembolsos y cancelaciones no son parte de la API.
Inventario: squarespace_commerce_list_inventory, squarespace_commerce_get_inventory, squarespace_commerce_adjust_inventory. Cada ajuste necesita un nuevo idempotency_key (un UUID): reenviar la misma clave no hace nada, lo que hace que los reintentos sean seguros.
Productos: squarespace_commerce_list_products y squarespace_commerce_get_products (API de Productos v2: tipos FÍSICO, SERVICIO, TARJETA_DE_REGALO y DIGITAL; precios y stock en cada variante). Los cambios de productos no están incluidos.
Personas: squarespace_commerce_list_contacts, squarespace_commerce_search_contacts, squarespace_commerce_get_contact (API de Contactos) y los más antiguos squarespace_commerce_list_profiles, squarespace_commerce_get_profiles (API de Perfiles, en modo de mantenimiento pero aún la que tiene totales de pedidos por cliente).
Dinero: squarespace_commerce_list_transactions y squarespace_commerce_get_transactions leen pagos, reembolsos y tarifas por pedido o donación; nada aquí mueve dinero.
Paginación y fechas: las listas devuelven hasta 50 registros con pagination.hasNextPage y pagination.nextPageCursor; pasa el cursor solo para obtener la siguiente página. modified_after y modified_before deben darse juntas y son UTC ISO 8601. Los valores monetarios son objetos con currency y value (una cadena decimal). Las herramientas de obtención por id aceptan hasta 50 ids separados por comas.
Límite de tasa: 300 solicitudes por minuto por clave; por encima de eso, Squarespace responde 429 y bloquea la clave durante un minuto.
Paso 2 — Instalar el adaptador
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
Paso 3 — Agregar el conector en Cursor
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de
YOUR_MCP_API_KEY. - Guarda el archivo y reinicia Cursor.
- Abre Cursor → Settings → MCP y comprueba que
anythingmcpaparece en la lista y está conectado. - Empieza a chatear: el agente ya puede usar las herramientas de
Squarespace Commerce.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
squarespace_commerce_get_website | Lee información básica sobre el sitio de Squarespace al que pertenece la clave API: id, siteTitle, url, timeZone, currency, language y location.… |
squarespace_commerce_list_orders | Lista los pedidos, los más recientemente modificados primero, 50 por página: id, orderNumber, createdOn, modifiedOn, channel, customerEmail, customerId… |
squarespace_commerce_get_order | Lee un pedido por id: los mismos campos que squarespace_commerce_list_orders, con todos los artículos, descuentos, notas internas y cumplimientos |
squarespace_commerce_fulfill_order | Marca un pedido como cumplido y agrega envíos con fecha de envío, transportista, servicio, número de seguimiento y URL de seguimiento. should_send_notification… |
squarespace_commerce_list_inventory | Lista stock para todas las variantes de productos, 50 por página: variantId, sku, descriptor (nombre del producto y opciones), isUnlimited y quantity. Siguiente… |
squarespace_commerce_get_inventory | Lee el stock en tiempo real de variantes específicas: variantId, sku, descriptor, isUnlimited y quantity |
squarespace_commerce_adjust_inventory | Cambia el stock de variantes en una llamada: incrementa o decrementa por una cantidad, establece una cantidad finita o hace que las variantes sean ilimitadas. Necesita un… |
squarespace_commerce_list_products | Lista productos, 50 por página: id, type (FÍSICO, SERVICIO, TARJETA_DE_REGALO, DIGITAL), storePageId, name, description, url, urlSlug, tags… |
squarespace_commerce_get_products | Lee hasta 50 productos por id con sus variantes, precios, stock, atributos e imágenes |
squarespace_commerce_list_profiles | Lista perfiles (clientes, suscriptores de listas de correo, donantes), 50 por página: id, firstName, lastName, email, hasAccount, isCustomer… |
squarespace_commerce_get_profiles | Lee hasta 50 perfiles por id: nombres, email, dirección, consentimiento de marketing y transactionsSummary |
squarespace_commerce_list_contacts | Lista contactos (el sucesor de perfiles): id, firstName, lastName, email, phone, createdOn, defaultShippingAddress y marketing… |
squarespace_commerce_search_contacts | Busca contactos por nombre o texto de email, ordenados como se solicita: los mismos campos que squarespace_commerce_list_contacts. Solo lectura aunque es un… |
squarespace_commerce_get_contact | Lee un contacto: nombres, email, teléfono, direcciones y preferencias de marketing |
squarespace_commerce_list_transactions | Lista transacciones financieras agrupadas por pedido o donación (un documento), 50 por página: id, createdOn, modifiedOn, customerEmail, salesOrderId… |
squarespace_commerce_get_transactions | Lee hasta 50 documentos de transacciones por id, con pagos, reembolsos, tarifas y artículos. Solo lectura |
Ejemplos de indicaciones
- "¿Qué pedidos de Squarespace aún están esperando ser cumplidos?"
- "Cumple el pedido 1047 con seguimiento de USPS 9400111899223197428490 y envía un correo al cliente."
- "¿Qué productos tienen menos de 5 unidades en stock?"
- "Agrega 20 unidades al stock de la variante SKU MUG-WHT-12."
- "Muestra las transacciones del mes pasado y las tarifas de procesamiento totales."
Preguntas frecuentes
¿Qué plan necesita? Las claves API de desarrollador de Squarespace necesitan el plan Commerce Advanced. Genera una clave en Configuración, Avanzado, Claves API de desarrollador con los permisos que necesites; se muestra una vez.
¿Qué cubre? Un sitio de Squarespace: pedidos y cumplimiento con seguimiento, ajustes de inventario y stock, productos y variantes (lectura), perfiles y contactos de clientes, y transacciones financieras.
¿Qué herramientas se instalan apagadas? Ninguna. Los productos son solo lectura, y cumplir pedidos o cambiar stock se te muestra antes de que se ejecute.
¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.
Próximos pasos
¿Te ha sido útil esta guía?