Conectando el servidor MCP con clientes IA

Modificado el Mar, 26 May a 9:58 A. M.

Qué es el servidor MCP


El servidor MCP de Sales Layer es un puente seguro entre los datos de producto de Sales Layer y las herramientas de IA o automatización compatibles con el Model Context Protocol.


Permite que herramientas compatibles, como asistentes de IA, IDEs y plataformas de automatización de workflows, consulten, analicen e interactúen con tu catálogo de productos mediante una conexión estandarizada. Esto ayuda a los equipos a crear asistentes de producto con IA, automatizar procesos de enriquecimiento, validar datos y crear herramientas de búsqueda inteligente sin desarrollar una integración personalizada desde cero.



Antes de empezar


Antes de conectar un cliente de IA al servidor MCP de Sales Layer, necesitas tu Catalog Token de Sales Layer.


  1. Inicia sesión en tu cuenta de Sales Layer.
  2. Accede al área de administración.
  3. Abre la sección API/Tokens.
  4. Copia tu Catalog Token.


Importante: No uses el Catalog Token como token directo de Authorization: Bearer contra https://mcp.saleslayer.com. Para clientes MCP remotos, la autenticación debe completarse mediante OAuth 2.0. Para automatizaciones directas sin interfaz que no necesiten herramientas MCP, usa la API REST de Sales Layer con la cabecera X-API-KEY.


URLs del servidor


La URL principal del servidor MCP de Sales Layer es:


https://mcp.saleslayer.com


Usa uno de los siguientes perfiles de acceso según el tipo de conexión que necesites:


Perfil
URL
Uso
Automático
https://mcp.saleslayer.com/mcp
El servidor determina el perfil de acceso según el token.
Solo lectura
https://mcp.saleslayer.com/onlyread/mcp
Solo permite operaciones de consulta.
Completo
https://mcp.saleslayer.com/full/mcp
Permite operaciones de lectura y escritura.


Autenticación


El servidor MCP de Sales Layer utiliza OAuth 2.0 con PKCE. En clientes remotos, el Catalog Token se introduce en la ventana de autorización de Sales Layer. Después de validar el token, el servidor MCP emite un token de acceso OAuth para el cliente.


Muchos clientes pueden detectar la configuración OAuth automáticamente mediante Dynamic Discovery o Dynamic Client Registration. Si tu cliente no admite descubrimiento automático, usa la configuración manual de OAuth indicada a continuación.


Campo
Valor
Authorization URL
https://mcp.saleslayer.com/oauth/authorize
Token URL
https://mcp.saleslayer.com/oauth/token
Registration URL
https://mcp.saleslayer.com/oauth/register
Discovery URL
https://mcp.saleslayer.com/.well-known/oauth-authorization-server
Grant Type
authorization_code
PKCE
Obligatorio, método S256


Para obtener una clave API, ponte en contacto con el equipo de soporte o con tu representante de cuenta en support@saleslayer.com


Microsoft Copilot Studio


Si tu versión de Microsoft Copilot Studio admite Dynamic Discovery, úsalo como método de configuración recomendado.


  1. En Copilot Studio, ve a Tools > Add tool > Model Context Protocol.
  2. Configura el nombre del servidor como Sales Layer MCP.
  3. Configura la descripción como MCP Server for PIM Sales Layer.
  4. Usa esta URL de servidor: https://mcp.saleslayer.com/mcp.
  5. En Authentication, selecciona OAuth 2.0.
  6. Si está disponible, selecciona Dynamic Discovery.
  7. Haz clic en Create.
  8. Cuando se abra la ventana del navegador, introduce tu Catalog Token de Sales Layer en la pantalla de autorización.


Si Dynamic Discovery no está disponible, configura OAuth manualmente usando los valores de la sección Autenticación de este artículo. El Client ID debe ser un identificador estable para el cliente, por ejemplo copilot-studio. No es el Catalog Token.


Claude Web


  1. En una conversación de Claude, haz clic en el icono de herramientas o conectores.
  2. Selecciona Add MCP Server o la opción equivalente en tu versión.
  3. Introduce esta URL: https://mcp.saleslayer.com/mcp.
  4. Claude debería detectar automáticamente la configuración OAuth mediante Dynamic Client Registration.
  5. Cuando se abra la ventana de autorización, introduce tu Catalog Token de Sales Layer.
  6. Una vez conectado, podrás hacer preguntas a Claude sobre tu catálogo de productos en Sales Layer.


