DevReview

Ferramenta de code review assistida por IA — projeto base do Curso 5: MCP, Conectando o Agent ao Mundo Real.

Stack

Frontend: React 18, TypeScript, Vite, TailwindCSS, shadcn/ui, Redux Toolkit
Backend (construído durante o curso): Node.js, @modelcontextprotocol/sdk, Zod
Banco de dados: Supabase (PostgreSQL)

Pré-requisitos

Node.js 20+
npm 10+
Um projeto na Supabase (o banco roda na nuvem, não localmente)

Como rodar

# 1. Instalar dependências
npm install

# 2. Copiar variáveis de ambiente
cp apps/web/.env.example apps/web/.env

# 3. Preencher apps/web/.env com a URL do projeto e a publishable key
#    (Supabase → Project Settings → API)

# 4. Iniciar o frontend
npm run dev

O app abre em http://localhost:5173.

O schema vive em supabase/migrations/ e os dados de demonstração em supabase/seed.sql — são a fonte da verdade, aplicados no projeto da nuvem pelas tools do MCP da Supabase.

Configuração de MCP

.mcp.json na raiz configura os servidores MCP no escopo deste projeto, sem mexer no seu config global. Ele é gitignored, porque é onde entram os segredos dos módulos seguintes:

cp .mcp.json.example .mcp.json   # e troque <SEU_PROJECT_REF>

Três servidores ficam registrados:

Servidor	Transporte	Autenticação
`supabase`	HTTP — `mcp.supabase.com`	OAuth no navegador
`github`	HTTP — `api.githubcopilot.com/mcp/readonly`	OAuth no navegador
`devreview`	STDIO — `apps/mcp-server/build/index.js`	nenhuma (local)

Nenhum token fica em disco. O do GitHub está na variante /readonly, que bloqueia as tools de escrita; para liberar (abrir issue, comentar PR), remova o /readonly da url.

Estrutura

devreview/
├── apps/
│   ├── web/          # Frontend React
│   └── mcp-server/   # MCP Server (construído durante o curso)
├── supabase/         # Configuração, migrations e seed data
└── docs/             # Documentação do curso (gitignored)

Team id de exemplo

11111111-1111-1111-1111-111111111111