Automação Shopify via Rube MCP

Automatize operações da Shopify através do kit de ferramentas Shopify da Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (ferramentas RUBE_SEARCH_TOOLS disponíveis)
• Conexão ativa com a Shopify via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas shopify
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas shopify
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth da Shopify
4. Confirme se o status da conexão mostra ATIVO antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Gerenciar Produtos

Quando usar: O usuário deseja listar, pesquisar, criar ou gerenciar produtos

Sequência de ferramentas:

1. SHOPIFY_GET_PRODUCTS / SHOPIFY_GET_PRODUCTS_PAGINATED - Listar produtos [Opcional]
2. SHOPIFY_GET_PRODUCT - Obter detalhes de um único produto [Opcional]
3. SHOPIFY_BULK_CREATE_PRODUCTS - Criar produtos em massa [Opcional]
4. SHOPIFY_GET_PRODUCTS_COUNT - Obter contagem de produtos [Opcional]

Parâmetros principais:

• product_id: ID do produto para recuperação única
• title: Título do produto
• vendor: Fornecedor do produto
• status: 'active', 'draft', ou 'archived'

Armadilhas:

• Resultados paginados exigem paginação baseada em cursor para catálogos grandes
• Variantes de produto são aninhadas dentro do objeto do produto

2. Gerenciar Pedidos

Quando usar: O usuário deseja listar, pesquisar ou inspecionar pedidos

Sequência de ferramentas:

1. SHOPIFY_GET_ORDERS_WITH_FILTERS - Listar pedidos com filtros [Obrigatório]
2. SHOPIFY_GET_ORDER - Obter detalhes de um único pedido [Opcional]
3. SHOPIFY_GET_FULFILLMENT - Obter detalhes de fulfillment [Opcional]
4. SHOPIFY_GET_FULFILLMENT_EVENTS - Rastrear eventos de fulfillment [Opcional]

Parâmetros principais:

• status: Filtro de status do pedido ('any', 'open', 'closed', 'cancelled')
• financial_status: Filtro de status de pagamento
• fulfillment_status: Filtro de status de fulfillment
• order_id: ID do pedido para recuperação única
• created_at_min/created_at_max: Filtros de intervalo de datas

Armadilhas:

• IDs de pedido são numéricos; use formato de string para chamadas de API
• A listagem padrão de pedidos pode não incluir todos os status; especifique 'any' para todos

3. Gerenciar Clientes

Quando usar: O usuário deseja listar ou pesquisar clientes

Sequência de ferramentas:

1. SHOPIFY_GET_ALL_CUSTOMERS - Listar todos os clientes [Obrigatório]

Parâmetros principais:

• limit: Número de clientes por página
• since_id: Cursor de paginação

Armadilhas:

• Dados do cliente incluem contagem de pedidos e total gasto
• Listas grandes de clientes exigem paginação

4. Gerenciar Coleções

Quando usar: O usuário deseja gerenciar coleções de produtos

Sequência de ferramentas:

1. SHOPIFY_GET_SMART_COLLECTIONS - Listar coleções inteligentes [Opcional]
2. SHOPIFY_GET_SMART_COLLECTION_BY_ID - Obter detalhes da coleção [Opcional]
3. SHOPIFY_CREATE_SMART_COLLECTIONS - Criar uma coleção inteligente [Opcional]
4. SHOPIFY_ADD_PRODUCT_TO_COLLECTION - Adicionar produto à coleção [Opcional]
5. SHOPIFY_GET_PRODUCTS_IN_COLLECTION - Listar produtos na coleção [Opcional]

Parâmetros principais:

• collection_id: ID da coleção
• product_id: ID do produto para adicionar à coleção
• rules: Regras de coleção inteligente para inclusão automática

Armadilhas:

• Coleções inteligentes são preenchidas automaticamente com base em regras; coleções manuais usam a API de coleções personalizadas
• Endpoints de contagem de coleção fornecem contagens aproximadas

5. Gerenciar Inventário

Quando usar: O usuário deseja verificar ou gerenciar níveis de inventário

Sequência de ferramentas:

1. SHOPIFY_GET_INVENTORY_LEVELS / SHOPIFY_RETRIEVES_A_LIST_OF_INVENTORY_LEVELS - Verificar estoque [Obrigatório]
2. SHOPIFY_LIST_LOCATION - Listar locais da loja [Opcional]

Parâmetros principais:

• inventory_item_ids: IDs de itens de inventário para verificar
• location_ids: IDs de local para filtrar

Armadilhas:

• O inventário é rastreado por variante por local
• IDs de local são necessários para lojas com vários locais

Padrões Comuns

Paginação

• Use o cursor limit e page_info para resultados paginados
• Verifique a resposta para o cabeçalho de link next
• Continue até que não haja mais páginas disponíveis

Consultas GraphQL

Para operações avançadas:

1. Call SHOPIFY_GRAPH_QL_QUERY with custom query
2. Parse response from data object

Armadilhas Conhecidas

Versionamento de API:

• A API REST da Shopify possui endpoints versionados
• Alguns recursos exigem versões específicas da API

…