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

1. 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
2. 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
3. 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
4. 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.
5. 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
6. 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
7. 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
8. get-order
   • Obtenga un pedido único por ID
   • Entradas:
     • orderId (cadena): ID del pedido a recuperar
   • Devoluciones: Información detallada del pedido
9. 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
10. 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

11. 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

12. 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

13. get-shop

• Obtener detalles de la tienda
• Entradas: Ninguna
• Devoluciones: Información básica de la tienda

14. 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.

15. 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:

1. Desde tu panel de control de Shopify, ve a Configuración > Aplicaciones y canales de venta
2. Haga clic en Desarrollar aplicaciones (es posible que primero deba habilitar la vista previa para desarrolladores)
3. Haga clic en Crear una aplicación
4. Establezca un nombre para su aplicación (por ejemplo, "Servidor Shopify MCP")
5. Haga clic en Configurar ámbitos de API de administración
6. Seleccione los siguientes ámbitos:
   • read_products , write_products
   • read_customers , write_customers
   • read_orders , write_orders
7. Haga clic en Guardar
8. Haga clic en Instalar aplicación
9. Haga clic en Instalar para darle a la aplicación acceso a los datos de su tienda
10. Después de la instalación, verá su token de acceso a la API de administrador
11. 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 :

Desarrollo

1. Clonar el repositorio
2. Instalar dependencias:

3. Crea un archivo .env :

4. Construir el proyecto:

5. Ejecutar pruebas:

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

• Discusiones de MCP en GitHub
• Informar problemas

Construido con ❤️ utilizando el Protocolo de Contexto de Modelo