# Guía de Autenticación - MCP SQL Server

## Resumen

Este servidor MCP para SQL Server ahora soporta dos métodos de autenticación:

1. **Autenticación de SQL Server** (Tradicional)
2. **Autenticación de Windows** (Credenciales integradas)

## Configuración de Variables de Entorno

### Autenticación de SQL Server (Por defecto)

```env
# Configuración básica
SERVER_NAME=localhost
DATABASE_NAME=mi_base_datos
USE_WINDOWS_AUTH=false

# Credenciales de SQL Server
USERNAME=mi_usuario_sql
PASSWORD=mi_contraseña_sql

# Opciones adicionales
TRUST_SERVER_CERTIFICATE=true
CONNECTION_TIMEOUT=30
ENCRYPT=false
READONLY=false
```

### Autenticación de Windows

```env
# Configuración básica
SERVER_NAME=localhost
DATABASE_NAME=mi_base_datos
USE_WINDOWS_AUTH=true

# Opciones para credenciales de Windows
DOMAIN=MI_DOMINIO          # Opcional: dominio (vacío para máquina local)
USERNAME=mi_usuario_windows # Opcional: usuario específico (vacío para usuario actual)
PASSWORD=mi_contraseña_win  # Opcional: contraseña (vacío para usuario actual)

# Opciones adicionales
TRUST_SERVER_CERTIFICATE=true
CONNECTION_TIMEOUT=30
ENCRYPT=false
READONLY=false
```

## Ejemplos de Configuración

### Ejemplo 1: SQL Server Authentication (Desarrollo local)

```json
{
  "mcpServers": {
    "mssql-local": {
      "command": "node",
      "args": ["C:/ruta/a/tu/proyecto/dist/index.js"],
      "env": {
        "SERVER_NAME": "localhost",
        "DATABASE_NAME": "TestDB",
        "USE_WINDOWS_AUTH": "false",
        "USERNAME": "sa",
        "PASSWORD": "MiContraseña123!",
        "TRUST_SERVER_CERTIFICATE": "true",
        "READONLY": "false"
      }
    }
  }
}
```

### Ejemplo 2: Windows Authentication (Usuario actual)

```json
{
  "mcpServers": {
    "mssql-windows": {
      "command": "node",
      "args": ["C:/ruta/a/tu/proyecto/dist/index.js"],
      "env": {
        "SERVER_NAME": "SERVIDOR-EMPRESA",
        "DATABASE_NAME": "ProductionDB",
        "USE_WINDOWS_AUTH": "true",
        "TRUST_SERVER_CERTIFICATE": "true",
        "READONLY": "true"
      }
    }
  }
}
```

### Ejemplo 3: Windows Authentication (Usuario específico)

```json
{
  "mcpServers": {
    "mssql-domain": {
      "command": "node",
      "args": ["C:/ruta/a/tu/proyecto/dist/index.js"],
      "env": {
        "SERVER_NAME": "sql-server.empresa.com",
        "DATABASE_NAME": "EmpresaDB",
        "USE_WINDOWS_AUTH": "true",
        "DOMAIN": "EMPRESA",
        "USERNAME": "juan.perez",
        "PASSWORD": "ContraseñaDominio123!",
        "ENCRYPT": "true",
        "READONLY": "false"
      }
    }
  }
}
```

## Casos de Uso Comunes

### 1. Desarrollo Local con SQL Server Express

```env
SERVER_NAME=localhost\SQLEXPRESS
DATABASE_NAME=MiAppDB
USE_WINDOWS_AUTH=true
TRUST_SERVER_CERTIFICATE=true
READONLY=false
```

### 2. Servidor de Producción con Dominio

```env
SERVER_NAME=sqlprod.empresa.local
DATABASE_NAME=ProdDB
USE_WINDOWS_AUTH=true
DOMAIN=EMPRESA
USERNAME=svc_aplicacion
PASSWORD=contraseña_servicio
ENCRYPT=true
READONLY=true
```

### 3. Servidor Remoto con Autenticación SQL

```env
SERVER_NAME=192.168.1.100,1433
DATABASE_NAME=RemoteDB
USE_WINDOWS_AUTH=false
USERNAME=app_user
PASSWORD=app_password123
TRUST_SERVER_CERTIFICATE=false
ENCRYPT=true
READONLY=false
```

## Solución de Problemas

### Error de Autenticación de Windows

Si tienes problemas con la autenticación de Windows:

1. Verifica que el usuario tenga permisos en SQL Server
2. Asegúrate de que el servidor SQL Server esté configurado para autenticación mixta
3. Comprueba que el dominio sea correcto (usa `echo %USERDOMAIN%` en cmd)

### Error de Conexión

```env
# Aumenta el timeout si tienes conexiones lentas
CONNECTION_TIMEOUT=60

# Habilita certificados auto-firmados para servidores locales
TRUST_SERVER_CERTIFICATE=true

# Verifica la configuración de encriptación
ENCRYPT=false
```

### Verificar Configuración

Para verificar qué usuario está conectándose, puedes ejecutar esta consulta una vez conectado:

```sql
SELECT 
    SYSTEM_USER as 'Login Name',
    USER_NAME() as 'User Name',
    @@SERVERNAME as 'Server Name',
    DB_NAME() as 'Database Name'
```

## Notas de Seguridad

1. **Credenciales**: Nunca expongas credenciales en código fuente
2. **Solo lectura**: Usa `READONLY=true` en entornos de producción cuando sea posible
3. **Encriptación**: Habilita `ENCRYPT=true` para conexiones remotas
4. **Permisos mínimos**: Otorga solo los permisos necesarios al usuario de base de datos
5. **Variables de entorno**: Usa archivos `.env` para credenciales locales (no los subas a git)