Solución de problemas de conexiones al servidor MCP de Sales Layer

Modificado el Mar, 2 Jun a 1:29 P. M.

Este artículo te ayuda a identificar y resolver problemas habituales al conectar un cliente de IA o una herramienta de automatización al servidor MCP de Sales Layer.

La mayoría de los problemas de conexión están relacionados con una de estas cuatro áreas: una URL de servidor incorrecta, un método de autenticación incorrecto, un flujo OAuth incompleto o un cliente que no admite la configuración requerida de OAuth 2.0 con PKCE.

Advertencia: No pegues tu Catalog Token de Sales Layer como clave API ni como bearer token en un cliente MCP remoto. Para conexiones MCP remotas, el Catalog Token se introduce en la pantalla de autorización de Sales Layer durante el flujo OAuth.

Antes de empezar a solucionar problemas

Antes de cambiar la configuración, revisa estos puntos básicos:

Estás usando un cliente que admite servidores MCP remotos.
Tu cliente admite OAuth 2.0 con PKCE.
Tienes un Catalog Token de Sales Layer válido, proporcionado por el equipo de soporte de Sales Layer o por tu representante de cuenta de Sales Layer.
Estás usando la URL correcta del servidor MCP de Sales Layer para tu configuración.
Las ventanas emergentes del navegador están permitidas para el cliente de IA o la plataforma de automatización que estás usando.

Si no tienes claro si tu Catalog Token es válido, contacta con el equipo de soporte de Sales Layer antes de cambiar el resto de la configuración.

Comprueba la URL del servidor

Una URL de servidor incorrecta puede impedir que el cliente descubra las herramientas MCP o que inicie el flujo OAuth.

Usa la URL que corresponda a tu cliente y modo de acceso:

Caso de uso	URL
Conexión MCP remota general	https://mcp.saleslayer.com/mcp
Conector personalizado de Claude Web	https://mcp.saleslayer.com
Acceso explícito de solo lectura	https://mcp.saleslayer.com/onlyread/mcp
Acceso completo explícito	https://mcp.saleslayer.com/full/mcp

Nota: Si un cliente tiene una guía de configuración específica, sigue la URL que se muestra en esa guía. Algunos clientes esperan la URL base del servidor, mientras que otros esperan la URL del endpoint MCP.

Comprueba el método de autenticación

Las conexiones MCP remotas usan OAuth 2.0 con PKCE. No usan autenticación mediante clave API en la configuración del cliente.

Usa estas reglas al configurar la autenticación:

Selecciona OAuth 2.0 como método de autenticación.
Usa Detección dinámica cuando tu cliente lo admita.
Si se requiere configuración manual, usa Código de autorización con PKCE.
Usa S256 como método de code challenge.
Introduce el Catalog Token de Sales Layer solo en la pantalla de autorización de Sales Layer.

Endpoints OAuth de referencia

Usa estos valores solo cuando tu cliente no admita Detección dinámica y solicite una configuración manual de OAuth:

Campo	Valor
URL de autorización	https://mcp.saleslayer.com/oauth/authorize
URL de token	https://mcp.saleslayer.com/oauth/token
URL de descubrimiento	https://mcp.saleslayer.com/.well-known/oauth-authorization-server
Metadatos del recurso protegido	https://mcp.saleslayer.com/.well-known/oauth-protected-resource
Tipo de autorización	Código de autorización con PKCE
Método de code challenge	S256

Problemas habituales y cómo resolverlos

Problema	Causa probable	Qué hacer
invalid_token	El Catalog Token se ha pegado como clave API o bearer token en el cliente MCP.	Cambia el método de autenticación a OAuth 2.0 e introduce el Catalog Token solo en la pantalla de autorización de Sales Layer.
401 Unauthorized	El cliente no está enviando un token de acceso OAuth válido o el flujo OAuth no se ha completado.	Desconecta el servidor, vuelve a conectarlo y completa de nuevo el flujo OAuth.
La ventana de autorización no se abre	La ventana emergente del navegador está bloqueada o el cliente no puede iniciar el flujo OAuth.	Permite ventanas emergentes para el dominio del cliente e intenta conectar el servidor de nuevo.
El campo Catalog Token no está claro	El Catalog Token se está confundiendo con el ID de cliente, el secreto de cliente, la clave API o el bearer token.	Usa el Catalog Token solo en la pantalla de autorización de Sales Layer. No es un valor para los campos de configuración del cliente.
Las opciones PKCE o S256 no están disponibles	Es posible que la versión del cliente no admita la configuración OAuth requerida por el servidor MCP de Sales Layer.	Comprueba si el cliente admite Código de autorización con PKCE y el método de code challenge S256.
No hay herramientas de Sales Layer disponibles	El servidor se ha añadido, pero la conexión o la autorización no se han completado correctamente.	Desconecta y vuelve a conectar el servidor. Después, verifica que el flujo de autorización finaliza y redirige de nuevo al cliente.
El cliente no puede descubrir el servidor	Se ha usado una URL MCP incorrecta o el cliente espera un formato de URL distinto.	Revisa el artículo de configuración de tu cliente y usa la URL exacta que se muestra allí.
Las operaciones de lectura funcionan, pero las actualizaciones fallan	La conexión se ha creado con acceso de solo lectura.	Usa acceso completo solo si el cliente necesita crear o actualizar datos y el usuario comprende el impacto.
La validación del token falla en la pantalla de Sales Layer	El Catalog Token puede ser incorrecto, haber caducado, estar mal escrito o no ser válido para el catálogo esperado.	Copia el token de nuevo e inténtalo otra vez. Si sigue fallando, contacta con el equipo de soporte de Sales Layer.
La conexión funciona en un cliente, pero no en otro	Cada cliente admite funciones MCP y OAuth diferentes.	Consulta el artículo de configuración específico para ese cliente y comprueba su compatibilidad con MCP/OAuth.

