Servidor MCP de Shopify

Servidor MCP para la API de Shopify, que permite interactuar con los datos de la tienda a través de la API GraphQL. Este servidor proporciona herramientas para la gestión de productos, clientes, pedidos, etc.

Características

• Gestión deproductos: Búsqueda y recuperación de información de productos
• Gestión de clientes: Cargar datos de clientes y gestionar etiquetas de clientes
• Gestión depedidos: Consulta y filtrado avanzado de pedidos
• Integración GraphQL: Integración directa con la API GraphQL Admin de Shopify
• Gestión integral de errores: Mensajes de error claros para problemas de API y autenticación

Herramientas

1. obtener-productos

   • Obtener todos los productos o buscar por título
   • Entradas
     • searchTitle (cadena opcional): Filtrar productos por título
     • limit (número): Número máximo de productos a devolver
   • Devuelve: Detalles del producto formateados, incluidos el título, la descripción, el identificador y las variantes

2. obtener-productos-por-colección

   • Obtener productos de una colección específica
   • Entradas
     • collectionId (cadena): ID de la colección de la que se obtienen los productos
     • limit (número opcional, por defecto: 10): Número máximo de productos a devolver
   • Devuelve: Detalles formateados de los productos de la colección especificada

3. obtener-productos-por-id

   • Obtener productos por su ID
   • Entradas
     • productIds (matriz de cadenas): Matriz de IDs de productos a recuperar
   • Devuelve: Detalles formateados de los productos especificados

4. actualizar-precio-producto

   • Actualiza los precios de los productos para su ID
   • Entradas
     • productId (cadena): ID del producto a actualizar
     • price (cadena): Nuevo precio del producto
   • Devuelve: Respuesta de la actualización

5. obtener-variantes-por-id

   • Obtener variantes de productos por sus IDs
   • Entradas
     • variantIds (matriz de cadenas): Matriz de IDs de variantes a recuperar
   • Devuelve: Información detallada de la variante incluyendo detalles del producto

6. obtener-clientes

   • Obtener 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 la página siguiente
   • Devuelve: Datos del cliente en formato JSON

7. etiqueta-cliente

   • Añadir etiquetas a un cliente
   • Entradas
     • customerId (cadena): ID del cliente a etiquetar
     • tags (array de cadenas): Etiquetas a añadir al cliente
   • Devuelve: Mensaje de éxito o fracaso

8. obtener-pedidos

   • Obtener pedidos con filtrado y ordenación avanzados
   • Entradas
     • first (número opcional): Límite de órdenes a devolver
     • after (cadena opcional): Cursor de la página siguiente
     • query (cadena opcional): Filtrar órdenes utilizando la sintaxis de la consulta
     • sortKey (enum opcional): Campo para ordenar por ('PROCESSED_AT', 'TOTAL_PRICE', 'ID', 'CREATED_AT', 'UPDATED_AT', 'ORDER_NUMBER')
     • reverse (booleano opcional): Orden de clasificación inverso
   • Devuelve: Detalles del pedido formateados

9. obtener-orden

   • Obtener un único pedido por ID
   • Entradas
     • orderId (cadena): ID de la orden a recuperar
   • Devuelve: Información detallada del pedido

10. crear-descuento

• Crear un código de descuento básico
• Entradas
  • title (cadena): Título del descuento
  • code (cadena): Código de descuento que introducirán los clientes
  • valueType (enum): Tipo de descuento ('porcentaje' o 'importe_fijo')
  • value (número): Valor del descuento (porcentaje como decimal o importe fijo)
  • startsAt (cadena): Fecha de inicio en formato ISO
  • endsAt (cadena opcional): Fecha final opcional en formato ISO
  • appliesOncePerCustomer (booleano): Si el descuento sólo puede utilizarse una vez por cliente
• Devuelve: Detalles del descuento creado

11. crear-borrador-pedido

    • Crear un borrador de pedido
    • Entradas
      • lineItems (array): Matriz de artículos con variantId y cantidad
      • email (cadena): Email del cliente
      • shippingAddress (objeto): Datos de la dirección de envío
      • note (cadena opcional): Nota opcional para el pedido
    • Devoluciones: Detalles del borrador de pedido creado

12. completar-orden-borrador

    • Completar una orden de giro
    • Entradas
      • draftOrderId (cadena): ID del borrador de orden a completar
      • variantId (cadena): ID de la variante en el proyecto de orden
    • Devuelve: Detalles del pedido completado

13. obtener-colecciones

    • Obtener todas las colecciones
    • Entradas
      • limit (número opcional, por defecto: 10): Número máximo de colecciones a devolver
      • name (cadena opcional): Filtrar colecciones por nombre
    • Devuelve: Detalles de la colección

14. obtener-tienda

    • Obtener detalles de la tienda
    • Entradas: Ninguno
    • Devuelve: Información básica de la tienda

15. obtener-detalles-de-la-tienda

    • Obtiene información ampliada de la tienda, incluidos los países de envío
    • Introduce: Ninguno
    • Devuelve: Información ampliada de la tienda, incluidos los países de envío

16. gestionar-webhook

    • Suscribir, encontrar o desuscribir webhooks
    • Entradas
      • acción (enum): Acción a realizar ('subscribe', 'find', 'unsubscribe')
      • callbackUrl (cadena): URL de devolución de llamada del webhook
      • topic (enum): Tema del webhook al que suscribirse
      • webhookId (cadena opcional): ID del webhook (necesario para darse de baja)
    • Devuelve: Detalles del webhook o mensaje de éxito

Configurar

Token de acceso a Shopify

Para utilizar este servidor MCP, tendrás que crear una aplicación personalizada en tu tienda Shopify:

1. Desde el administrador de Shopify, ve a Configuración > Aplicaciones y canales de venta
2. Haz clic en Desarrollar aplicaciones (es posible que primero tengas que activar la vista previa para desarrolladores)
3. Haz clic en Crear una aplicación
4. Establece un nombre para tu aplicación (por ejemplo, "Shopify MCP Server")
5. Haz clic en Configurar ámbitos de la 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. Haz clic en Instalar para dar acceso a la aplicación a los datos de tu tienda
10. Tras la instalación, verás tu código de acceso a la API de administración
11. Cópialo, lo necesitarás para la configuración

Nota: Guarda tu token de acceso de forma segura. Proporciona acceso a los datos de su tienda y nunca debe ser compartida o comprometida con el control de versiones. Más detalles sobre cómo crear una aplicación Shopify se puede encontrar 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": "<SU_ACCESS_TOKEN>", "MYSHOPIFY_DOMAIN": "<TU_TIENDA>.myshopify.com" } } }

Desarrollo

1. Clonar el repositorio
2. Instala las dependencias:

npm install

3. Crear un archivo .env

SHOPIFY_ACCESS_TOKEN=tu_acceso_token MYSHOPIFY_DOMAIN=tu_tienda.myshopify.com

4. Construye el proyecto:

npm run build

5. Ejecuta las 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

Contribución

¡Las contribuciones son bienvenidas! Por favor, lea primero nuestras Directrices de Contribución.

Licencia

MIT

Comunidad

• MCP GitHub Discusiones
• Informe de problemas

Construido con ❤️ utilizando el Protocolo de Contexto de Modelo