Commerce Cloud MCP Server

🛍️ Commerce Cloud MCP Server

Um servidor que ajuda a conectar seus aplicativos de IA com o Salesforce Commerce Cloud. Ele usa o Model Context Protocol (MCP) para facilitar a troca de dados entre seu aplicativo cliente de IA e a instância do Commerce Cloud.

✨ Recursos

• 🛍️ Gerenciamento e atualizações de produtos
• 📊 Análise de pedidos e insights
• 🗂️ Operações com objetos personalizados
• 📄 Gerenciamento de ativos de conteúdo
• ⚙️ Configuração baseada em ambiente

🔄 Diagrama de Fluxo

🚀 Instruções de Configuração

Pré-requisitos

• Node.js versão 22 ou superior
• Git
• Uma instância do Salesforce Commerce Cloud com acesso OCAPI
• Um aplicativo cliente MCP (como o Claude Desktop App)

Etapas de Instalação

1. Clone o repositório:

git clone https://github.com/your-username/commercecloud-mcp-server.git
cd commercecloud-mcp-server

2. Instale as dependências:

npm install

3. Crie e configure seu arquivo de ambiente:

cp .env.example .env

Edite o arquivo .env com suas credenciais do Salesforce Commerce Cloud.

4. Compile o projeto:

npm run build

5. Importe as configurações OCAPI:

   Os arquivos de configuração OCAPI estão localizados no diretório data/ocapi. Importe-os para o seu SFCC Business Manager:

   • Faça login no Business Manager
   • Navegue até Administração > Desenvolvimento do Site > Configurações da Open Commerce API
   • Para cada arquivo JSON no diretório data/ocapi:
     • Selecione o tipo de API apropriado (Shop/Data)
     • Copie o conteúdo do arquivo JSON
     • Cole no campo de configuração
     • Clique em "Salvar"

   Essas configurações habilitam os endpoints necessários para o funcionamento do servidor MCP.

6. Configure seu aplicativo cliente MCP (Exemplo - Claude Desktop App):

   • Abra o Claude Desktop App
   • Vá para Arquivo > Configurações > Desenvolvedor > Editar Config
   • Isso abrirá uma pasta contendo um arquivo claude_desktop_config.json
   • Abra o arquivo em um editor e adicione os detalhes do servidor:

{
  "mcpServers": {
    "commercecloud": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/commercecloud-mcp-server/dist/index.js"]
    }
  }
}

Observação: Substitua /ABSOLUTE/PATH/TO/ pelo caminho real da sua pasta do projeto.

📋 Casos de Uso

Nome do Caso de Uso	Descrição	Status da Implementação
Detalhes do Produto	Buscar informações do produto no Commerce Cloud	✅ Suportado Agora
Atualizações de Produto	Gerar descrições de produtos a partir de imagens e atualizar detalhes automaticamente	✅ Suportado Agora
Detalhes do Pedido	Analisar padrões de pedidos e obter insights sobre o comportamento de compra	✅ Suportado Agora
Objetos Personalizados	Ler, Escrever e Criar objetos personalizados	✅ Suportado Agora
Ativos de Conteúdo	Buscar ativos de conteúdo do Commerce Cloud	✅ Suportado Agora
Atualizações de Conteúdo	Gerar corpo de conteúdo a partir de imagens de design e atualizar ativos automaticamente	✅ Suportado Agora
Preferências do Site	Gerenciar configurações e preferências específicas do site	🔄 Implementação Futura
Promoções e Campanhas	Gerenciar promoções e campanhas	🔄 Implementação Futura
Configurações de Jobs	Gerenciar configurações de jobs	🔄 Implementação Futura

📚 Documentação de Apoio

• Model Context Protocol (MCP)
• Typescript SDK
• Open Commerce API

📄 Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

👥 Créditos

Mentes maiores que a minha estão por trás da criação das ferramentas que tornaram este projeto possível. Gostaria de mencionar esses projetos

• colinhacks por (zod).
• Egoist por (tsup)

Espero que você ache esta ferramenta útil! 🌟

Feito com ❤️ por Brinsil.