How do I use MCP SQL Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP SQL Server show me the schema and first 5 rows of the Employees table" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Guía de Autenticación - MCP SQL Server

Resumen

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

Autenticación de SQL Server (Tradicional)
Autenticación de Windows (Credenciales integradas)

Configuración de Variables de Entorno

Autenticación de SQL Server (Por defecto)

# 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

# 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)

{ "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)

{ "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)

{ "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

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

2. Servidor de Producción con Dominio

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

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:

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

Error de Conexión

# 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:

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

Notas de Seguridad

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

MCP SQL Server