# Commerce MCP Server

Servidor MCP demonstrativo para operacoes de e-commerce: catalogo, pedidos e integracoes com plataformas de loja.

Este e um repo publico sanitizado. Ele nasceu da necessidade de operar e-commerce com ferramentas externas sem expor credenciais, tokens de loja ou dados de cliente.

## O que este projeto demonstra

- Arquitetura de adapter para APIs de e-commerce.
- Contratos de tools pensados para agentes/automacoes.
- Validacao centralizada de ambiente.
- Testes em regras de catalogo.
- Cuidado com limites entre codigo publico e credenciais privadas.

## Tools previstas

- `searchProducts`: busca produtos por termo, status e estoque.
- `getProduct`: consulta SKU/produto por identificador.
- `updatePrice`: atualiza preco com validacao.
- `createOrderNote`: registra observacao operacional em pedido.

## Rodando

```bash
npm install
npm test
npm run build
```

## Seguranca

- Use `.env.example` como referencia.
- Nunca versionar `.env`.
- Tokens de loja devem ser revogados antes de abrir qualquer repo antigo.
- Logs devem mascarar Authorization, cookies e payloads de cliente.