Claude Desktop


Claude Desktop ejecuta el servidor MCP localmente, por lo que esta configuración no requiere OAuth.


  1. Abre el archivo de configuración de Claude Desktop.
  2. En Windows, el archivo se encuentra en %APPDATA%\Claude\claude_desktop_config.json.
  3. En macOS, el archivo se encuentra en ~/Library/Application Support/Claude/claude_desktop_config.json.
  4. Añade la siguiente configuración.


{
  "mcpServers": {
    "sales-layer": {
      "command": "npx",
      "args": ["--yes", "@saleslayer/mcp-server@latest"],
      "env": {
        "CATALOG_TOKEN": "tu_token_aqui"
      }
    }
  }
}


  1. Sustituye tu_token_aqui por tu Catalog Token real de Sales Layer.
  2. Reinicia Claude Desktop.
  3. Para verificar la conexión, pregunta a Claude: ¿Qué herramientas de Sales Layer tienes disponibles?


ChatGPT


El soporte MCP en ChatGPT puede variar según la versión y el plan.


  1. Abre la configuración de ChatGPT.
  2. Busca la opción para añadir MCP Servers o External Tools.
  3. Añade un nuevo servidor con esta URL: https://mcp.saleslayer.com/mcp.
  4. Selecciona OAuth 2.0 como método de autenticación.
  5. Si es compatible, ChatGPT debería detectar la configuración automáticamente mediante Dynamic Client Registration.
  6. Cuando se abra la ventana de autorización, introduce tu Catalog Token de Sales Layer.


Cursor IDE


Cursor admite MCP con autenticación OAuth automática.


  1. Abre Settings > Tools & MCP.
  2. Haz clic en Add new MCP server.
  3. Selecciona Streamable HTTP.
  4. Introduce esta URL: https://mcp.saleslayer.com/mcp.
  5. Haz clic en Connect.
  6. Cuando Cursor abra el navegador, completa el flujo OAuth introduciendo tu Catalog Token de Sales Layer.


También puedes configurar Cursor desde el archivo .cursor/mcp.json de tu proyecto:


{
  "mcpServers": {
    "sales-layer": {
      "url": "https://mcp.saleslayer.com/mcp"
    }
  }
}


Al activar el servidor, Cursor inicia el flujo OAuth automáticamente.


VS Code con GitHub Copilot


VS Code admite MCP mediante GitHub Copilot en versiones compatibles.


  1. Abre la Command Palette con Cmd+Shift+P en macOS o Ctrl+Shift+P en Windows.
  2. Ejecuta MCP: Add Server....
  3. Selecciona HTTP.
  4. Introduce esta URL: https://mcp.saleslayer.com/mcp.
  5. Asigna un nombre al servidor, por ejemplo sales-layer.
  6. Elige si quieres guardar la configuración en User Settings o en el Workspace actual.


También puedes crear o editar el archivo .vscode/mcp.json en tu proyecto:


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


Para usar la conexión, abre Copilot Chat y activa Agent mode. VS Code debería detectar el servidor y completar automáticamente el flujo OAuth. Introduce tu Catalog Token de Sales Layer cuando aparezca el formulario de autorización.


Windsurf IDE


Windsurf admite MCP mediante su agente Cascade.


  1. Abre Windsurf Settings.
  2. Ve a Cascade > MCP Servers.
  3. Haz clic en Add Custom Server +.
  4. Añade la siguiente configuración.


{
  "mcpServers": {
    "sales-layer": {
      "serverUrl": "https://mcp.saleslayer.com/mcp"
    }
  }
}


También puedes editar directamente el archivo de configuración MCP de Windsurf:


  • macOS: ~/.codeium/windsurf/mcp_config.json
  • Windows: %APPDATA%\Codeium\windsurf\mcp_config.json


Si Windsurf no admite OAuth nativo para servidores remotos, puedes usar el proxy mcp-remote:


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


Esto abrirá el navegador para autenticarte y gestionará los tokens automáticamente.


n8n


