# MCP Create Project Server - Guía de Uso

Servidor MCP para creación de proyectos con flujo validado y registro automático.

## 🚀 Configuración en VS Code

### 1. Requisitos
- Visual Studio Code
- Extensión **GitHub Copilot Chat** (con soporte MCP)

### 2. Configurar el servidor MCP

**Opción A: Comando directo MCP**
- Presiona `Ctrl+Shift+P`
- Escribe: `MCP: Open User Configuration`
- Se abrirá el archivo `mcp.json` directamente
- Agrega la siguiente configuracion:

```json
{
	"servers": {
		"satrack-create-project": {
			"url": "https://mcp-dev-create-project.satrack.com",
			"type": "http"
		}
	},
	"inputs": []
}
```

**Opción B: Settings de VS Code**
- Presiona `Ctrl+Shift+P`
- Escribe: `Preferences: Open User Settings (JSON)`
- Agrega la sección `mcpServers` si no existe

Agrega la configuración del servidor:

```json
{
  "mcpServers": {
    "satrack-create-project": {             // servidor MCP para creación de proyectos
      "transport": "sse",
      "url": "https://mcp-dev-create-project.satrack.com"
    }
  }
}
```

### 3. Recarga VS Code
Presiona `Ctrl+Shift+P` → "Developer: Reload Window"

---

## 🧪 Pruebas con Copilot Chat (VS Code)

### Iniciar creación de proyecto

Abre GitHub Copilot Chat y usa:

```
@satrack-create-project agent_flow
```

O el alias corto:

```
@satrack-create-project validar
```

Esto carga las instrucciones obligatorias del flujo de creación de proyectos.

---

## 🔍 Ejemplo de Flujo Completo

> **Nota:** La identificación del usuario (`identify`) se realiza automáticamente al iniciar la sesión con tu cuenta de Satrack.

### Paso 1: Iniciar creación de proyecto
```
@satrack-create-project validar
```
Copilot te preguntará los parámetros requeridos para el scaffold (nombre, tipo, etc).

### Paso 2: Confirmar y ejecutar plantilla
Copilot propondrá el comando de plantilla (por ejemplo, `dotnet new st-api ...`).

Al confirmar, el servidor:
- Crea la carpeta destino si no existe
- Ejecuta el comando de plantilla
- Registra el reporte automáticamente en la base de datos

No es necesario realizar pasos manuales de commit, changelog ni versionado en este flujo.

---

## 📋 Herramientas MCP Disponibles

| Herramienta | Descripción |
|------------|-------------|
| `validar` / `agent_flow` | **Iniciar creación de proyecto** - Retorna flujo obligatorio de AGENTS.md |
| `bootstrap` | Inicialización completa: agent flow + reglas de creación |
| `identify` | Registrar usuario VSCode para métricas |
| `report_validation` | Registrar creación de proyecto en base de datos |
| `detect_stack` | Detectar framework del proyecto (para contexto) |
| `vscode_agents` | Detectar agentes VSCode disponibles |

---

## 🔗 Enlaces Útiles

- **Servidor Dev:** https://mcp-dev-create-project.satrack.com/
- **Grafana:** https://grafana.satrack.com/
- **Repositorio:** https://satrack-ts.visualstudio.com/Artificial-Intelligence/_git/mcp-create-projects

---

## 📄 Licencia

Uso interno - SATRACK