Recetas de setup por cliente

Cómo hacer Pasos para una tarea concreta. Da por sabido lo básico.

Propósito

Recetas exactas y copiables para los clientes IA locales que más se usan con este framework. Sin variantes ni ramas: el archivo, el bloque a pegar y cómo comprobar que quedó bien.

Atajo (spec 032): npx @juanklagos/sdd-mcp@latest connect hace todo esto por ti — detecta tus clientes, escribe la configuración en el archivo de cada uno (fusionando, sin pisar lo tuyo) e instala la skill /sdd-serve. Cubre además Windsurf, VS Code, Gemini CLI y opencode, que esta guía no trae. Ver guía 51. Las recetas de abajo son la referencia manual y la ruta para quien desarrolla el propio template (usan node …/dist/index.js en vez de npx @juanklagos/sdd-mcp@latest).

Mapa de setup por cliente

flowchart LR
  A["Compilar MCP"] --> B["Cursor"]
  A --> C["Claude Code"]
  A --> D["Codex"]

Regla compartida

• Abre este repositorio como raíz del workspace.
• Compila primero:

npm install
npm run build

Cursor

Archivo de configuración:

• ~/.cursor/mcp.json

Ejemplo:

{
  "mcpServers": {
    "sdd": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/RUTA/ABSOLUTA/A/spec-driven-development-template/packages/sdd-mcp/dist/index.js"
      ]
    }
  }
}

Validación:

• reinicia Cursor
• confirma que el servidor sdd aparece listado
• pide al agente leer sdd://policy/current

Claude Code

Configuración por proyecto:

• .mcp.json

Configuración por usuario:

• ~/.claude.json

Ejemplo por proyecto:

{
  "mcpServers": {
    "sdd": {
      "command": "node",
      "args": [
        "/RUTA/ABSOLUTA/A/spec-driven-development-template/packages/sdd-mcp/dist/index.js"
      ],
      "env": {}
    }
  }
}

Validación:

• abre el repositorio
• confirma que Claude accede al servidor sdd
• pídele listar tools y leer el resource de quickstart

Codex

Archivo de configuración:

• ~/.codex/config.toml

Ejemplo:

[mcp_servers.sdd]
command = "node"
args = ["/RUTA/ABSOLUTA/A/spec-driven-development-template/packages/sdd-mcp/dist/index.js"]

Validación:

• reinicia Codex
• confirma que el servidor está disponible
• pídele usar sdd_validate o leer sdd://docs/quickstart

Prompt inicial recomendado

Usa el servidor MCP sdd conectado para este repositorio.
Crea primero la base SDD.
Prefiere ./www/<nombre-proyecto> como espacio recomendado por defecto; también se soportan rutas externas.
Lee los resources de policy y quickstart antes de hacer cambios.
No implementes código antes de spec aprobada y plan consistente.