Problema: invalid_token

Este error suele aparecer cuando el Catalog Token se usa de forma incorrecta. El Catalog Token no es un bearer token directo para https://mcp.saleslayer.com.

Para resolverlo:

Abre la configuración del servidor MCP en tu cliente.
Elimina cualquier ajuste de autenticación mediante clave API o bearer token.
Selecciona OAuth 2.0 como método de autenticación.
Usa Detección dinámica si está disponible.
Vuelve a conectar el servidor.
Cuando se abra la pantalla de autorización de Sales Layer, introduce allí el Catalog Token.

Problema: Copilot Studio no puede completar la conexión

En Microsoft Copilot Studio, comprueba que la configuración use OAuth 2.0 y no autenticación mediante clave API.

Si configuras OAuth manualmente, asegúrate de que estos valores sean correctos:

URL de autorización: https://mcp.saleslayer.com/oauth/authorize
URL de token: https://mcp.saleslayer.com/oauth/token
ID de cliente: un identificador estable, por ejemplo copilot-studio
Secreto de cliente: déjalo vacío
Alcance: déjalo vacío
Tipo de autorización: Código de autorización con PKCE
Método de code challenge: S256

Si Copilot Studio no ofrece PKCE o S256, es posible que esa versión no sea compatible con el servidor MCP de Sales Layer en este momento.

Problema: Claude Web no se conecta

En Claude Web, comprueba que hayas añadido Sales Layer como conector personalizado y que hayas usado la URL correcta:

https://mcp.saleslayer.com

Después de añadir el conector, haz clic en Conectar. Claude debería redirigirte a la pantalla de autorización de Sales Layer, donde puedes seleccionar el tipo de acceso e introducir el Catalog Token.

Si la conexión no se completa, intenta eliminar el conector personalizado y añadirlo de nuevo. Comprueba también que las ventanas emergentes y las redirecciones del navegador estén permitidas.

Problema: n8n u otra plataforma de automatización devuelve 401

Algunas plataformas de automatización pueden tratar el servidor MCP como una API REST normal e intentar enviar el Catalog Token como bearer token. Esto no funcionará para una conexión MCP remota.

Para MCP remoto, la plataforma debe admitir MCP con OAuth 2.0. Si tu plataforma de automatización no lo admite, usa una de estas opciones:

Usa un cliente MCP compatible con OAuth 2.0.
Usa una configuración MCP local si está disponible para tu entorno.
Usa directamente la API REST de Sales Layer con la cabecera X-API-KEY si solo necesitas automatización directa mediante API y no necesitas herramientas MCP.

Nota: La API REST de Sales Layer y el servidor MCP de Sales Layer son opciones de integración diferentes. Las llamadas a la API REST usan la cabecera X-API-KEY. Las conexiones MCP remotas usan OAuth 2.0.

Problema: se ha seleccionado el modo de acceso incorrecto

El servidor MCP de Sales Layer se puede usar con diferentes perfiles de acceso. Si seleccionas acceso de solo lectura, el cliente de IA puede consultar y analizar datos del catálogo, pero no puede crear ni actualizar información.

Si una herramienta falla porque está intentando modificar datos, comprueba qué modo de acceso se ha usado durante el flujo de autorización.

Solo lectura: recomendado para análisis, búsquedas, informes y exploración segura del catálogo.
Acceso completo: úsalo solo cuando el cliente de IA necesite crear o actualizar datos del catálogo.

Si necesitas cambiar el modo de acceso, desconecta el servidor MCP y vuelve a conectarlo usando el perfil correcto.

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 todo el contexto posible. Esto ayuda al equipo a identificar si el problema se debe a la configuración del cliente, al flujo OAuth o a la validación del token.

Incluye la siguiente información:

El cliente de IA o la plataforma que intentas conectar, por ejemplo Claude Web, Microsoft Copilot Studio, ChatGPT, Cursor, VS Code o n8n.
La URL del servidor que has usado.
El método de autenticación seleccionado en el cliente.
El mensaje de error exacto que muestra el cliente.
Una captura de pantalla del error, con los valores sensibles del token ocultos.
Si la pantalla de autorización se abrió y si la redirección de vuelta al cliente se completó.
Si seleccionaste solo lectura o acceso completo.

No envíes nunca tu Catalog Token completo en una captura de pantalla, ticket o correo electrónico. Si el equipo de soporte necesita validar tu acceso, te indicará el proceso correcto.

Buenas prácticas

Usa Detección dinámica siempre que tu cliente MCP la admita. Esto reduce el riesgo de introducir endpoints OAuth incorrectos.

Mantén seguro tu Catalog Token e introdúcelo solo en la pantalla de autorización de Sales Layer. No lo pegues en campos de ID de cliente, secreto de cliente, clave API o bearer token.

Empieza con acceso de solo lectura cuando el objetivo sea buscar, analizar o auditar datos del catálogo. Usa acceso completo solo para flujos de trabajo de confianza que necesiten modificar datos.

Si una plataforma no admite MCP con OAuth 2.0 y PKCE, usa directamente la API REST de Sales Layer para automatizaciones sin interfaz en lugar de forzar una configuración MCP remota.