Shopify MCP Server
Servidor MCP de Shopify
Servidor MCP para la API de Shopify, que permite la interacción con los datos de la tienda mediante la API GraphQL. Este servidor proporciona herramientas para gestionar productos, clientes, pedidos y más.
Características
Gestión de productos : buscar y recuperar información de productos
Gestión de clientes : cargar datos de clientes y administrar etiquetas de clientes
Gestión de pedidos : consulta y filtrado avanzado de pedidos
Integración con GraphQL : integración directa con la API de administración GraphQL de Shopify
Manejo integral de errores : mensajes de error claros para problemas de API y autenticación
Related MCP server: Shopify MCP Server
Herramientas
get-productsObtenga todos los productos o busque por título
Entradas:
searchTitle(cadena opcional): Filtrar productos por títulolimit(número): Número máximo de productos a devolver
Devoluciones: Detalles del producto formateados que incluyen título, descripción, identificador y variantes
get-products-by-collectionObtener productos de una colección específica
Entradas:
collectionId(cadena): ID de la colección de la que se obtendrán los productoslimit(número opcional, predeterminado: 10): Número máximo de productos a devolver
Devoluciones: Detalles del producto formateados de la colección especificada
get-products-by-idsObtener productos por sus identificaciones
Entradas:
productIds(matriz de cadenas): Matriz de ID de productos para recuperar
Devoluciones: Detalles de producto formateados para los productos especificados
get-variants-by-idsObtener variantes de productos por sus ID
Entradas:
variantIds(matriz de cadenas): Matriz de ID de variantes para recuperar
Devoluciones: Información detallada de la variante, incluidos los detalles del producto.
get-customersConsigue clientes de Shopify con soporte de paginación
Entradas:
limit(número opcional): Número máximo de clientes a devolvernext(cadena opcional): cursor de página siguiente
Devuelve: Datos del cliente en formato JSON
tag-customerAgregar etiquetas a un cliente
Entradas:
customerId(cadena): ID del cliente a etiquetartags(matriz de cadenas): etiquetas para agregar al cliente
Devuelve: Mensaje de éxito o fracaso
get-ordersObtenga pedidos con filtrado y clasificación avanzados
Entradas:
first(número opcional): Límite de pedidos a devolverafter(cadena opcional): cursor de página siguientequery(cadena opcional): Filtrar pedidos usando la sintaxis de consultasortKey(enumeración opcional): Campo por el cual ordenar ('PROCESADO_EN', 'PRECIO_TOTAL', 'ID', 'CREADO_EN', 'ACTUALIZADO_EN', 'NÚMERO_DE_PEDIDO')reverse(booleano opcional): orden de clasificación inverso
Devoluciones: Detalles del pedido formateados
get-orderObtenga un pedido único por ID
Entradas:
orderId(cadena): ID del pedido a recuperar
Devoluciones: Información detallada del pedido
create-discountCrear un código de descuento básico
Entradas:
title(cadena): Título del descuentocode(cadena): Código de descuento que ingresarán los clientesvalueType(enum): Tipo de descuento ('porcentaje' o 'monto_fijo')value(número): Valor de descuento (porcentaje como decimal o importe fijo)startsAt(cadena): Fecha de inicio en formato ISOendsAt(cadena opcional): fecha de finalización opcional en formato ISOappliesOncePerCustomer(booleano): si el descuento se puede utilizar solo una vez por cliente
Devoluciones: Detalles de descuento creados
create-draft-order
Crear un borrador de pedido
Entradas:
lineItems(matriz): Matriz de artículos con varianteId y cantidademail(cadena): correo electrónico del clienteshippingAddress(objeto): Detalles de la dirección de envíonote(cadena opcional): Nota opcional para el pedido
Devoluciones: Detalles del borrador del pedido creado
complete-draft-order
Completar un borrador de pedido
Entradas:
draftOrderId(cadena): ID del borrador del pedido a completarvariantId(cadena): ID de la variante en el borrador del pedido
Devoluciones: Detalles del pedido completado
get-collections
Obtener todas las colecciones
Entradas:
limit(número opcional, predeterminado: 10): número máximo de colecciones a devolvername(cadena opcional): Filtrar colecciones por nombre
Devoluciones: Detalles de la colección
get-shop
Obtener detalles de la tienda
Entradas: Ninguna
Devoluciones: Información básica de la tienda
get-shop-details
Obtenga detalles ampliados de la tienda, incluidos los países de envío.
Entradas: Ninguna
Devoluciones: Información ampliada de la tienda, incluidos los países de envío.
manage-webhook
Suscribirse, buscar o cancelar la suscripción a webhooks
Entradas:
action(enum): Acción a realizar ('suscribirse', 'buscar', 'cancelar suscripción')callbackUrl(cadena): URL de devolución de llamada del webhooktopic(enumeración): tema del webhook al que suscribirsewebhookId(cadena opcional): ID del webhook (obligatorio para cancelar la suscripción)
Devoluciones: Detalles del webhook o mensaje de éxito
Configuración
Token de acceso de Shopify
Para utilizar este servidor MCP, necesitará crear una aplicación personalizada en su tienda Shopify:
Desde tu panel de control de Shopify, ve a Configuración > Aplicaciones y canales de venta
Haga clic en Desarrollar aplicaciones (es posible que primero deba habilitar la vista previa para desarrolladores)
Haga clic en Crear una aplicación
Establezca un nombre para su aplicación (por ejemplo, "Servidor Shopify MCP")
Haga clic en Configurar ámbitos de API de administración
Seleccione los siguientes ámbitos:
read_products,write_productsread_customers,write_customersread_orders,write_orders
Haga clic en Guardar
Haga clic en Instalar aplicación
Haga clic en Instalar para darle a la aplicación acceso a los datos de su tienda
Después de la instalación, verá su token de acceso a la API de administrador
Copia este token: lo necesitarás para la configuración
Nota: Guarda tu token de acceso de forma segura. Este proporciona acceso a los datos de tu tienda y nunca debe compartirse ni transferirse al control de versiones. Puedes encontrar más información sobre cómo crear una aplicación de Shopify aquí .
Uso con Claude Desktop
Añade a tu claude_desktop_config.json :
{
"mcpServers": {
"shopify": {
"command": "npx",
"args": ["-y", "shopify-mcp-server"],
"env": {
"SHOPIFY_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
"MYSHOPIFY_DOMAIN": "<YOUR_SHOP>.myshopify.com"
}
}
}
}Desarrollo
Clonar el repositorio
Instalar dependencias:
npm installCrea un archivo
.env:
SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.comConstruir el proyecto:
npm run buildEjecutar pruebas:
npm testDependencias
@modelcontextprotocol/sdk - Implementación del protocolo MCP
graphql-request: cliente GraphQL para la API de Shopify
zod - Validación de tipos en tiempo de ejecución
Contribuyendo
¡Agradecemos sus contribuciones! Lea primero nuestras Normas de Contribución .
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Comunidad
Construido con ❤️ utilizando el Protocolo de Contexto de Modelo
Available Tools
15 toolscomplete-draft-orderC
Complete a draft order
Inputs: draftOrderId (required), variantId (required).
create-discountC
Create a basic discount code
Inputs: title (required), code (required), valueType (required), value (required), +3 more.
create-draft-orderC
Create a draft order
Inputs: lineItems (required), email (required), shippingAddress (required), note.
get-collectionsC
Get all collections
Inputs: limit, name.
get-customersC
Get shopify customers with pagination support
Inputs: limit, next.
get-orderC
Get a single order by ID
Inputs: orderId (required).
get-ordersC
Get shopify orders with advanced filtering and sorting
Inputs: first, after, query, sortKey, +1 more.
get-productsC
Get all products or search by title
Inputs: limit (required), searchTitle.
get-products-by-collectionC
Get products from a specific collection
Inputs: collectionId (required), limit.
get-products-by-idsC
Get products by their IDs
Inputs: productIds (required).
get-shopC
Get shop details
Inputs: no named parameters.
get-shop-detailsB
Get extended shop details including shipping countries
Inputs: no named parameters.
get-variants-by-idsC
Get product variants by their IDs
Inputs: variantIds (required).
manage-webhookC
Subscribe, find, or unsubscribe webhooks
Inputs: action (required), callbackUrl (required), topic (required), webhookId.
tag-customerC
Add tags to a customer
Inputs: customerId (required), tags (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Most tools have distinct purposes targeting specific Shopify resources like orders, products, customers, and shop details, with clear separation. However, 'get-shop' and 'get-shop-details' could cause confusion as they both retrieve shop information, though descriptions hint at different detail levels.
All tool names follow a consistent verb_noun pattern with hyphens, such as 'create-discount', 'get-products', and 'tag-customer'. This uniformity makes the set predictable and easy to navigate for an agent.
With 15 tools, the server is well-scoped for Shopify operations, covering key areas like orders, products, customers, discounts, and webhooks. Each tool appears to serve a specific function without unnecessary bloat.
The tool set provides good coverage for core Shopify workflows, including CRUD operations for orders, products, and customers, as well as utilities like discounts and webhooks. Minor gaps exist, such as no update or delete tools for products or customers, but agents can likely work around these with available tools.
Maintenance
Related MCP Connectors
Unofficial Shopify MCP Pack — wraps the Shopify Admin REST API (2024-01)
Manage a Shopify store's Sternify bundles, gifts, upsells, banners and reviews via OAuth.
Shopify store catalog, SKU/price/availability & collections
AI-powered commerce API for luxury skincare shopping. Enables AI agents to search products, browse collections, manage shopping carts, and generate checkout URLs for the Regenique Elegance Shopify store.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEnables interaction with Shopify store data via GraphQL API, providing tools for managing products, customers, orders, discounts, and more with robust error handling.79 npm30-
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Shopify stores through GraphQL API, providing tools for managing products, customers, orders, and more.79 npm10MIT
- AlicenseCqualityDmaintenanceEnables interaction with Shopify store data through GraphQL API, providing tools for managing products, customers, orders, blogs, and articles.155MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Shopify store data through the GraphQL Admin API, supporting product, customer, and order management. It allows users to search, retrieve, create, and update store resources via natural language commands.2,755 npmMIT