Descripción general

El servidor MCP de Sales Layer se puede utilizar con cualquier cliente compatible con el Model Context Protocol que pueda conectarse de forma segura a servidores MCP remotos.

Este artículo explica los valores generales de configuración que debes utilizar al conectar Sales Layer con clientes compatibles con MCP que no tienen una guía específica de configuración de Sales Layer.

Antes de empezar

Antes de conectar otro cliente compatible con MCP a Sales Layer, asegúrate de tener:

• Un cliente compatible con MCP que admita servidores MCP remotos o configuración de servidores MCP locales.
• Compatibilidad con OAuth 2.0 con PKCE si utilizas el servidor MCP remoto de Sales Layer.
• Acceso al catálogo de Sales Layer que quieres utilizar.
• Tu Catalog Token de Sales Layer.
• Permiso de tu organización para conectar herramientas externas de IA a los datos de tu catálogo de producto.

Actualmente, el Catalog Token no se obtiene desde una sección de API/Tokens dentro del PIM de Sales Layer. Para conseguirlo, contacta con el equipo de soporte de Sales Layer o con tu representante de cuenta de Sales Layer.

Elegir el tipo de conexión

Los clientes MCP pueden conectarse a Sales Layer de diferentes formas según lo que admita cada cliente.

Si tu cliente admite MCP remoto con OAuth 2.0 y PKCE, utiliza la opción de servidor MCP remoto. Si no lo admite, comprueba si puedes utilizar un puente local o un paquete local.

Elegir el modo de acceso

Utiliza el modo de acceso que coincida con lo que el cliente MCP debe poder hacer con tu catálogo de Sales Layer.

Para la mayoría de configuraciones iniciales, empieza con Solo lectura. Utiliza Acceso completo solo en flujos de trabajo de confianza en los que se espere que el cliente de IA modifique datos del catálogo.

Opción 1: Conectar mediante una URL de servidor MCP remoto

Utiliza esta opción cuando el cliente admita servidores MCP remotos y OAuth 2.0 con PKCE.

1. Abre tu cliente compatible con MCP.
2. Ve a la sección de herramientas, conectores, extensiones, agentes o servidores MCP.
3. Añade un nuevo servidor MCP.
4. Introduce un nombre claro para el servidor, por ejemplo Sales Layer MCP.
5. Introduce la URL del servidor MCP de Sales Layer.
6. Selecciona OAuth 2.0 si el cliente te pide un método de autenticación.
7. Utiliza el descubrimiento dinámico si el cliente lo admite.
8. Guarda o conecta el servidor.

Utiliza esta URL para la configuración remota estándar:

https://mcp.saleslayer.com/mcp

Valores OAuth manuales

Si el cliente no admite el descubrimiento dinámico y solicita valores OAuth manuales, utiliza la siguiente configuración:

Opción 2: Conectar mediante un puente local

Algunos clientes MCP admiten servidores locales basados en comandos, pero no admiten OAuth remoto para MCP directamente. En este caso, tu equipo técnico puede utilizar un puente local como mcp-remote, si tu organización lo permite.

Ejemplo de configuración:

{
  "mcpServers": {
    "sales-layer": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.saleslayer.com/mcp"]
    }
  }
}

Esta configuración inicia un proceso MCP local y lo conecta al servidor MCP remoto de Sales Layer. Normalmente requiere Node.js, npx y permiso para ejecutar comandos locales en el ordenador.

Opción 3: Utilizar un paquete MCP local

Algunos clientes admiten paquetes MCP locales. En esta configuración, el servidor MCP se ejecuta localmente y el Catalog Token se introduce durante la configuración del paquete.

Utiliza esta opción solo cuando Sales Layer proporcione un paquete local para el cliente o cuando el cliente admita la instalación de paquetes MCP compatibles.

1. Descarga el paquete MCP local de Sales Layer desde la página MCP de Sales Layer o desde la ubicación proporcionada por el equipo de soporte de Sales Layer.
2. Instala el paquete en tu cliente compatible con MCP.
3. Introduce tu Catalog Token de Sales Layer durante el paso de configuración del paquete.
4. Reinicia el cliente si es necesario.
5. Prueba la conexión con un prompt sencillo.

