Melbis Shop
Servidor MCP oficial da Melbis Shop, uma plataforma de e-commerce auto-hospedada: um agente de IA trabalha na loja como um funcionário — arquivos, banco de dados, catálogo, pedidos — sob um login de equipe com permissões por comando.
Documentação
🛒 Melbis Shop — e-commerce auto-hospedado com um agente de IA na equipe
Melbis Shop é uma plataforma de e-commerce auto-hospedada: seu servidor, seu domínio, seus dados. Um back-office nativo para Windows e uma vitrine em PHP compartilham a mesma lógica de negócio, e o pacote inclui um servidor MCP, para que um agente de IA — Claude Code, Goose, Cherry Studio, qualquer coisa que fale MCP — trabalhe na sua loja como um funcionário: com um login de equipe, com as permissões dessa pessoa, e cada ação assinada com o nome dela.
Construída desde 2002 para lojas com equipes reais: vários fornecedores e listas de preços, de centenas a centenas de milhares de produtos, funcionários que não devem ver os dados uns dos outros.
🎯 Para quem é
Para um vendedor que superou um marketplace e quer um canal próprio ao lado dele — com uma equipe de duas a cinco pessoas, listas de preços de fornecedores e centenas de SKUs. Não é um construtor de páginas para um único produto.
⚙️ Instalação automática
Você não toca em um console. No cliente Windows, você informa três coisas — o endereço do servidor, a senha de root e seu domínio — e o cliente instala tudo via SSH sozinho: Docker, nginx, MySQL, PHP, o certificado SSL, a loja. As atualizações funcionam da mesma forma, pela mesma janela. Um VPS Ubuntu limpo vira uma loja funcionando em uma única sessão.
Sete passos com capturas de tela, desde alugar um servidor até a primeira tarefa para o agente: https://melbis.com/en/doc/install/start/
🤖 O que o agente de IA faz aqui
- 56 ferramentas MCP inclusas: arquivos do projeto (módulos, templates, estáticos, imagens — com histórico de versões), o banco de dados (pools de etapas com bloqueios e marcas de cache), árvores de catálogo, arquivos de produto, páginas da vitrine como o visitante as vê, e a própria documentação da plataforma.
- 26 ferramentas de loja com 244 comandos acompanham a loja de demonstração: produtos e preços, descrições, catálogo e atributos, fornecedores, pedidos, tarefas agendadas, usuários, perfis de imagem, importação em lote de mercadorias e arquivos.
- Permissões por comando. Ferramentas são dados, não código: o proprietário concede cada comando a uma pessoa ou grupo. Um funcionário sem acesso ao banco de dados ainda executa o agente — dentro dos próprios direitos dele.
- Uma execução real, com log e capturas de tela: uma mensagem em palavras simples → a primeira versão funcional de uma loja — moedas, fornecedores, um catálogo com 12 produtos, três papéis com direitos separados, um roteiro de processo de negócio — em 24 min 45 s e 21,2 mil tokens. Mais meia hora: um redesign a partir de um template gratuito de terceiros. → https://melbis.com/en/doc/install/ai_work/
Conectando um cliente MCP
O servidor MCP (MelbisMCP.exe, stdio) é instalado junto com o cliente Windows — nada para baixar separadamente. No cliente, abra Sistema → Conexão → Assistente de IA: a configuração pronta está lá com um botão Copiar para Goose, Cherry Studio e outros aplicativos MCP; Verificar Conexão testa a licença, o login e os direitos e diz em palavras o que está faltando. Claude Code não precisa de configuração alguma — o cliente grava .mcp.json na pasta da loja; abra essa pasta como um projeto. O agente entra com o login de quem o executa; não há conta de IA, licença ou senha separada no chat.
🚀 O que torna a plataforma diferente
- 🧮 Uma única lógica de negócio para a vitrine e o back-office: um pedido é calculado pelo mesmo código no aplicativo Windows e no site. Nada para sincronizar, nada para divergir.
- 🔐 Permissões até o nível da operação, da hora do dia e da carga do servidor, além de quatro planos de acesso independentes em cada seção do catálogo — descrições, preços, posicionamento, navegação. Gerentes de conteúdo nunca veem preços de compra.
- ⚡ Back-office em lote. A equipe carrega um trecho do catálogo em um banco de dados local, edita como uma planilha — atribuições em massa, fórmulas por coluna — e envia as alterações em um único pacote. A vitrine funciona quase somente leitura.
- 🧊 Cache de cinco níveis cujas dependências são coletadas automaticamente das consultas que um módulo executa. O cache Trick serve uma cópia mais antiga durante um pico de carga; o cache Smart atualiza antes da expiração em um momento de calmaria.
- 📦 Pedidos com versões, armazéns e estoque de fornecedores, regras fiscais em uma árvore de territórios, grupos de desconto, grupos de clientes com regras automáticas de fidelidade, documentos impressos no FastReport.
- 🛠️ Um ambiente de desenvolvimento dentro do back-office: módulos, templates e estáticos editados no servidor com histórico de versões, consoles SQL, configurações de cache por módulo, ajuda de IA no editor com qualquer modelo compatível com OpenAI e sua própria chave.
- 🧩 Vitrine na sua stack: o mecanismo de template PHP embutido, ou Laravel na mesma lógica de pedidos — melbis/melbis-shop-laravel.
- 🌍 Interface em 8 idiomas; conteúdo da vitrine traduzido manualmente ou automaticamente.
🖥️ O que está sob o capô
- Servidor: Ubuntu com Docker — nginx 1.26, PHP 8.3 no Apache, MySQL 8.4, Certbot para SSL. Instalado e atualizado pelo cliente; os mesmos
setup.sheupdate.shvivem neste repositório. - Cliente: um aplicativo Windows nativo com um banco de dados Firebird local por loja.
- Agente de IA: qualquer aplicativo compatível com MCP na mesma máquina Windows. O servidor MCP faz parte do pacote do cliente; sem licença separada.
💰 Licenciamento
Grátis para instalar e executar em modo de demonstração. Uma licença está vinculada a um login de equipe, não a um computador, e começa em 1 € por dia; licenças mensais e anuais, funcionalidade completa em todos os planos: https://melbis.com/en/price/
🔗 Links
- 🌍 Site: melbis.com
- 📖 Documentação — instalação e o agente de IA: melbis.com/en/doc/install/start
- 📘 Referência do cliente Windows: melbis.com/help/en
- 📚 Guia da plataforma em Markdown: docs/guide
- 🤖 Documentação do servidor MCP para o agente de IA: docs/mcp
- 📀 Pacotes de instalação: melbis.com/en/download
- 💻 Versões: melbis/melbis-shop/releases
- 🐳 Docker Hub: melbis/melbis-shop
- 📦 Packagist: melbis/melbis-shop
- 🧾 Requisitos de sistema: wiki
- 💬 Discussões: github.com/melbis/melbis-shop/discussions
- 🖼️ Capturas de tela: melbis.com/en/screenshots
Seu servidor. Seu domínio. Seu parceiro de IA.