Visão geral do Listano Control MCP
Servidor MCP autenticado para gestão de catálogos de empresa no Listano.
O Listano Control MCP é o servidor autenticado de gestão de catálogos do Listano.
Permite que um sistema de IA gira as ofertas da empresa autenticada: criar rascunhos, actualizar campos principais, adicionar traduções, gerir atributos, verificar a prontidão para publicação, publicar rascunhos e descontinuar ofertas activas.
Detalhes do servidor
| Campo | Valor |
|---|---|
| Nome | Listano Control |
| Versão | 1.0.0 |
| Website | https://listano.eu |
| Endpoint | https://control.listano.eu/mcp |
| Modelo de acesso | Integração autenticada com âmbito por empresa |
O Listano Control MCP requer sessões autenticadas sobre uma ligação segura. Os dados do catálogo só podem ser lidos ou alterados de acordo com as permissões concedidas à integração autenticada, com âmbito definido por empresa.
Conceitos principais
| Conceito | Significado |
|---|---|
| Oferta | Um produto, serviço, direito ou acesso publicado no catálogo de uma empresa. |
| Rascunho | Uma versão não publicada de uma oferta. Um rascunho não está activo. Os rascunhos são eliminados automaticamente após 30 dias se não forem publicados. |
| Versão actual | A versão publicada e activa visível para os compradores. |
| Revisão | Uma versão numerada de uma oferta. As revisões publicadas podem ficar desactualizadas quando substituídas. |
| Idioma principal | O idioma utilizado para o título principal da oferta, descrição e etiqueta de categoria. |
| Traduções | Versões do conteúdo da oferta noutros idiomas que não o principal. |
| Atributos | Campos estruturados para comparação por compradores, como dimensões, capacidade, material, compatibilidade ou condições. |
| Prontidão para publicação | Validação que verifica se um rascunho pode ser publicado. |
Para que serve o servidor
O Listano Control MCP gere o catálogo da empresa associado à sessão de integração autenticada.
Utilize o Listano Control MCP para gerir um catálogo de empresa através de acções estruturadas:
- listar e inspeccionar ofertas do catálogo
- criar novos rascunhos de oferta
- actualizar campos principais no idioma principal
- adicionar e actualizar traduções de ofertas
- adicionar, actualizar, traduzir ou remover atributos
- verificar se um rascunho está pronto para publicação
- publicar rascunhos válidos
- descartar rascunhos
- descontinuar ofertas publicadas
Para que não serve o servidor
O Listano Control MCP não é um servidor de pesquisa geral e não expõe a descoberta pública de catálogos. A descoberta pública pertence ao Listano Search MCP.
Também não gere actualmente conteúdo multimédia. Os media de catálogo não são suportados no catálogo v1.
Comportamento de rascunho e publicação
Os rascunhos são temporários. Se um rascunho não for publicado dentro de 30 dias após a criação, será eliminado automaticamente.
Um rascunho não está activo até ser publicado.
Quando uma oferta já tem uma versão publicada actual, a sua edição cria ou actualiza uma revisão de rascunho não publicada. A versão publicada actual permanece activa até o rascunho ser publicado.
Quando um rascunho é publicado, torna-se a versão actual. Qualquer versão actual anterior é substituída e marcada como desactualizada.
Campos imutáveis
O kind e o language de uma oferta não podem ser alterados através de actualizações de campos principais.
Se algum destes valores estiver errado após a criação, a recuperação correcta é descartar o rascunho e criar uma nova oferta com os valores correctos.