Completar el flujo de autorización de Sales Layer

Para conexiones MCP remotas, el cliente debería abrir la pantalla de autorización de Sales Layer en tu navegador.

1. Espera a que se abra la pantalla de autorización de Sales Layer.
2. Selecciona el perfil de acceso si la pantalla te pide elegir uno.
3. Introduce tu Catalog Token de Sales Layer.
4. Valida el token y continúa.
5. Vuelve a tu cliente MCP cuando el flujo de autorización haya finalizado.

Probar la conexión

Después de conectar el servidor MCP, prueba la conexión antes de utilizarlo para trabajos reales con el catálogo.

Empieza con:

¿Qué herramientas de Sales Layer están disponibles?

Después prueba con un prompt relacionado con el catálogo:

Muéstrame un resumen de mi catálogo de Sales Layer.

Si la conexión funciona, el cliente debería poder llamar a las herramientas MCP de Sales Layer y devolver información de tu catálogo.

Ejemplos de prompts

Cuando la conexión esté lista, puedes pedir:

• Muéstrame las herramientas de Sales Layer disponibles.
• Busca productos con descripciones incompletas.
• Resume la estructura del catálogo.
• Revisa la calidad de los datos de producto para una categoría concreta.
• Encuentra ítems con atributos técnicos incompletos.

Si utilizas acceso de solo lectura, el cliente puede consultar y analizar datos de Sales Layer, pero no puede crear ni actualizar registros.

Cuándo utilizar la API REST en su lugar

Utiliza directamente la API REST de Sales Layer cuando tu flujo de trabajo no necesite herramientas MCP o cuando el cliente no pueda completar el flujo OAuth requerido para MCP remoto.

Para llamadas directas a la API REST, utiliza la cabecera X-API-KEY con tu Catalog Token de Sales Layer:

X-API-KEY: your_catalog_token

Por ejemplo, las consultas de catálogo con API 2.0 REST utilizan URLs como:

https://api2.saleslayer.com/rest/Catalog/Products

Esto no es una conexión MCP. Es útil para automatizaciones fijas y previsibles en las que el flujo de trabajo ya sabe a qué endpoint debe llamar.

Solución de problemas

Qué enviar al equipo de soporte de Sales Layer

Si el problema continúa, contacta con el equipo de soporte de Sales Layer e incluye:

• El nombre y la versión del cliente MCP.
• El tipo de conexión que estás utilizando: MCP remoto, puente local, paquete local o API REST.
• La URL del servidor que has configurado.
• El método de autenticación seleccionado en el cliente.
• El mensaje de error exacto mostrado por el cliente.
• Una captura de pantalla del error, con los valores sensibles del token ocultos.
• Si se abrió la pantalla de autorización de Sales Layer.
• Si seleccionaste solo lectura o acceso completo.

Nunca envíes tu Catalog Token completo en una captura de pantalla, ticket, email o conversación de chat.

Buenas prácticas

Utiliza un artículo específico de Sales Layer para tu cliente cuando exista. La configuración MCP genérica solo debe utilizarse cuando el cliente no tenga una guía dedicada.

Empieza con acceso de solo lectura cuando el cliente solo necesite consultar o analizar datos del catálogo. Utiliza acceso completo solo para flujos de trabajo controlados en los que se espere modificar datos.

Utiliza el descubrimiento dinámico cuando el cliente lo admita. Si es necesaria una configuración OAuth manual, revisa cuidadosamente cada endpoint y confirma que PKCE con S256 es compatible.

Mantén tu Catalog Token seguro. No lo pegues en archivos de configuración, capturas de pantalla, tickets de soporte, plantillas públicas ni repositorios compartidos.

Si tu cliente no admite autenticación MCP remota, no fuerces la configuración enviando el Catalog Token como bearer token. Utiliza un cliente compatible, un puente local aprobado por tu organización o directamente la API REST de Sales Layer.