docs(mcp): surface project config and readme entrypoints

Author: juanklagos

.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "sdd": {
+      "command": "node",
+      "args": [
+        "${PWD}/packages/sdd-mcp/dist/index.js"
+      ],
+      "env": {}
+    }
+  }
+}

README.es.md

@@ -36,6 +36,26 @@ No hay código sin spec aprobada y plan consistente.
 - Intermedio: [docs/es/14-guia-intermedia.md](./docs/es/14-guia-intermedia.md)
 - Avanzado: [docs/es/15-guia-avanzada.md](./docs/es/15-guia-avanzada.md)
 
+## 🔌 Conéctalo por MCP
+
+Si tu cliente de IA soporta MCP, este repositorio ya incluye un servidor local `sdd-mcp` y configuración compartida por proyecto.
+
+Ruta rápida:
+1. Compila el servidor:
+
+```bash
+npm install
+npm run build
+```
+
+2. Usa una de estas configuraciones:
+- Configuración de proyecto para Claude Code: [`.mcp.json`](./.mcp.json)
+- Ejemplo para Cursor: [`packages/sdd-mcp/examples/.cursor/mcp.json`](./packages/sdd-mcp/examples/.cursor/mcp.json)
+- Ejemplo para Codex: [`packages/sdd-mcp/examples/codex.config.toml`](./packages/sdd-mcp/examples/codex.config.toml)
+
+3. Lee la guía de instalación:
+- [docs/es/33-guia-servidor-mcp.md](./docs/es/33-guia-servidor-mcp.md)
+
 ## 🚨 Regla obligatoria antes de codificar
 
 Este template exige chequeos de política y compuerta:
@@ -136,6 +156,7 @@ Paquete obligatorio por feature:
 
 - Esenciales: [Estructura](./docs/es/01-estructura.md) · [Flujo](./docs/es/02-flujo-de-trabajo.md)
 - IA: [Agentes soportados](./docs/es/10-agentes-ia-soportados-y-prompts.md) · [Guía Lovable](./docs/es/17-trabajar-con-lovable.md)
+- MCP: [Guía del servidor MCP](./docs/es/33-guia-servidor-mcp.md)
 - Calidad: [Checklists por etapa](./docs/es/21-checklists-calidad-por-etapa.md) · [ADR](./docs/es/24-decisiones-de-arquitectura.md)
 
 ---

README.md

@@ -36,6 +36,26 @@ No code before approved spec and consistent plan.
 - Intermediate: [docs/en/14-intermediate-guide.md](./docs/en/14-intermediate-guide.md)
 - Advanced: [docs/en/15-advanced-guide.md](./docs/en/15-advanced-guide.md)
 
+## 🔌 Connect via MCP
+
+If your AI client supports MCP, this repository now includes a local `sdd-mcp` server and shared project config.
+
+Quick path:
+1. Build the server:
+
+```bash
+npm install
+npm run build
+```
+
+2. Use one of these configs:
+- Claude Code project config: [`.mcp.json`](./.mcp.json)
+- Cursor example: [`packages/sdd-mcp/examples/.cursor/mcp.json`](./packages/sdd-mcp/examples/.cursor/mcp.json)
+- Codex example: [`packages/sdd-mcp/examples/codex.config.toml`](./packages/sdd-mcp/examples/codex.config.toml)
+
+3. Read the setup guide:
+- [docs/en/33-mcp-server-guide.md](./docs/en/33-mcp-server-guide.md)
+
 ## 🚨 Mandatory Rule Before Coding
 
 This template enforces policy + gate checks:
@@ -136,6 +156,7 @@ Mandatory spec bundle (for each feature):
 
 - Essentials: [Structure](./docs/en/01-structure.md) · [Workflow](./docs/en/02-workflow.md)
 - AI: [Supported Agents](./docs/en/10-supported-ai-agents-and-prompts.md) · [Lovable Guide](./docs/en/17-working-with-lovable.md)
+- MCP: [MCP Server Guide](./docs/en/33-mcp-server-guide.md)
 - Quality: [Stage Checklists](./docs/en/21-quality-checklists-by-stage.md) · [ADR](./docs/en/24-architecture-decisions.md)
 
 ---