Resumen
API PXM de Salsify para una organización: productos y sus valores de propiedad, activos digitales, definiciones de propiedades, membresía de listas, exportaciones, ejecuciones de importación y ejecuciones de canal. Clave API (bearer) e id de organización.
Configuración guiada
Conecta Salsify a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Salsify con la configuración guiada y añade tu URL MCP a Microsoft Copilot. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Salsify
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Salsify, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Salsify + Microsoft Copilot
API PXM de Salsify para una organización: productos y sus valores de propiedad, activos digitales, definiciones de propiedades, membresía de listas, exportaciones, ejecuciones de importación y ejecuciones de canal. Clave API (bearer) e id de organización.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
SALSIFY_ORG_ID, SALSIFY_API_TOKEN
Paso 1 — Obtener credenciales
La configuración tarda aproximadamente 3 minutos.
- Inicia sesión en Salsify (idealmente como un usuario de integración dedicado con solo los derechos que necesita) y abre tu perfil, Acceso API (https://app.salsify.com/app/profile/edit/api). Copia la clave API (genera una si está vacía) en
SALSIFY_API_TOKEN. Actúa con los permisos de ese usuario y permanece válida hasta que se regenere. - Copia el id de organización de la barra de direcciones: la parte después de
/orgs/, comenzando cons-(por ejemplos-1a2b3c4d-...). Pégalo enSALSIFY_ORG_ID.
El acceso API depende de tu licencia de Salsify; pregunta a tu contacto de Salsify si el perfil no muestra ninguna clave API. El token se envía como un token bearer.
Dónde empezar: salsify_list_products (con un filtro, o sin él para todos) y salsify_get_product para un producto. Los ids de propiedad son las claves que ves en los productos; salsify_get_property explica uno.
Productos: salsify_list_products, salsify_get_product, salsify_create_product, salsify_update_product. Los valores están indexados por id de propiedad (por ejemplo Brand, Product Name); una propiedad de múltiples valores toma una lista; null borra un valor. Los ids de propiedad desconocidos se crean como propiedades de texto, así que verifica la ortografía. salsify_upsert_products (por lotes) y salsify_delete_product están instalados desactivados.
Activos digitales: salsify_list_digital_assets, salsify_get_digital_asset, salsify_create_digital_asset (desde una URL pública; procesado en segundo plano), salsify_update_digital_asset. Vincula un activo a un producto configurando la propiedad de activo del producto al id del activo.
Propiedades y listas: salsify_get_property, salsify_add_list_members, salsify_remove_list_members. No hay una llamada documentada para listar cada propiedad: exporta con el atributo entity_type.
Exportaciones e importaciones: salsify_start_export luego salsify_get_export hasta completar; la url es un enlace temporal al archivo. salsify_get_import_run lee una ejecución de importación; salsify_start_import_run (ejecuta una importación configurada, posiblemente sobre muchos productos) está desactivado.
Canales: salsify_get_latest_channel_run y salsify_get_channel_run muestran el estado y el enlace de alimentación de un canal; salsify_start_channel_run está desactivado porque una ejecución puede publicar en un minorista. Las rutas de canal son utilizadas por las propias integraciones de Salsify pero solo están parcialmente descritas en la referencia pública.
Filtros: Lenguaje de filtros de Salsify: ='Brand':'Acme' (igual), ='Product Name':^'Mug' (comienza con), ='Price':>'10', =list:12345 (miembros de la lista); une condiciones con una coma para AND. Los nombres y valores de las propiedades están entre comillas simples.
Paginación y límites: pagina desde 1 y por página hasta 100; meta.total_entries da el total. La paginación se detiene en el resultado 10,000 (422): usa una exportación para conjuntos más grandes. La organización puede hacer 10,000 solicitudes por hora entre todos sus usuarios (429 arriba; encabezados x-ratelimit-remaining y x-ratelimit-reset). Los errores vienen como 422 con una lista de errores; 401 significa que la clave API es incorrecta; 400 con una lista de organizaciones significa que el id de organización falta o es incorrecto.
Paso 2 — Instalar el adaptador
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Agregar el conector en Microsoft Copilot
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Salsify. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
salsify_list_products | Lista productos, opcionalmente restringidos por un filtro de Salsify: cada valor de propiedad de cada producto como pares de id de propiedad y valor, además de sistema… |
salsify_get_product | Obtiene un producto por su id de producto: todos los valores de propiedad (pares de id de propiedad y valor, listas para propiedades de múltiples valores), campos del sistema… |
salsify_create_product | Crea un producto a partir de pares de id de propiedad y valor; la propiedad de id de producto es obligatoria. Un id de propiedad que aún no existe se crea como… |
salsify_update_product | Actualiza los valores de propiedad de un producto: solo cambian las propiedades enviadas; cada valor enviado reemplaza el almacenado, null lo elimina.… |
salsify_upsert_products | Crea o actualiza hasta 100 productos en una llamada a partir de una lista de objetos de valor de propiedad (cada uno con la propiedad de id de producto). Responde con el… |
salsify_delete_product | Elimina un producto de forma permanente, con sus valores de propiedad. No se puede deshacer. Instalado desactivado |
salsify_list_digital_assets | Lista activos digitales (imágenes, videos, documentos), opcionalmente restringidos por un filtro: salsify:id, salsify:name, salsify:url, salsify:format… |
salsify_get_digital_asset | Obtiene un activo digital: salsify:id, salsify:name, salsify:url (enlace de descarga), salsify:format, salsify:bytes, salsify:status (in_progress… |
salsify_create_digital_asset | Agrega un activo digital desde una URL pública; Salsify lo descarga en segundo plano (salsify:status in_progress, luego completado). Id opcional… |
salsify_update_digital_asset | Actualiza un activo digital: metadatos personalizados, salsify:name, o salsify:source_url para reemplazar el archivo (lo que crea un nuevo enlace). Solo el… |
salsify_get_property | Obtiene una definición de propiedad (atributo): salsify:id, salsify:name, salsify:data_type (string, rich_text, number, date, boolean, enumerated… |
salsify_add_list_members | Agrega productos (u otras entidades) a una lista existente de Salsify por sus ids. El id de la lista es el número en la URL de la lista en Salsify |
salsify_remove_list_members | Elimina productos (u otras entidades) de una lista de Salsify. Los productos en sí permanecen |
salsify_start_export | Inicia un archivo de exportación de productos, activos digitales, propiedades (atributo), valores enumerados (attribute_value) o todo (todo). Devuelve… |
salsify_get_export | Obtiene el estado de una ejecución de exportación: estado (en ejecución, completado, fallido), progreso, estimated_time_remaining, failure_reason y, una vez… |
salsify_start_import_run | Ejecuta una importación que ya está configurada en Salsify (por ejemplo, una importación JSON o CSV desde un punto de montaje). Puede cambiar muchos productos a… |
salsify_get_import_run | Obtiene el estado de una ejecución de importación: estado (en ejecución, completado, fallido, cancelado, detenido), progreso y errores. No sondees más de cada 15… |
salsify_get_latest_channel_run | Obtiene la última ejecución de un canal (un feed de productos o publicación a un minorista o sitio): id, estado (en ejecución, completado, fallido), marcas de tiempo… |
salsify_get_channel_run | Obtiene una ejecución de un canal: estado, marcas de tiempo y product_export_url una vez completado |
salsify_start_channel_run | Inicia una nueva ejecución de un canal, que regenera su feed y, para canales de publicación, lo envía al minorista o sitio. Instalado desactivado… |
Ejemplos de indicaciones
- "¿Qué productos de Salsify de la marca Northwind no tienen nombre de producto?"
- "Muestra el producto 00012345678905 con sus valores de propiedad."
- "Inicia una exportación de la lista Catálogo de Vacaciones y avísame cuando esté lista."
- "¿Cuándo terminó la última ejecución de canal de nuestro canal minorista, y con qué errores?"
- "Agrega los productos 00012345678905 y 00012345678912 a la lista Lanzamiento de Primavera."
Preguntas frecuentes
¿De dónde provienen el token y el id de organización? La clave API de tu perfil de Salsify, acceso API, idealmente de un usuario de integración dedicado; el id de organización es la parte de la dirección después de /orgs/, comenzando con s-. El acceso API depende de tu licencia de Salsify.
¿Qué cubre? Productos y sus valores de propiedad, activos digitales, definiciones de propiedades, membresía de listas, exportaciones, ejecuciones de importación y ejecuciones de canal.
¿Qué herramientas están instaladas desactivadas? salsify_upsert_products, salsify_delete_product, salsify_start_import_run y salsify_start_channel_run, porque una ejecución de canal puede publicar en un minorista. Actívalas en la página del conector solo si la IA debe usarlas.
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Próximos pasos
¿Te ha sido útil esta guía?