Listano Docs
Integración con IAListano Control MCP

Permisos

Scopes requeridos por las herramientas de Listano Control MCP.

Permisos

Listano Control MCP está delimitado por empresa y controlado por permisos.

La sesión de integración autenticada determina para qué empresa actúan las herramientas y qué operaciones están disponibles.

Usa whoami para inspeccionar la empresa actual y los scopes otorgados.

Scopes

ScopeEtiquetaPermite
catalog:readVer ofertasListar y leer las ofertas del catálogo, los idiomas admitidos y la preparación para publicación.
catalog:writeGestionar ofertasCrear, actualizar, traducir y gestionar borradores de ofertas.
catalog:publishPublicar y retirarPublicar borradores y retirar ofertas activas.

Matriz de permisos por herramienta

HerramientaScope requerido
pingninguno
whoamininguno
catalog-readmeninguno
get-supported-languagesninguno
list-offeringscatalog:read
get-offeringcatalog:read
check-offering-publish-readinesscatalog:read
new-offeringcatalog:write
update-offering-corecatalog:write
upsert-offering-translationscatalog:write
upsert-offering-attributescatalog:write
upsert-offering-attribute-translationscatalog:write
remove-offering-attributecatalog:write
discard-offering-draftcatalog:write
publish-offeringcatalog:publish
discontinue-offeringcatalog:publish

Comportamiento recomendado con permisos

Al inicio de una sesión, llama a whoami.

Si una operación de modificación falla por permisos, llama a whoami de nuevo e informa qué scope falta.

No intentes eludir los scopes que faltan. La integración debe recibir el permiso necesario antes de que la operación pueda completarse.