Shopify Storefront MCP Server

# Configuração do Shopify para o MCP Server ## Como obter as credenciais necessárias ### 1. SHOPIFY_STORE_DOMAIN Este é o domínio da sua loja Shopify. Formato: `sua-loja.myshopify.com` **Como encontrar:** - Acesse o admin da sua loja Shopify - O domínio aparece na URL: `https://sua-loja.myshopify.com/admin` - Use apenas a parte: `sua-loja.myshopify.com` ### 2. SHOPIFY_PUBLIC_ACCESS_TOKEN (Storefront API) Este token permite acesso público à Storefront API para operações de leitura. **Passo a passo:** 1. **Acesse o Admin da sua loja Shopify** - Vá para `https://sua-loja.myshopify.com/admin` 2. **Navegue para Apps** - No menu lateral, clique em "Apps" - Clique em "Develop apps" (ou "Desenvolver apps") 3. **Crie um novo app** - Clique em "Create an app" (ou "Criar um app") - Dê um nome para o app (ex: "MCP Storefront Server") - Selecione um desenvolvedor 4. **Configure a Storefront API** - Na página do app, clique na aba "Configuration" - Role até a seção "Storefront API access scopes" - Habilite as seguintes permissões: - `unauthenticated_read_product_listings` - `unauthenticated_read_product_inventory` - `unauthenticated_read_product_pickup_locations` - `unauthenticated_read_collection_listings` - `unauthenticated_write_checkouts` - `unauthenticated_read_checkouts` 5. **Gere o token** - Clique em "Save" para salvar as configurações - Vá para a aba "API credentials" - Na seção "Storefront API access token", clique em "Create token" - Copie o token gerado ### 3. Configuração no arquivo .env Edite o arquivo `.env` e substitua os valores: ```env SHOPIFY_STORE_DOMAIN=sua-loja.myshopify.com SHOPIFY_PUBLIC_ACCESS_TOKEN=shpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ``` ## Testando a configuração Após configurar as variáveis de ambiente: 1. Compile o projeto: `npm run build` 2. Inicie o servidor: `npm start` 3. O servidor deve iniciar sem erros na porta 3000 ## Endpoints disponíveis - `GET /mcp` - Health check - `POST /mcp` - Endpoint principal do MCP - `DELETE /mcp` - Cleanup ## Troubleshooting ### Erro: "Missing required environment variables" - Verifique se o arquivo `.env` existe - Confirme se as variáveis estão definidas corretamente - Reinicie o servidor após alterar o `.env` ### Erro: "Invalid access token" - Verifique se o token foi copiado corretamente - Confirme se as permissões da Storefront API estão habilitadas - Gere um novo token se necessário ### Erro: "Store not found" - Verifique se o domínio está correto - Use o formato completo: `sua-loja.myshopify.com` - Não inclua `https://` no domínio