Shopify Admin MCP

A1 Shopify Admin MCP conecta una aplicación de IA al panel de administración de una tienda Shopify a través de la Admin API (GraphQL). Ayuda a trabajar con productos y precios, pedidos, clientes, existencias y códigos promocionales, en lenguaje natural.

El servidor está vinculado a una sola tienda: el dominio se define en la configuración, el token es el Admin API access token de una aplicación personalizada, y ninguna herramienta puede ir a otra tienda.

• 16 herramientas. Tienda, productos y variantes, pedidos, clientes, ubicaciones y existencias, descuentos; más una consulta GraphQL arbitraria para todo lo demás.

• HTTP 200 sinceros. Las mutaciones de Shopify devuelven 200 incluso cuando fallan; el servidor lee userErrors y convierte el rechazo en un error entendible. Una respuesta 200 sin objeto data —vacía, truncada o que no es GraphQL en absoluto— también se convierte en un error, no en un resultado vacío.

• Las operaciones irreversibles están señalizadas. La cancelación de un pedido (con decisiones sobre reembolso y devolución del producto) y las consultas GraphQL arbitrarias están marcadas como destructive.

• El bucket de coste bajo control. Cada respuesta incluye cost: cuánto costó la consulta y cuántos puntos quedan en el bucket de GraphQL.

Empieza con una consulta que solo lea datos:

Muestra los últimos pedidos de la tienda y el top de productos con existencias.

Conectar el servidor · Ver escenarios · Abrir documentación técnica

Ver cómo funciona en un minuto

Tú: Muestra los últimos pedidos de la tienda y el top de productos con existencias.

Asistente: Muestra los pedidos con sus estados y totales, y los productos con precios y existencias. No cambia nada.

Tú: Prepara un descuento del 20% con el código promocional SUMMER durante dos semanas.

Asistente: Muestra los parámetros del futuro código promocional —código, importe, plazo, límites— y solicita confirmación.

Tú: Confirmo.

• Inicio rápido

• Qué puedes pedirle

• Qué puede cambiar

• Obtener acceso

• Configuración

• Datos, límites y trabajo en segundo plano

• Documentación técnica

• Soporte

Inicio rápido

Se necesitan Node.js 20+, un dominio de tienda como my-store.myshopify.com y un Admin API access token de una aplicación personalizada (shpat_…). Para crear la aplicación se necesitan permisos de propietario de la tienda o permisos de staff para el desarrollo de aplicaciones.

1. Obtén acceso.

2. Añade el servidor a la aplicación de IA.

3. Envía la primera consulta segura de arriba.

En Settings → Plugins → MCP servers, haz clic en Add server y añade npx -y mcp-shopify-admin@latest con SHOPIFY_STORE_DOMAIN y SHOPIFY_ACCESS_TOKEN.

codex mcp add shopify-admin \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  -- npx -y mcp-shopify-admin@latest
codex mcp list

Documentación de Codex MCP

claude mcp add \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  --transport stdio --scope user shopify-admin \
  -- npx -y mcp-shopify-admin@latest
claude mcp list

Documentación de Claude Code MCP

Abre Settings → Developer → Edit Config y añade:

{"mcpServers":{"shopify-admin":{"command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}}

Si Edit Config no está disponible, edita ~/Library/Application Support/Claude/claude_desktop_config.json en macOS o %APPDATA%\Claude\claude_desktop_config.json en Windows. Documentación de Claude Desktop MCP

Añade {"mcpServers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}} en ~/.cursor/mcp.json en macOS/Linux o en %USERPROFILE%\.cursor\mcp.json en Windows. Documentación de Cursor MCP

Ejecuta MCP: Open User Configuration y añade:

{"servers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"${input:shopify_store_domain}","SHOPIFY_ACCESS_TOKEN":"${input:shopify_access_token}"}}},"inputs":[{"type":"promptString","id":"shopify_store_domain","description":"Домен магазина my-store.myshopify.com"},{"type":"promptString","id":"shopify_access_token","description":"Admin API access token (shpat_…)","password":true}]}

Verifica el servidor con el comando MCP: List Servers. Documentación de VS Code MCP

Qué puedes pedirle

• Muestra los pedidos de la semana, sus estados de pago y de cumplimiento.

• Encuentra productos sin existencias y sube los precios de las variantes seleccionadas.

• Crea un nuevo producto como borrador y completa la descripción.

• Establece las existencias reales después del inventario.

• Crea un código promocional para una venta con límite de usos.

• Encuentra un cliente por email y muestra sus últimos pedidos.

Qué puede cambiar

La creación de pedidos, la realización de envíos, la modificación de clientes, la publicación de productos en canales de venta y la eliminación de objetos no forman parte del conjunto de herramientas; si es necesario, se hacen mediante graphql_request con confirmación explícita.

Obtener acceso

1. Abre el panel de administración de la tienda: Settings → Apps and sales channels → Develop apps (activa el desarrollo de aplicaciones si está desactivado).

2. Crea una aplicación y, en la pestaña Configuration, otorga los Admin API access scopes necesarios: read_products/write_products, read_orders, read_customers, read_locations/write_inventory, read_discounts/write_discounts, según tus escenarios.

3. Instala la aplicación y, en la pestaña API credentials, copia el Admin API access token (shpat_…; se muestra una sola vez).

4. Proporciona el dominio y el token como SHOPIFY_STORE_DOMAIN y SHOPIFY_ACCESS_TOKEN.

El token es estático y está vinculado a la tienda. Guárdalo como una contraseña. Si más tarde le otorgas nuevos scopes a la aplicación, Shopify emitirá un nuevo token: actualiza la variable y reinicia el servidor. Para ensayos seguros resulta útil un development store.

Configuración

Datos, límites y trabajo en segundo plano

• El bucket de coste de GraphQL. Cada consulta cuesta puntos según su complejidad; el bucket se restablece cada segundo. Una página first de hasta 250 es más económica que una serie de páginas pequeñas; el servidor muestra cost con cada resultado.

• Errores temporales. THROTTLED se reintenta automáticamente con una espera calculada a partir de la lógica del bucket. Las mutaciones no se reintentan tras un error de red o un error 5xx, para no aplicar el cambio dos veces.

• Los pedidos de más de 60 días requieren el scope read_all_orders, que Shopify concede bajo petición; sin él, los pedidos antiguos simplemente no aparecen.

• No hay supervisión continua. El servidor solo funciona cuando se le invoca. Si la aplicación de IA admite tareas programadas, puede revisar periódicamente los pedidos y las existencias.

• Telemetría anónima. No incluye secretos, datos de la tienda, argumentos ni prompts; para desactivarla: ASKADS_TELEMETRY=0.

Documentación técnica

• Catálogo de capacidades de MCP — páginas con tareas de usuario para cada herramienta.

• Todas las herramientas y parámetros

• Documentación de desarrollo

• Documentación de publicación

• Documentación de Shopify Admin API (GraphQL)

Soporte

¿Has encontrado un error o falta algún escenario? Crea un issue o escribe a Telegram.