Servidor MCP de Shopify

(¡Deja una estrella si te gusta!)

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

Prerrequisitos

1. Node.js (versión 16 o superior)

2. Token de acceso a la aplicación personalizada de Shopify (consulte las instrucciones de configuración a continuación)

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

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json :

Ubicaciones para el archivo de configuración de Claude Desktop:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Ventanas: %APPDATA%/Claude/claude_desktop_config.json

Alternativa: Ejecutar localmente con variables de entorno

Si prefiere utilizar variables de entorno en lugar de argumentos de la línea de comandos:

1. Crea un archivo .env con tus credenciales de Shopify:

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

2. Ejecute el servidor con npx:

   npx shopify-mcp-server

Instalación directa (opcional)

Si desea instalar el paquete globalmente:

Luego ejecútalo:

Herramientas disponibles

Gestión de productos

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

2. get-product-by-id

   • Obtenga un producto específico por ID

   • Entradas:

     • productId (cadena): ID del producto a recuperar

Gestión de clientes

1. get-customers

   • Obtenga clientes o busque por nombre/correo electrónico

   • Entradas:

     • searchQuery (cadena opcional): Filtrar clientes por nombre o correo electrónico

     • limit (número opcional, predeterminado: 10): Número máximo de clientes a devolver

2. update-customer

   • Actualizar la información de un cliente

   • Entradas:

     • id (cadena, obligatoria): ID de cliente de Shopify (solo ID numérico, como "6276879810626")

     • firstName (cadena, opcional): nombre del cliente

     • lastName (cadena, opcional): apellido del cliente

     • email (cadena, opcional): dirección de correo electrónico del cliente

     • phone (cadena, opcional): número de teléfono del cliente

     • tags (matriz de cadenas, opcional): etiquetas que se aplicarán al cliente

     • note (cadena, opcional): Nota sobre el cliente

     • taxExempt (booleano, opcional): si el cliente está exento de impuestos

     • metafields (matriz de objetos, opcional): metacampos del cliente para almacenar datos adicionales

3. get-customer-orders

   • Obtener pedidos para un cliente específico

   • Entradas:

     • customerId (cadena, obligatoria): ID de cliente de Shopify (solo ID numérico, como "6276879810626")

     • limit (número opcional, predeterminado: 10): Número máximo de pedidos a devolver

Gestión de pedidos

1. get-orders

   • Obtener pedidos con filtrado opcional

   • Entradas:

     • status (cadena opcional): Filtrar por estado del pedido

     • limit (número opcional, predeterminado: 10): Número máximo de pedidos a devolver

2. get-order-by-id

   • Obtener un pedido específico por ID

   • Entradas:

     • orderId (cadena, obligatoria): ID completo del pedido de Shopify (p. ej., "gid://shopify/Order/6090960994370")

3. update-order

   • Actualizar un pedido existente con nueva información

   • Entradas:

     • id (cadena, obligatoria): ID de pedido de Shopify

     • tags (matriz de cadenas, opcional): nuevas etiquetas para el pedido

     • email (cadena, opcional): Actualizar el correo electrónico del cliente

     • note (cadena, opcional): notas de pedido

     • customAttributes (matriz de objetos, opcional): atributos personalizados para el pedido

     • metafields (matriz de objetos, opcional): Ordenar metacampos

     • shippingAddress (objeto, opcional): Información de la dirección de envío

Depuración

Si encuentra problemas, consulte los registros MCP de Claude Desktop:

Licencia

Instituto Tecnológico de Massachusetts (MIT)