Usar el servidor MCP de Sales Layer con n8n

Modificado el Mar, 2 Jun a 12:47 P. M.

n8n se puede utilizar para crear flujos de trabajo de automatización con agentes de IA y herramientas externas. Cuando tu entorno de n8n es compatible con clientes MCP con OAuth 2.0, puedes conectarlo al servidor MCP de Sales Layer y permitir que un AI Agent utilice herramientas de Sales Layer dentro de un flujo de trabajo.

Este artículo explica cuándo utilizar el servidor MCP de Sales Layer en n8n, cómo configurar la conexión y cuándo es mejor utilizar directamente la API REST de Sales Layer.

Nota: No utilices el Catalog Token de Sales Layer como token bearer directo contra https://mcp.saleslayer.com. Las conexiones MCP remotas utilizan OAuth 2.0. Si tu configuración de n8n no puede completar un flujo OAuth para MCP, utiliza directamente la API REST de Sales Layer.

Cuándo utilizar MCP en n8n

Utiliza el servidor MCP de Sales Layer en n8n cuando tu flujo de trabajo incluya un AI Agent que necesite decidir qué herramienta de Sales Layer debe llamar según la solicitud del usuario o el contexto del flujo de trabajo.

Algunos casos de uso habituales de MCP en n8n son:

Permitir que un AI Agent busque o inspeccione datos del catálogo de Sales Layer.
Crear controles de calidad del catálogo en los que el agente decide qué revisar.
Crear flujos de trabajo en los que las herramientas de Sales Layer son un paso dentro de un proceso de IA más amplio.
Combinar información del catálogo con otros sistemas ya conectados a n8n.

Si tu flujo de trabajo solo necesita llamar a un endpoint fijo de Sales Layer, como recuperar productos o actualizar un campo concreto, la API REST de Sales Layer suele ser más sencilla y predecible.

¿Servidor MCP o API REST?

Antes de configurar n8n, decide si tu flujo de trabajo necesita herramientas MCP o llamadas directas a la API REST.

Caso de uso	Opción recomendada	Motivo
Un AI Agent necesita elegir entre herramientas de Sales Layer	Servidor MCP de Sales Layer	MCP expone herramientas que el agente puede llamar según la tarea.
Un flujo de trabajo necesita llamar a un endpoint fijo	API REST de Sales Layer	Las llamadas a la API REST son más sencillas para automatizaciones deterministas.
El flujo de trabajo debe ejecutarse completamente sin interfaz y sin autorización de usuario	API REST de Sales Layer	La autenticación MCP remota utiliza OAuth y puede requerir un flujo de autorización interactivo.
n8n no admite OAuth para MCP en tu versión	API REST de Sales Layer	El Catalog Token no se puede utilizar como token bearer directo para MCP remoto.

Antes de empezar

Antes de conectar n8n al servidor MCP de Sales Layer, asegúrate de tener:

Acceso a un entorno de n8n donde estén disponibles nodos de cliente MCP o nodos MCP Client Tool.
Un flujo de trabajo de n8n con un AI Agent si quieres que el agente utilice herramientas de Sales Layer.
Una cuenta de Sales Layer con acceso al catálogo que quieres utilizar.
Tu Catalog Token de Sales Layer.
Una versión de n8n que pueda completar la autenticación OAuth 2.0 para conexiones MCP.

Actualmente, el Catalog Token no se obtiene desde una sección 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.

Nota: En n8n, no configures el servidor MCP como un nodo HTTP Request normal con Authorization: Bearer your_catalog_token. Ese no es el flujo de autenticación MCP remota.

Elegir el modo de acceso

Utiliza el modo de acceso que coincida con lo que tu flujo de trabajo de n8n necesita hacer con Sales Layer.

Modo	URL del servidor	Cuándo utilizarlo
Conexión remota por defecto	https://mcp.saleslayer.com/mcp	Cuando quieres utilizar el endpoint MCP estándar de Sales Layer.
Solo lectura	https://mcp.saleslayer.com/onlyread/mcp	Cuando el flujo de trabajo solo necesita consultar, inspeccionar o analizar datos del catálogo.
Acceso completo	https://mcp.saleslayer.com/full/mcp	Cuando el flujo de trabajo necesita crear o actualizar datos de Sales Layer mediante herramientas MCP.

Para la mayoría de flujos de trabajo de IA en n8n, empieza con Solo lectura. Utiliza Acceso completo únicamente para flujos de trabajo de confianza en los que se espera que el agente modifique datos del catálogo.

Opción 1: utilizar MCP Client Tool con un AI Agent

Utiliza esta opción cuando tu flujo de trabajo de n8n tenga un AI Agent y quieras que el agente llame a herramientas de Sales Layer.

Abre tu flujo de trabajo de n8n.
Añade o abre el nodo AI Agent.
Añade una herramienta MCP Client Tool en la sección de herramientas del agente.
En MCP Client Tool, configura la URL del servidor o endpoint con la URL del servidor MCP de Sales Layer.
Selecciona OAuth 2.0 como método de autenticación si n8n solicita autenticación.
Utiliza Dynamic discovery si tu versión de n8n lo permite.
Guarda las credenciales e inicia el flujo de autorización.
Cuando se abra la pantalla de autorización de Sales Layer, introduce tu Catalog Token de Sales Layer.

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

