MCP SQL Server

# 🚀 Guía Rápida de Configuración - MCP SQL Server > Configuración en 5 minutos para acceder a SQL Server desde Cursor --- ## 📋 Pre-requisitos - ✅ Cursor IDE instalado - ✅ Credenciales SQL Server (solicitar al DBA si no las tienes) - ✅ Acceso de red a `mcpserver.yuuu.local` --- ## ⚙️ Configuración Paso a Paso ### 1️⃣ Abrir el archivo de configuración MCP **Windows:** ``` C:\Users\TU_USUARIO\.cursor\mcp.json ``` **macOS/Linux:** ``` ~/.cursor/mcp.json ``` ### 2️⃣ Agregar la configuración Copia y pega este contenido (reemplaza `TU_USUARIO` y `TU_CONTRASEÑA`): ```json { "mcpServers": { "ylce_magma01_test": { "url": "http://mcpserver.yuuu.local:35001/mcp", "headers": { "X-MCP-SQL-USER": "TU_USUARIO", "X-MCP-SQL-PASSWORD": "TU_CONTRASEÑA", "X-MCP-SQL-SERVER": "dbserver.local", "X-MCP-SQL-DATABASE": "ylce_magma01_test", "X-MCP-SQL-PORT": "1433", "X-MCP-SQL-DRIVER": "ODBC Driver 17 for SQL Server" } } } } ``` **Si ya tienes otros servidores MCP configurados**, solo agrega la sección `ylce_magma01_test` dentro de `mcpServers`. ### 3️⃣ Guardar y reiniciar Cursor 1. Guarda el archivo `mcp.json` 2. **Cierra Cursor completamente** (no solo recarga) 3. Abre Cursor nuevamente 4. Espera 5 segundos para que se establezca la conexión ### 4️⃣ Probar la conexión En el chat de Cursor, escribe: ``` ¿Qué bases de datos tengo disponibles? ``` Deberías ver una lista como: - PT_AGENTES_DEV - PT_CUSTOMERAREA_DEV - YLCE_MAGMA01_DEV - YLCE_MAGMA01_TEST - etc. --- ## 💡 Ejemplos de Uso ### Listar tablas de una base de datos ``` Muéstrame las tablas de la base de datos YLCE_MAGMA01_TEST ``` ### Ver estructura de una tabla ``` Describe la tabla adaptacion_contadores ``` ### Ver datos de ejemplo ``` Muéstrame 10 filas de ejemplo de la tabla temp_id_original ``` ### Consultar columnas específicas ``` Dame las columnas cups y fecha_inicio de la tabla adaptacion_contadores, limita a 5 resultados ``` --- ## 🔧 Problemas Comunes ### ❌ "No credentials provided" **Solución:** - Verifica que el archivo `mcp.json` esté en la ruta correcta - Reinicia Cursor completamente - Asegúrate de tener la sección `"headers"` configurada ### ❌ "Login failed for user" **Solución:** - Verifica usuario y contraseña en `mcp.json` - Prueba las mismas credenciales en SQL Server Management Studio - Contacta al DBA si el usuario está bloqueado ### ❌ No aparece nada / No responde **Solución:** - Verifica que el servidor está activo (ping a `mcpserver.yuuu.local`) - Espera 10 segundos después de abrir Cursor - Revisa la barra inferior de Cursor para ver el estado de conexión MCP --- ## 🔐 Seguridad ⚠️ **IMPORTANTE:** - ✅ Usa tu propio usuario SQL Server - ✅ Mantén tu `mcp.json` privado (no lo compartas) - ✅ No subas `mcp.json` a repositorios Git - ❌ No uses credenciales de otros desarrolladores - ❌ No compartas tu contraseña --- ## 📞 Contacto **Problemas técnicos:** - DevOps / Equipo de Desarrollo **Solicitar credenciales SQL:** - Contactar al DBA **Servidor caído o no responde:** - Verificar en PM2: `pm2 status mcp-sql` - Contactar a DevOps --- ## 📚 Documentación Completa Para más detalles, consulta el [README.md](./README.md) completo. --- **Última actualización:** Noviembre 2025