Conectar servidor MCP de Sales Layer a VS Code y GitHub Copilot :
Conectar servidor MCP de Sales Layer a VS Code y GitHub Copilot
Modificado el Mar, 2 Jun a 12:33 P. M.
Visual Studio Code puede conectarse al servidor MCP de Sales Layer para que GitHub Copilot Chat pueda usar las herramientas de Sales Layer en modo Agente. Esto permite a los equipos técnicos consultar y analizar datos del catálogo de Sales Layer directamente desde VS Code mientras trabajan en integraciones, scripts, comprobaciones de datos o tareas de desarrollo relacionadas con el catálogo.
Este artículo explica cómo añadir el servidor MCP de Sales Layer a VS Code, autorizar la conexión y usar las herramientas desde GitHub Copilot Chat.
Nota: Las funciones de VS Code y GitHub Copilot pueden variar según la versión instalada, las extensiones y las políticas de la organización. Si no ves las opciones de MCP, actualiza VS Code y comprueba si los servidores MCP están habilitados para tu organización de Copilot.
Antes de empezar
Antes de conectar el servidor MCP de Sales Layer a VS Code, asegúrate de tener:
- Visual Studio Code instalado.
- GitHub Copilot y GitHub Copilot Chat habilitados en VS Code.
- Acceso al modo Agente de Copilot Chat.
- Permiso para añadir servidores MCP en tu VS Code o en tu organización de GitHub.
- Acceso al catálogo de Sales Layer que quieres consultar.
- Tu Catalog Token de Sales Layer.
Actualmente, el Catalog Token no se obtiene desde una sección de API/Tokens dentro del PIM de Sales Layer. Para obtenerlo, contacta con el equipo de Soporte de Sales Layer o con tu representante de cuenta de Sales Layer.
Advertencia: No insertes directamente tu Catalog Token de Sales Layer en mcp.json ni lo subas a un repositorio.
Para el MCP Server remoto, la autenticación se completa mediante el flujo de autorización de Sales Layer.
Si guardas .vscode/mcp.json en un repositorio, no incluyas credenciales privadas ni valores de token en el archivo.
Elegir dónde guardar la configuración MCP
VS Code puede guardar la configuración del servidor MCP en dos lugares:
| Ubicación | Úsalo cuando | Archivo o comando |
|---|---|---|
| Espacio de trabajo | Quieres compartir la configuración del servidor MCP con un equipo de proyecto. | .vscode/mcp.json |
| Perfil de usuario | Quieres que el servidor MCP esté disponible en tus espacios de trabajo de VS Code. | MCP: Open User Configuration |
Para un proyecto de equipo, usa la configuración del espacio de trabajo. Para uso personal, usa la configuración del perfil de usuario.
Añadir el servidor MCP desde la Paleta de comandos
La configuración guiada es la forma más sencilla de añadir el servidor MCP de Sales Layer.
- Abre VS Code.
- Abre la Paleta de comandos con Cmd+Shift+P en macOS o Ctrl+Shift+P en Windows y Linux.
- Ejecuta MCP: Add Server.
- Elige la opción de servidor HTTP o remoto si VS Code te pide un tipo de servidor.
- Introduce la URL del servidor MCP de Sales Layer.
- Introduce un nombre para el servidor, por ejemplo sales-layer.
- Elige si quieres guardarlo en tu espacio de trabajo o en tu perfil de usuario.
- Inicia o habilita el servidor cuando VS Code te lo pida.
- Confirma que confías en la configuración del servidor MCP.
Usa esta URL para la configuración remota estándar:
Configuración alternativa con mcp.json
También puedes configurar el servidor MCP de Sales Layer manualmente editando mcp.json.
Para una configuración de espacio de trabajo, crea o edita este archivo:
Añade la siguiente configuración:
Después de guardar el archivo, VS Code debería detectar el MCP Server. Si no se inicia automáticamente, usa la Paleta de comandos y ejecuta MCP: List Servers, selecciona sales-layer e inicia el servidor.
Elegir el modo de acceso
Usa el modo de acceso que encaje con lo que quieres que GitHub Copilot haga con tu catálogo de Sales Layer.
| Modo | URL del servidor | Úsalo cuando |
|---|---|---|
| Conexión remota predeterminada | https://mcp.saleslayer.com/mcp | Quieres usar el endpoint MCP estándar de Sales Layer. |
| Solo lectura | https://mcp.saleslayer.com/onlyread/mcp | Copilot solo necesita inspeccionar, consultar o analizar datos del catálogo. |
| Acceso completo | https://mcp.saleslayer.com/full/mcp | Copilot necesita crear o actualizar datos de Sales Layer mediante herramientas MCP. |
Para la mayoría de las primeras configuraciones, empieza con Solo lectura. Usa Acceso completo solo en flujos de trabajo de confianza en los que se espere que Copilot modifique datos del catálogo.
Autorizar la conexión con Sales Layer
Cuando VS Code inicia el MCP Server remoto, el flujo de autorización de Sales Layer puede abrirse en tu navegador.
- Espera a que se abra la pantalla de autorización de Sales Layer.
- Selecciona el perfil de acceso si la pantalla te pide elegir uno.
- Introduce tu Catalog Token de Sales Layer.
- Valida el token y continúa.
- Vuelve a VS Code cuando el flujo de autorización haya terminado.
Usar las herramientas de Sales Layer en GitHub Copilot Chat
Una vez conectado el MCP Server, usa GitHub Copilot Chat en modo Agente.
- Abre GitHub Copilot Chat en VS Code.
- Selecciona el modo Agente en el desplegable de modo.
- Haz clic en el icono de herramientas o de Configure Tools.
- Busca la entrada del servidor MCP sales-layer.
- Revisa las herramientas de Sales Layer disponibles.
- Habilita las herramientas que quieres que Copilot use.
- Haz una pregunta sobre el catálogo de Sales Layer en el cuadro de chat.
Probar la conexión
Empieza con una consulta sencilla para confirmar que las herramientas de Sales Layer están disponibles:
Después, prueba con una pregunta relacionada con el catálogo:
Si la conexión funciona, Copilot debería poder llamar a las herramientas MCP de Sales Layer y devolver información de tu catálogo.
Ejemplos de consultas
Cuando la conexión esté lista, puedes hacer preguntas a GitHub Copilot como estas:
- Show me the available Sales Layer tools.
- Find products with missing descriptions.
- Check whether any products have empty technical attributes.
- Summarize the catalog structure.
- Help me inspect the data returned for a specific product reference.
- Help me design a script that validates product data using Sales Layer catalog information.
Gestionar o reiniciar el servidor MCP
Si necesitas reiniciar, deshabilitar o revisar el servidor MCP de Sales Layer, usa una de estas opciones:
- Ejecuta MCP: List Servers desde la Paleta de comandos.
- Selecciona el servidor sales-layer.
- Elige la acción que necesites, como iniciar, detener, reiniciar, mostrar la salida o deshabilitar.
- También puedes editar mcp.json y usar las acciones integradas que muestra VS Code.
Resolución de problemas
| Problema | Causa probable | Qué hacer |
|---|---|---|
| Los comandos MCP no están disponibles | Tu versión de VS Code o la extensión de Copilot puede no admitir servidores MCP. | Actualiza VS Code y GitHub Copilot y vuelve a comprobar la Paleta de comandos. |
| Los servidores MCP están bloqueados por una política de la organización | Tu organización de Copilot Business o Enterprise puede no permitir servidores MCP. | Pide al administrador de tu organización de GitHub que revise la política de servidores MCP para Copilot. |
| La autorización no se abre | El flujo OAuth no se ha iniciado, las ventanas emergentes del navegador están bloqueadas o el servidor no se ha iniciado correctamente. | Permite las ventanas emergentes del navegador, reinicia el MCP Server y revisa los registros de salida de MCP. |
| invalid_token | El Catalog Token se ha usado como token bearer directo en lugar de introducirse en la pantalla de autorización de Sales Layer. | Elimina cualquier configuración de bearer token y completa de nuevo el flujo de autorización de Sales Layer. |
| No aparecen herramientas de Sales Layer en Copilot Chat | Es posible que el servidor no esté habilitado, no sea de confianza o no se haya iniciado. | Ejecuta MCP: List Servers, inicia el servidor, confirma la confianza y revisa Configure Tools en modo Agente. |
| Copilot no usa las herramientas de Sales Layer | Puede que el modo Agente no esté seleccionado o que las herramientas estén deshabilitadas. | Abre Copilot Chat, selecciona el modo Agente y habilita las herramientas de Sales Layer desde Configure Tools. |
| Las operaciones de lectura funcionan, pero las actualizaciones fallan | La conexión está usando acceso de solo lectura. | Usa el acceso completo solo si tu flujo de trabajo requiere acciones de escritura y tu organización lo permite. |
Buenas prácticas
Empieza con acceso de solo lectura cuando solo necesites que Copilot inspeccione, consulte o analice datos del catálogo.
Usa la configuración del espacio de trabajo solo cuando el MCP Server deba compartirse con el equipo. Usa la configuración de usuario cuando el servidor sea personal para tu perfil de VS Code.
No subas credenciales ni valores de token a un repositorio. Mantén mcp.json libre de claves privadas y secretos.
Después de añadir o cambiar el MCP Server, reinícialo y pruébalo con una consulta sencilla antes de usarlo para trabajo real con el catálogo.
Cuando trabajes en un entorno de equipo o enterprise, confirma que tu organización de GitHub permite servidores MCP en Copilot antes de revisar la configuración de Sales Layer.