Para workflows de n8n, la opción recomendada es usar MCP Client Tool o MCP Client con OAuth 2.0.


  1. En tu workflow, usa MCP Client Tool si quieres exponer herramientas a un AI Agent.
  2. Usa MCP Client si quieres ejecutar una herramienta MCP como un paso normal del workflow.
  3. Usa esta URL: https://mcp.saleslayer.com/mcp.
  4. En algunas versiones de n8n, este campo puede aparecer como SSE Endpoint o MCP Endpoint URL.
  5. En Authentication, selecciona OAuth2.
  6. Si tu versión admite Discovery o Dynamic Client Registration, actívalo.
  7. Si n8n solicita una Registration URL, usa https://mcp.saleslayer.com/oauth/register.
  8. Cuando se abra la ventana del navegador, introduce tu Catalog Token de Sales Layer.


Si tu versión de n8n no admite correctamente OAuth2 con MCP, usa la API REST de Sales Layer directamente en lugar del servidor MCP.


Campo
Valor
Method
GET
URL
https://api2.saleslayer.com/rest/Catalog/Products
Header
X-API-KEY: tu_catalog_token
Query Parameters
$select=prod_id,prod_ref,prod_title&$top=50


Esta opción de API REST directa no usa el protocolo MCP, por lo que las herramientas MCP no estarán disponibles para un AI Agent. Es útil para workflows de automatización que solo necesitan acceso directo a la API.


Importante: Esta configuración no ofrece una integración MCP completamente headless desde el primer momento. Si necesitas una integración headless, usa directamente la API REST de Sales Layer.


Google Gemini y otros clientes MCP


Antes de configurar Google Gemini, confirma que tu versión admite MCP. Si admite MCP con OAuth, añade el servidor MCP de Sales Layer con esta URL:


https://mcp.saleslayer.com/mcp


Usa OAuth 2.0 con Dynamic Discovery cuando esté disponible y autentícate con tu Catalog Token de Sales Layer.


Para cualquier otro cliente compatible con MCP, usa la misma URL MCP y la configuración OAuth 2.0. Si el cliente admite Dynamic Client Registration, deja que detecte la configuración automáticamente. Si no, usa los valores manuales de OAuth indicados en la sección Autenticación de este artículo.


Solución de problemas


Error
Causa
Solución
invalid_token
Se está usando el Catalog Token como Bearer token directo, o el token de acceso OAuth ya no es válido.
Configura el cliente con OAuth 2.0 y vuelve a autenticarte. Para integraciones directas headless, usa la API REST con X-API-KEY.
401 Unauthorized en n8n
Se está tratando el servidor MCP como una API REST compatible con Bearer token.
Usa MCP Client Tool o MCP Client con OAuth 2.0, o llama directamente a la API REST de Sales Layer.
PKCE required o S256 required
El cliente no está enviando PKCE correctamente.
Asegúrate de que el cliente usa code_challenge_method: S256.
Connector request failed
La configuración OAuth es incorrecta.
Usa Dynamic Discovery en lugar de configuración manual siempre que sea posible.
La autenticación no se completa
Hay una ventana emergente bloqueada o un problema de redirección.
Permite ventanas emergentes para el dominio del cliente de IA y vuelve a intentarlo.
No tools available
La autenticación no se completó correctamente.
Desconecta y vuelve a conectar el servidor MCP, asegurándote de completar el flujo OAuth.


Buenas prácticas


Usa Dynamic Discovery o Dynamic Client Registration siempre que tu cliente lo permita, ya que reduce el riesgo de errores de configuración. 

Mantén tu Catalog Token protegido e introdúcelo únicamente en la pantalla de autorización de Sales Layer. 

No lo pegues como API key ni como Bearer token en clientes MCP remotos. 

Para workflows de automatización que no necesiten herramientas MCP ni un AI Agent, considera usar directamente la API REST de Sales Layer con la cabecera X-API-KEY.

¿Le ha sido útil este artículo?

¡Qué bien!

Gracias por sus comentarios

¡Sentimos mucho no haber sido de ayuda!

Gracias por sus comentarios

¡Háganos saber cómo podemos mejorar este artículo!

Seleccione al menos una de las razones
Se requiere la verificación del CAPTCHA.

Sus comentarios se han enviado

Agradecemos su esfuerzo e intentaremos corregir el artículo