Recursos

Referência de ferramentas MCP do WareRushAI

As ferramentas de leitura e escrita do servidor MCP do WareRushAI, os seus âmbitos e o que devolvem ou alteram.

Revised:

1. get_account_info (âmbito account.read)

Devolve a empresa do utilizador com sessão iniciada, a respetiva função, o plano de subscrição e os módulos ativos. Os assistentes invocam-na primeiro para saber de quem são os dados que estão a analisar.

2. list_warehouses (âmbito inventory.read)

Lista os armazéns e localizações da empresa e indica quais estão associados a uma localização do Shopify.

3. search_products (âmbito catalog.read)

Pesquisa produtos por nome, SKU, código de barras, marca ou modelo e devolve uma linha resumida por produto com preço, categoria e stock. Os resultados são paginados; utilize get_product para obter o registo completo.

4. get_product (âmbito catalog.read)

Devolve os dados de um produto, o respetivo stock por localização e o seu estado de publicação no marketplace.

5. get_inventory_summary (âmbito inventory.read)

Devolve a quantidade total de stock por localização, permitindo ao assistente responder a quanto stock a empresa detém em cada armazém.

6. find_missing_product_data (âmbito catalog.read)

Encontra produtos a que faltam dados necessários para a venda (imagem, preço, categoria, descrição, código de barras e similares) e identifica o que está em falta. Os resultados são paginados.

7. find_listing_problems (âmbito catalog.read)

Encontra produtos que não foram publicados num marketplace ou canal e explica o erro com uma resolução simples, como por exemplo a falta de um EAN obrigatório na categoria da Allegro.

8. find_unfulfilled_orders (âmbito orders.read)

Lista encomendas pendentes de lojas online, marketplaces e B2B que ainda não foram enviadas, com a respetiva origem, parceiro e estado.

9. search_categories (âmbito catalog.read)

Pesquisa a árvore de categorias de produto por nome e devolve identificadores e caminhos de categoria; o update_product usa o identificador para definir uma categoria.

10. Como funcionam as ferramentas de escrita

As ferramentas de escrita precisam do âmbito catalog.write ou inventory.write e da função de proprietário ou administrador. Cada uma funciona em dois passos: com confirm=false devolve apenas uma pré-visualização dos valores antigos e novos; com confirm=true e expected_version (a versão do produto da pré-visualização ou do get_product) guarda. Se o produto mudou entretanto, a gravação é recusada. Uma chamada altera um produto, cada alteração fica registada com origem mcp e nada pode ser eliminado.

11. update_product (âmbito catalog.write)

Altera o nome, a descrição, a marca, o tipo, a categoria, o código de barras, o SKU, o preço de venda ou o estado (ativo ou rascunho) de um produto. Um preço definido aqui conta como preço manual que a IA em segundo plano nunca substitui. O SKU é alterado numa chamada separada.

12. adjust_stock (âmbito inventory.write)

Define, adiciona ou retira stock de um produto numa localização através do movimento de stock habitual, pelo que o registo de movimentos e a sincronização de stock com o Shopify também são atualizados.

13. set_channel_listing (âmbito catalog.write)

Ativa, desativa ou repõe a regra do canal para um produto num marketplace ou canal. Produtos usados, recondicionados ou danificados nunca podem ser ativados em canais que só aceitam produtos novos (eMAG, Árukereső, Árgép, Pepita).

14. create_product (âmbito catalog.write)

Cria um novo produto a partir de um código de barras ou de um nome, opcionalmente com stock inicial numa localização. A IA em segundo plano identifica-o e preenche o resto dentro do limite habitual de no máximo 5 chamadas de IA por produto; um código de barras existente nunca é duplicado.