Permissões

O Listano Control MCP é controlado por permissões e tem âmbito por empresa.

A sessão de integração autenticada determina para que empresa as ferramentas actuam e quais as operações disponíveis.

Utilize whoami para inspeccionar a empresa actual e os âmbitos concedidos.

Âmbitos

Âmbito	Etiqueta	Permite
`catalog:read`	Ver ofertas	Listar e ler ofertas do catálogo, idiomas suportados e prontidão para publicação.
`catalog:write`	Gerir ofertas	Criar, actualizar, traduzir e gerir rascunhos de ofertas.
`catalog:publish`	Publicar e descontinuar	Publicar rascunhos e descontinuar ofertas activas.

Ferramenta	Âmbito necessário
`ping`	nenhum
`whoami`	nenhum
`catalog-readme`	nenhum
`get-supported-languages`	nenhum
`list-offerings`	`catalog:read`
`get-offering`	`catalog:read`
`check-offering-publish-readiness`	`catalog:read`
`new-offering`	`catalog:write`
`update-offering-core`	`catalog:write`
`upsert-offering-translations`	`catalog:write`
`upsert-offering-attributes`	`catalog:write`
`upsert-offering-attribute-translations`	`catalog:write`
`remove-offering-attribute`	`catalog:write`
`discard-offering-draft`	`catalog:write`
`publish-offering`	`catalog:publish`
`discontinue-offering`	`catalog:publish`

No início de uma sessão, chame whoami.

Se uma mutação falhar por falta de permissões, chame whoami novamente e indique qual o âmbito em falta.

Não tente contornar âmbitos em falta. A integração deve ter a permissão necessária antes de a operação poder ser executada com sucesso.