https://mcp.saleslayer.com/mcp

Opción 2: utilizar un MCP Client como paso del flujo de trabajo

Utiliza esta opción cuando quieras que el flujo de trabajo llame a una herramienta MCP específica como parte de una secuencia de automatización definida, en lugar de permitir que un AI Agent decida cuándo llamarla.

Abre tu flujo de trabajo de n8n.
Añade un nodo MCP Client si está disponible en tu versión de n8n.
Configura la URL del servidor o endpoint con la URL del servidor MCP de Sales Layer.
Configura la autenticación OAuth 2.0.
Completa el flujo de autorización de Sales Layer con tu Catalog Token.
Selecciona la herramienta MCP de Sales Layer que debe ejecutar el flujo de trabajo.
Mapea los valores de entrada desde los nodos anteriores del flujo de trabajo.
Ejecuta una prueba.

Valores de referencia para OAuth manual

Si n8n solicita valores manuales de OAuth 2.0 y no admite Dynamic discovery, utiliza estos endpoints de referencia:

Campo	Valor
URL de autorización	https://mcp.saleslayer.com/oauth/authorize
URL del token	https://mcp.saleslayer.com/oauth/token
URL de descubrimiento	https://mcp.saleslayer.com/.well-known/oauth-authorization-server
Tipo de concesión	Authorization Code with PKCE
Método de code challenge	S256

Nota: Si tu versión de n8n no admite Authorization Code with PKCE y S256 para esta conexión, puede que no sea compatible con el servidor MCP remoto de Sales Layer.

Completar el flujo de autorización de Sales Layer

Cuando n8n inicie el flujo OAuth, debería abrirse una pantalla de autorización de Sales Layer 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 n8n cuando se complete el flujo de autorización.
Guarda las credenciales o la configuración del nodo.

Probar la conexión MCP

Después de configurar la conexión MCP, ejecuta una prueba sencilla antes de utilizarla en un flujo de trabajo de producción.

Para un flujo de trabajo con AI Agent, utiliza un prompt como:

¿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 AI Agent debería poder llamar a las herramientas MCP de Sales Layer y devolver información de tu catálogo.

Alternativa: utilizar directamente la API REST de Sales Layer

Si tu flujo de trabajo de n8n no necesita herramientas MCP, o si tu versión de n8n no puede completar el flujo OAuth para MCP remoto, utiliza directamente la API REST de Sales Layer.

Solución de problemas

Problema	Causa probable	Qué hacer
MCP Client Tool no está disponible	Es posible que tu versión de n8n no incluya nodos de cliente MCP o que la funcionalidad no esté activada.	Comprueba tu versión de n8n y los nodos de IA disponibles. Utiliza la opción de API REST si MCP no está disponible.
invalid_token	El Catalog Token se ha utilizado como token bearer directo contra el servidor MCP.	Utiliza OAuth 2.0 para MCP remoto. Introduce el Catalog Token solo en la pantalla de autorización de Sales Layer.
401 Unauthorized	n8n no está enviando un token de acceso OAuth válido, o el flujo OAuth no se ha completado.	Vuelve a conectar las credenciales MCP y completa de nuevo el flujo de autorización de Sales Layer.
La ventana de autorización no se abre	Es posible que las ventanas emergentes estén bloqueadas, o que el entorno de n8n no admita el flujo OAuth requerido.	Permite ventanas emergentes y redirecciones. Si el flujo sigue fallando, utiliza la opción de API REST.
PKCE o S256 no está disponible	Es posible que la configuración OAuth de tu versión de n8n no admita el método de seguridad requerido.	Utiliza un cliente MCP compatible o utiliza directamente la API REST de Sales Layer.
El AI Agent no llama a herramientas de Sales Layer	Puede que MCP Client Tool no esté conectado al agente, o que el prompt no requiera datos de Sales Layer.	Comprueba la sección de herramientas del agente y prueba con un prompt directo como: ¿Qué herramientas de Sales Layer están disponibles?
Las operaciones de lectura funcionan, pero las actualizaciones fallan	La conexión está utilizando acceso de solo lectura.	Utiliza acceso completo solo si el flujo de trabajo debe actualizar datos de Sales Layer y tu organización lo permite.

Buenas prácticas

Utiliza MCP cuando un AI Agent necesite razonar sobre las herramientas disponibles de Sales Layer. Utiliza la API REST cuando el flujo de trabajo deba ejecutar una llamada API fija y predecible.

Empieza con acceso de solo lectura cuando el flujo de trabajo solo necesite consultar o analizar datos. Utiliza acceso completo únicamente para flujos de trabajo controlados que estén pensados para modificar información del catálogo.

Mantén seguro tu Catalog Token. No lo pegues en capturas de pantalla, exportaciones compartidas de flujos de trabajo, plantillas públicas ni tickets de soporte.

Prueba manualmente los flujos de trabajo MCP antes de activar ejecuciones programadas o de producción. En los flujos de trabajo que puedan modificar datos, incluye pasos de aprobación o revisión antes de que se ejecuten acciones de escritura.