Listano Docs
Integración con IAListano Control MCP

Resumen de Listano Control MCP

Servidor MCP autenticado para la gestión de catálogos de empresa en Listano.

Listano Control MCP es el servidor autenticado de gestión del catálogo para Listano.

Permite a un sistema de IA gestionar las ofertas de la empresa autenticada: crear borradores, actualizar campos principales, añadir traducciones, gestionar atributos, verificar la preparación para publicación, publicar borradores y retirar ofertas activas.

Detalles del servidor

CampoValor
NombreListano Control
Versión1.0.0
Sitio webhttps://listano.eu
Endpointhttps://control.listano.eu/mcp
Modelo de accesoIntegración autenticada con ámbito de empresa

Listano Control MCP requiere sesiones autenticadas a través de una conexión segura. Los datos del catálogo solo pueden leerse o modificarse según los permisos otorgados a la integración autenticada, delimitados por empresa.

Conceptos principales

ConceptoSignificado
OfertaUn producto, servicio, derecho o elemento de acceso publicado en el catálogo de una empresa.
BorradorUna versión no publicada de una oferta. Un borrador no está activo.
Los borradores se eliminan automáticamente después de 30 días si no se publican.
Versión actualLa versión publicada activa visible para los compradores.
RevisiónUna versión numerada de una oferta. Las revisiones publicadas pueden quedar obsoletas cuando son reemplazadas.
Idioma principalEl idioma utilizado para el título, la descripción y la etiqueta de categoría principales de la oferta.
TraduccionesVersiones del contenido de la oferta en idiomas distintos al principal.
AtributosCampos estructurados para la comparación por parte de compradores, como dimensiones, capacidad, material, compatibilidad o términos comerciales.
Preparación para publicaciónValidación que comprueba si un borrador puede publicarse.

Para qué sirve el servidor

Listano Control MCP gestiona el catálogo de empresa vinculado a la sesión de integración autenticada.

Usa Listano Control MCP para gestionar un catálogo de empresa mediante acciones estructuradas:

  • listar e inspeccionar las ofertas del catálogo
  • crear nuevos borradores de ofertas
  • actualizar los campos principales en el idioma principal
  • añadir y actualizar las traducciones de las ofertas
  • añadir, actualizar, traducir o eliminar atributos
  • comprobar si un borrador está listo para publicar
  • publicar borradores válidos
  • descartar borradores
  • retirar ofertas publicadas

Para qué no sirve el servidor

Listano Control MCP no es un servidor de búsqueda general y no expone la descubribilidad pública del catálogo. La descubribilidad pública corresponde a Listano Search MCP.

Tampoco gestiona actualmente archivos multimedia. Los archivos multimedia del catálogo no están soportados en el catálogo v1.

Comportamiento de borradores y publicación

Los borradores son temporales. Si un borrador no se publica en los 30 días posteriores a su creación, será eliminado automáticamente.

Un borrador no está activo hasta que se publica.

Cuando una oferta ya tiene una versión publicada actual, editarla crea o actualiza una revisión de borrador no publicada. La versión publicada actual permanece activa hasta que el borrador se publica.

Cuando un borrador se publica, se convierte en la versión actual. Cualquier versión actual anterior queda reemplazada y marcada como obsoleta.

Campos inmutables

El kind y el language de la oferta no pueden modificarse mediante actualizaciones básicas.

Si alguno de estos valores es incorrecto tras la creación, la recuperación segura consiste en descartar el borrador y crear una nueva oferta con los valores correctos.