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 a el 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:

https://mcp.saleslayer.com/mcp

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:

.vscode/mcp.json

Añade la siguiente configuración:

{
  "servers": {
    "sales-layer": {
      "type": "http",
      "url": "https://mcp.saleslayer.com/mcp"
    }
  }
}

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:

What Sales Layer tools are available?

Después, prueba con una pregunta relacionada con el catálogo:

Show me a summary of my Sales Layer catalog.

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.