remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Direct integration with Shopify's GraphQL Admin API for querying and mutating store data, with support for complex filtering, pagination, and sorting.
Enables interaction with Shopify store data through the GraphQL Admin API, providing tools for managing products, customers, orders, collections, discounts, webhooks, and accessing shop details.
Utilizes Zod for runtime type validation of API inputs and outputs, ensuring data integrity when interacting with the Shopify API.

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

Herramientas

get-products
- Obtenga todos los productos o busque por título
- Entradas:
  - searchTitle (cadena opcional): Filtrar productos por título
  - limit (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-collection
- Obtener productos de una colección específica
- Entradas:
  - collectionId (cadena): ID de la colección de la que se obtendrán los productos
  - limit (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-ids
- Obtener 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
update-product-price
- Actualizar precios de productos para su ID
- Entradas:
  - productId (cadena): ID del producto a actualizar
  - price (cadena): Nuevo precio del producto
- Devoluciones: Respuesta de la actualización
get-variants-by-ids
- Obtener 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-customers
- Consigue clientes de Shopify con soporte de paginación
- Entradas:
  - limit (número opcional): Número máximo de clientes a devolver
  - next (cadena opcional): cursor de página siguiente
- Devuelve: Datos del cliente en formato JSON
tag-customer
- Agregar etiquetas a un cliente
- Entradas:
  - customerId (cadena): ID del cliente a etiquetar
  - tags (matriz de cadenas): etiquetas para agregar al cliente
- Devuelve: Mensaje de éxito o fracaso
get-orders
- Obtenga pedidos con filtrado y clasificación avanzados
- Entradas:
  - first (número opcional): Límite de pedidos a devolver
  - after (cadena opcional): cursor de página siguiente
  - query (cadena opcional): Filtrar pedidos usando la sintaxis de consulta
  - sortKey (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-order
- Obtenga un pedido único por ID
- Entradas:
  - orderId (cadena): ID del pedido a recuperar
- Devoluciones: Información detallada del pedido
create-discount

Crear un código de descuento básico
Entradas:
- title (cadena): Título del descuento
- code (cadena): Código de descuento que ingresarán los clientes
- valueType (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 ISO
- endsAt (cadena opcional): fecha de finalización opcional en formato ISO
- appliesOncePerCustomer (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 cantidad
- email (cadena): correo electrónico del cliente
- shippingAddress (objeto): Detalles de la dirección de envío
- note (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 completar
- variantId (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 devolver
- name (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 webhook
- topic (enumeración): tema del webhook al que suscribirse
- webhookId (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_products
- read_customers , write_customers
- read_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 install

Crea un archivo .env :

SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com

Construir el proyecto:

npm run build

Ejecutar pruebas:

npm test

Dependencias

@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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Permite la interacción con las tiendas Shopify a través de la API GraphQL, proporcionando herramientas para administrar productos, clientes, pedidos y más.

Shopify MCP Server