URLs y modos de acceso del servidor MCP de Sales Layer

Modificado el Mar, 2 Jun a 10:55 A. M.

El servidor MCP de Sales Layer puede utilizarse a través de un servidor remoto alojado o mediante un paquete de instalación local, según el cliente de IA y el nivel de control que necesites.

Este artículo explica qué URL del servidor MCP de Sales Layer debes utilizar, qué significa cada modo de acceso y qué endpoints OAuth pueden ser necesarios cuando un cliente de IA solicita los detalles de autenticación de forma manual.

URL del servidor alojado

El servidor MCP alojado de Sales Layer está disponible en:

https://mcp.saleslayer.com

Algunos clientes de IA solo solicitan la URL base del servidor. Otros clientes solicitan el endpoint MCP exacto. Cuando esté disponible, utiliza el artículo específico del cliente para la herramienta que estés configurando, como Claude, Microsoft Copilot Studio, ChatGPT, Cursor, VS Code u otro cliente compatible con MCP.

Endpoints MCP remotos

Sales Layer proporciona diferentes endpoints MCP remotos según el perfil de acceso necesario para la conexión.

Modo de acceso	URL	Uso
Servidor alojado base	https://mcp.saleslayer.com	Utilízalo cuando el cliente de IA solicite la URL del servidor remoto y gestione la ruta MCP automáticamente.
Solo lectura	https://mcp.saleslayer.com/onlyread/mcp	Permite que el cliente de IA consulte y analice datos del catálogo sin modificar datos en Sales Layer.
Acceso completo	https://mcp.saleslayer.com/full/mcp	Permite que el cliente de IA utilice herramientas de lectura y escritura. Úsalo solo cuando el cliente de IA deba crear o actualizar datos de Sales Layer.
Endpoint específico del cliente	https://mcp.saleslayer.com/mcp	Utilízalo solo cuando una guía específica de Sales Layer para ese cliente lo indique, por ejemplo en herramientas que esperan un único endpoint MCP durante la configuración.

Elegir el modo de acceso correcto

Para la mayoría de configuraciones iniciales, utiliza Solo lectura. Es la opción más segura porque el cliente de IA puede responder preguntas, ejecutar comprobaciones, analizar información de producto y ayudarte a entender tu catálogo sin cambiar datos en Sales Layer.

Utiliza Acceso completo solo cuando el cliente necesite realizar acciones que puedan modificar tus datos del PIM, como crear registros, actualizar descripciones de producto, enriquecer atributos o aplicar cambios masivos. Antes de utilizar Acceso completo, asegúrate de que los usuarios que interactuarán con el cliente de IA entienden que las herramientas de IA pueden afectar a datos reales de Sales Layer.

Necesidad	Modo recomendado
Hacer preguntas sobre datos del catálogo	Solo lectura
Ejecutar comprobaciones de calidad de datos o auditorías de completitud	Solo lectura
Generar informes o identificar información faltante	Solo lectura
Crear o actualizar registros en Sales Layer	Acceso completo
Automatizar flujos de enriquecimiento que escriben de nuevo en el PIM	Acceso completo

★

Consejo: Empieza con Solo lectura, salvo que tu caso de uso requiera claramente actualizar datos en Sales Layer. Puedes pasar a Acceso completo más adelante si tu flujo de trabajo necesita operaciones de escritura.

Endpoints de autenticación

Las conexiones MCP remotas utilizan OAuth 2.0. En muchos clientes, la configuración OAuth se detecta automáticamente. Si tu cliente solicita valores OAuth manuales, utiliza los endpoints siguientes.

Endpoint	URL
Autorización OAuth	https://mcp.saleslayer.com/oauth/authorize
Token OAuth	https://mcp.saleslayer.com/oauth/token
Registro OAuth	https://mcp.saleslayer.com/oauth/register
Descubrimiento OAuth	https://mcp.saleslayer.com/.well-known/oauth-authorization-server
Recurso protegido OAuth	https://mcp.saleslayer.com/.well-known/oauth-protected-resource

Si el cliente admite Descubrimiento dinámico o Registro dinámico de cliente, utiliza esas opciones cuando estén disponibles. Ayudan al cliente a detectar automáticamente la configuración OAuth y reducen los errores de configuración manual.

Valores de configuración OAuth

Si tu cliente requiere una configuración OAuth manual, utiliza estos valores, salvo que un artículo específico de Sales Layer para ese cliente indique algo diferente.

Campo	Valor
Autenticación	OAuth 2.0
Tipo de autorización	Authorization Code with PKCE
Método de code challenge	S256
Client ID	Un identificador de cliente estable, por ejemplo copilot-studio
Client Secret	Déjalo vacío, salvo que tu cliente de IA requiera específicamente otro valor
Scope	Déjalo vacío, salvo que tu cliente de IA requiera específicamente un valor de scope

¿Servidor remoto o instalación local?

El servidor remoto alojado es la opción más sencilla para la mayoría de usuarios. No requiere instalación local y se configura directamente desde el cliente de IA utilizando la URL del servidor MCP de Sales Layer.

Un paquete de instalación local es útil cuando tu organización necesita más control sobre el entorno, por ejemplo, para ejecutar el servidor MCP dentro de una red protegida. Los pasos de instalación local dependen del cliente de IA y del sistema operativo, por lo que debes utilizar el artículo específico de instalación local cuando esta opción sea necesaria.

Opción	Recomendado para
Servidor remoto alojado	Configuraciones rápidas en clientes de IA compatibles con MCP remoto y OAuth.
Instalación local	Entornos controlados, clientes de escritorio locales u organizaciones con requisitos específicos de infraestructura.

Errores habituales

Error	Qué hacer en su lugar
Utilizar el Token de catálogo como token Bearer directo en la URL del servidor MCP.	Utiliza OAuth 2.0 e introduce el Token de catálogo solo en la pantalla de autorización de Sales Layer.
Utilizar Acceso completo para pruebas o para explorar el catálogo.	Empieza con Solo lectura, salvo que el cliente de IA deba actualizar datos de Sales Layer.
Utilizar endpoints OAuth como URL del servidor MCP.	Utiliza los endpoints OAuth solo en la configuración de autenticación. Utiliza la URL del servidor MCP en el campo de URL del servidor.
Confundir el Client ID con el Token de catálogo de Sales Layer.	Utiliza un identificador de cliente estable como Client ID. El Token de catálogo se introduce más adelante durante la autorización de Sales Layer.

Buenas prácticas

Utiliza el artículo específico de Sales Layer para cada cliente siempre que esté disponible, porque algunos clientes de IA requieren un endpoint concreto o un flujo de configuración ligeramente diferente. Empieza con acceso de Solo lectura para pruebas y análisis del catálogo, y pasa a Acceso completo solo cuando las operaciones de escritura formen parte del flujo de trabajo previsto.

Mantén seguro tu Token de catálogo e introdúcelo solo en la pantalla de autorización de Sales Layer. Si tu cliente admite Descubrimiento dinámico de OAuth o Registro dinámico de cliente, utilízalo antes de introducir valores OAuth manuales.