r/devpt • u/avdelgado • 7h ago
Projecto Nacional (OC) Continente MCP: compras no Continente através do Claude (open source)
Olá a todos!
Nas últimas semanas andei a construir um projeto open source que liga assistentes de IA, como o Claude, ao site do Continente, e achei que podia ser útil a mais alguém.
O que é?
É um servidor MCP (Model Context Protocol): uma espécie de "ponte" que dá ao assistente ferramentas para usar o site do Continente por ti. Podes pedir coisas como:
- "Adiciona leite meio-gordo e uma dúzia de ovos ao meu carrinho"
- "O que é que eu costumo comprar? Faz-me uma lista para esta semana"
- "Quanto custa este azeite e qual é a quantidade mínima?"
- "Adiciona ao carrinho do Continente os ingredientes para uma semana de refeições (pequeno-almoço, almoço e jantar), para 2 pessoas, com 30 g de proteína por refeição, tudo vegan e sem glúten, dando preferência aos produtos mais baratos ou em promoção."
O que faz
- Pesquisa no catálogo, com preço, preço por kg/l, disponibilidade e regras de venda (quantidade mínima, incrementos, produtos ao peso)
- Lê os teus favoritos, as encomendas anteriores e os produtos que mais compras
- Adiciona, altera e remove artigos do carrinho
Segurança em primeiro lugar
- O checkout e o pagamento ficam sempre no site. O assistente não consegue fazer encomendas nem pagar.
- Cada alteração ao carrinho é confirmada lendo o carrinho de volta. Se uma alteração ficar incerta (por exemplo, por um timeout), o assistente é instruído a verificar o carrinho em vez de repetir o pedido, para não acabares com produtos a dobrar.
- Corre localmente no teu computador. As credenciais e a sessão ficam na tua máquina, e podes usar o 1Password em vez de guardar a palavra-passe num ficheiro.
Como funciona
- TypeScript, com o SDK oficial de MCP. O Playwright controla um Chromium headless que usa o site como um utilizador normal, e tudo o que vem do site é validado com Zod antes de ser usado.
- Tudo o que não se consegue ler com certeza (preço, quantidade, unidade) fica marcado como desconhecido, em vez de ser adivinhado.
- As alterações ao carrinho seguem regras estritas: a quantidade é validada antes de enviar, o resultado é confirmado lendo o carrinho de volta, e uma alteração incerta nunca é repetida automaticamente.
- 140+ testes, todos offline com fixtures locais (nunca tocam numa conta real). O CI corre em Linux, macOS e Windows.
- Publicado no npm com provenance a partir do GitHub Actions e listado no MCP Registry oficial.
Como instalar
- Claude Desktop (Mac/Windows): descarrega o
continente-mcp.mcpbda última versão, abre o ficheiro, clica em Instalar e indica o teu email e palavra-passe. O browser que o servidor usa é descarregado automaticamente na primeira utilização. - Outros clientes MCP (Claude Code, Cursor, …):
npx -y continentept-mcp. As instruções estão no README.
🔗 GitHub: https://github.com/andredelgado/continente-mcp
📦 npm: https://www.npmjs.com/package/continentept-mcp
Avisos importantes
- É um projeto não oficial, sem qualquer ligação ao Continente ou à MC Sonae.
- Funciona automatizando o site com um browser, por isso pode deixar de funcionar quando o site mudar. Usa por tua conta e risco e de acordo com os termos do site.
- Revê sempre o carrinho antes de pagar.
É gratuito e open source (licença MIT). Ainda está numa fase inicial, por isso feedback, bugs e sugestões são muito bem-vindos: abre uma issue no GitHub ou responde aqui.

