Desenvolvedores

Servidor MCP

O MCP (Model Context Protocol) transforma a sua loja numa ferramenta dentro do Claude, do ChatGPT ou de qualquer cliente MCP. São as mesmas 258 capacidades da Admin API, executadas com as permissões da sua chave, nunca mais do que ela pode.

Como conectar

O endpoint fala JSON-RPC 2.0 sobre Streamable HTTP e é autenticado exclusivamente por uma chave de API (mwk_…). O cookie de sessão do painel não autentica o MCP. Exige um plano com acesso à API e com o assistente de IA incluído.

Endpoint

POST https://sistema-SUA-LOJA.meweb.com.br/api/v1/admin/mcp
Authorization: Bearer mwk_sua_chave_secreta
Content-Type: application/json

Exemplo: listar as ferramentas disponíveis para a sua chave

curl -sS https://sistema-SUA-LOJA.meweb.com.br/api/v1/admin/mcp \
  -H "Authorization: Bearer mwk_sua_chave_secreta" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Métodos suportados: initialize, tools/list e tools/call. A lista devolvida é o catálogo abaixo ∩ os escopos da sua chave: uma chave só de leitura de pedidos vê só as ferramentas de leitura de pedidos.

Confirmação em dois passos

Ferramentas de efeito visível não executam na primeira chamada. Elas devolvem um resumo do efeito e um confirmationToken. Para executar, chame a mesma ferramenta de novo com o token e os mesmos argumentos. O token vale por 5 minutos, serve uma única vez, e muda de argumento o invalida.

Exemplo: executar uma ação de efeito visível (2 passos)

# 1) primeira chamada: devolve o resumo + confirmationToken (NÃO executa)
{"jsonrpc":"2.0","id":2,"method":"tools/call",
 "params":{"name":"publish_page","arguments":{"params":{"id":"pg_12"}}}}

# 2) segunda chamada: mesmos argumentos + o token → executa
{"jsonrpc":"2.0","id":3,"method":"tools/call",
 "params":{"name":"publish_page",
   "arguments":{"params":{"id":"pg_12"},"confirmationToken":"mcpc_…"}}}

Ações críticas ficam fora do MCP

Reembolso, cancelamento com estorno, ajuste de estoque, anonimização de cliente e qualquer ação em massa não são expostas aqui: não aparecem em tools/list nem executam se forem chamadas pelo nome (a resposta é AI_MCP_CRITICAL_BLOCKED).

O motivo é simples: essas ações movem dinheiro e estoque de um jeito que não volta, e a regra da casa é que elas exigem uma pessoa digitando o valor ou a quantidade antes de acontecer. Num cliente MCP não há essa pessoa: o token de confirmação iria para o mesmo programa que faria a segunda chamada. Para fazer uma delas, use a conversa do Lia no painel ou a tela do módulo, onde a confirmação é digitada por quem responde pela loja.

Catálogo de ferramentas

258 ferramentas, agrupadas por área. A coluna confirmação marca as que exigem o fluxo de dois passos. Cada ferramenta é uma rota real da Admin API.

Carrinhos abandonados

Ferramenta	O que faz	Nível	Confirmação
`get_abandoned_cart` GET/admin/abandoned-carts/:id	Detalha um carrinho abandonado, com itens e dados de contato.	Leitura	–
`list_abandoned_carts` GET/admin/abandoned-carts	Lista os carrinhos abandonados com valor, contato e estágio.	Leitura	–
`log_abandoned_cart_whatsapp` POST/admin/abandoned-carts/:id/log-whatsapp	Registra que o contato de recuperação foi feito por WhatsApp.	Alteração reversível	–
`send_abandoned_cart_email` POST/admin/abandoned-carts/:id/send-email	Envia ao cliente o e-mail de recuperação do carrinho abandonado.	Efeito visível	2 passos

Relatórios

Ferramenta	O que faz	Nível	Confirmação
`create_accountant_package` POST/admin/analytics/fiscal/accountant-package	Monta o pacote do contador (XMLs e planilhas do mês) para download.	Alteração reversível	–
`create_report_export` POST/admin/analytics/export	Gera um arquivo CSV de um relatório do período para download posterior pelo lojista.	Alteração reversível	–
`delete_report_schedule` DELETE/admin/analytics/report-schedules/:id	Exclui um relatório agendado e interrompe os envios.	Efeito visível	2 passos
`get_annual_revenue` GET/admin/analytics/fiscal/revenue	Faturamento mês a mês do ano informado, para acompanhamento do limite do Simples.	Leitura	–
`get_checkout_funnel` GET/admin/analytics/checkout-funnel	Funil do checkout no período — da visita ao pedido pago, com a perda em cada etapa.	Leitura	–
`get_customers_report` GET/admin/analytics/customers	Relatório de clientes no período (novos, recorrentes e receita por cliente).	Leitura	–
`get_dashboard` GET/admin/analytics/dashboard	Resumo da loja no período (vendas, pedidos, ticket médio e alertas) para a home do admin.	Leitura	–
`get_fiscal_by_ncm_cfop` GET/admin/analytics/fiscal/by-ncm-cfop	Consolidação fiscal por NCM e CFOP no período.	Leitura	–
`get_fiscal_inputs` GET/admin/analytics/fiscal/inputs	Entradas fiscais do período (notas de compra reconhecidas).	Leitura	–
`get_income_statement` GET/admin/analytics/fiscal/dre	DRE gerencial do período (receita, custos, despesas e resultado).	Leitura	–
`get_inventory_report` GET/admin/analytics/inventory	Relatório de estoque no período (giro, cobertura e itens parados).	Leitura	–
`get_inventory_valuation` GET/admin/analytics/fiscal/inventory-valuation	Valorização do estoque em uma data de corte, para o balanço.	Leitura	–
`get_sales_report` GET/admin/analytics/sales	Relatório de vendas por período, canal e forma de pagamento.	Leitura	–
`list_report_schedules` GET/admin/analytics/report-schedules	Lista os relatórios agendados por e-mail.	Leitura	–
`pause_report_schedule` POST/admin/analytics/report-schedules/:id/pause	Pausa os envios de um relatório agendado sem excluí-lo.	Efeito visível	2 passos
`resume_report_schedule` POST/admin/analytics/report-schedules/:id/resume	Retoma os envios de um relatório agendado pausado.	Efeito visível	2 passos

Produtos

Ferramenta	O que faz	Nível	Confirmação
`activate_product` POST/admin/products/:id/activate	Ativa um produto e o coloca à venda na loja.	Efeito visível	2 passos
`archive_product` POST/admin/products/:id/archive	Arquiva um produto e o tira da loja.	Efeito visível	2 passos
`create_category` POST/admin/categories	Cria uma categoria do catálogo.	Efeito visível	2 passos
`create_collection` POST/admin/collections	Cria uma coleção manual ou automática.	Efeito visível	2 passos
`create_product_draft` POST/admin/products	Cria um produto como rascunho (nasce inativo, fora da loja).	Alteração reversível	–
`delete_category` DELETE/admin/categories/:id	Exclui uma categoria sem produtos vinculados.	Efeito visível	2 passos
`delete_collection` DELETE/admin/collections/:id	Exclui uma coleção.	Efeito visível	2 passos
`duplicate_product` POST/admin/products/:id/duplicate	Duplica um produto existente como novo rascunho.	Alteração reversível	–
`get_catalog_import` GET/admin/catalog-imports/:id	Detalha uma importação de catálogo (contagens, erros e progresso).	Leitura	–
`get_catalog_import_template` GET/admin/catalog-imports/template	Baixa o CSV modelo de importação de catálogo.	Leitura	–
`get_collection` GET/admin/collections/:id	Detalha uma coleção, com regras e configuração de vitrine.	Leitura	–
`get_product` GET/admin/products/:id	Detalha um produto com variantes, mídias, opções e dados fiscais.	Leitura	–
`list_catalog_import_items` GET/admin/catalog-imports/:id/items	Lista linha a linha o resultado de uma importação de catálogo.	Leitura	–
`list_catalog_imports` GET/admin/catalog-imports	Lista as importações de catálogo já enviadas, com status e resultado.	Leitura	–
`list_categories` GET/admin/categories	Lista a árvore de categorias do catálogo.	Leitura	–
`list_collection_products` GET/admin/collections/:id/products	Lista os produtos que compõem uma coleção.	Leitura	–
`list_collections` GET/admin/collections	Lista as coleções da loja (manuais e automáticas).	Leitura	–
`list_products` GET/admin/products	Lista produtos com filtros de status, categoria, coleção e busca.	Leitura	–
`preview_collection_rules` POST/admin/collections/preview-rules	Simula quais produtos entrariam em uma coleção automática com as regras informadas.	Leitura	–
`set_collection_products` PUT/admin/collections/:id/products	Define os produtos e a ordem de uma coleção manual.	Efeito visível	2 passos
`set_product_faqs` PUT/admin/products/:id/faqs	Define as perguntas e respostas exibidas na página do produto.	Alteração reversível	–
`set_product_media` PUT/admin/products/:id/media	Define a lista e a ordem das imagens de um produto.	Alteração reversível	–
`set_product_options` PUT/admin/products/:id/options	Define as opções do produto (cor, tamanho) e regenera as combinações de variantes.	Efeito visível	2 passos
`update_category` PATCH/admin/categories/:id	Renomeia ou reposiciona uma categoria do catálogo.	Efeito visível	2 passos
`update_collection` PATCH/admin/collections/:id	Edita nome, regras, SEO ou publicação de uma coleção.	Efeito visível	2 passos
`update_product` PATCH/admin/products/:id	Edita título, descrição, SEO, categoria ou dados fiscais de um produto. Parcial: mande SÓ os campos que mudam — o que for omitido fica como está, e `null` limpa o campo.	Alteração reversível	–
`update_variant` PATCH/admin/products/:id/variants/:variantId	Altera preço, SKU, código de barras, dimensões ou disponibilidade de uma variante.	Efeito visível	2 passos

Conteúdo e mídia

Ferramenta	O que faz	Nível	Confirmação
`create_media_folder` POST/admin/media/folders	Cria uma pasta na biblioteca de mídia.	Alteração reversível	–
`delete_media` DELETE/admin/media/:id	Exclui um arquivo da biblioteca de mídia.	Efeito visível	2 passos
`delete_media_folder` DELETE/admin/media/folders/:id	Exclui uma pasta vazia da biblioteca de mídia.	Efeito visível	2 passos
`list_media` GET/admin/media	Lista os arquivos da biblioteca de mídia com filtros de pasta e busca.	Leitura	–
`list_media_folders` GET/admin/media/folders/all	Lista as pastas da biblioteca de mídia.	Leitura	–
`list_media_usages` GET/admin/media/:id/usages	Mostra onde um arquivo de mídia está sendo usado antes de excluí-lo.	Leitura	–
`update_media` PATCH/admin/media/:id	Renomeia, move de pasta ou ajusta o texto alternativo de um arquivo.	Alteração reversível	–

Clientes

Ferramenta	O que faz	Nível	Confirmação
`create_customer` POST/admin/customers	Cadastra um cliente manualmente.	Alteração reversível	–
`get_customer` GET/admin/customers/:id	Detalha um cliente com contato, endereços, pedidos e consentimentos.	Leitura	–
`list_customer_tags` GET/admin/customers/tags	Lista as tags de cliente já usadas na loja.	Leitura	–
`set_customer_tags` PUT/admin/customers/:id/tags	Define as tags de um cliente.	Alteração reversível	–
`update_customer` PATCH/admin/customers/:id	Edita contato, documento ou observações de um cliente.	Alteração reversível	–

Cupons

Ferramenta	O que faz	Nível	Confirmação
`activate_discount` POST/admin/discounts/:id/activate	Ativa um cupom ou promoção, liberando o uso na loja.	Efeito visível	2 passos
`create_discount` POST/admin/discounts	Cria um cupom ou promoção com as regras informadas.	Efeito visível	2 passos
`deactivate_discount` POST/admin/discounts/:id/deactivate	Desativa um cupom ou promoção.	Efeito visível	2 passos
`delete_discount` DELETE/admin/discounts/:id	Exclui um cupom ou promoção nunca utilizado.	Efeito visível	2 passos
`generate_discount_code` POST/admin/discounts/generate-code	Gera um código aleatório disponível para usar em um cupom novo.	Leitura	–
`get_discount` GET/admin/discounts/:id	Detalha um cupom ou promoção, com regras e limites de uso.	Leitura	–
`list_discount_redemptions` GET/admin/discounts/:id/redemptions	Lista os usos de um cupom, com pedido e cliente.	Leitura	–
`list_discounts` GET/admin/discounts	Lista cupons e promoções com filtros de status e tipo.	Leitura	–
`update_discount` PATCH/admin/discounts/:id	Edita regras, período ou limites de um cupom ou promoção.	Efeito visível	2 passos

Cartões-presente

Ferramenta	O que faz	Nível	Confirmação
`get_gift_card` GET/admin/gift-cards/:id	Detalha um vale-presente e o histórico de uso.	Leitura	–
`get_gift_card_settings` GET/admin/gift-cards/settings	Mostra as regras de vale-presente da loja (validade, valores, reenvio).	Leitura	–
`list_gift_cards` GET/admin/gift-cards	Lista os vales-presente com saldo, validade e status.	Leitura	–
`resend_gift_card` POST/admin/gift-cards/:id/resend	Reenvia ao destinatário o e-mail com o código do vale-presente — só funciona enquanto a entrega não foi confirmada (`canResend`); depois disso o código só existe como hash e a saída é emitir um cartão novo.	Efeito visível	2 passos

Estoque

Ferramenta	O que faz	Nível	Confirmação
`cancel_stock_count` POST/admin/stock-counts/:id/cancel	Cancela um inventário em andamento sem aplicar as contagens.	Efeito visível	2 passos
`cancel_stock_transfer` POST/admin/stock-transfers/:id/cancel	Cancela uma transferência de estoque ainda não despachada.	Efeito visível	2 passos
`create_stock_count` POST/admin/stock-counts	Abre um inventário de estoque em rascunho para um local.	Alteração reversível	–
`create_stock_location` POST/admin/stock-locations	Cria um local de estoque.	Efeito visível	2 passos
`create_stock_transfer` POST/admin/stock-transfers	Cria uma transferência de estoque entre locais, em rascunho.	Alteração reversível	–
`get_inventory` GET/admin/inventory	Lista o estoque por variante, com saldo, reservado e disponível.	Leitura	–
`get_inventory_settings` GET/admin/inventory/settings	Mostra o limiar default de estoque baixo da loja (spec 05 RN-07) — o número a partir do qual a variante entra no alerta.	Leitura	–
`get_inventory_totals` GET/admin/inventory/totals	Devolve o saldo disponível consolidado de variantes específicas.	Leitura	–
`get_stock_count` GET/admin/stock-counts/:id	Detalha um inventário, com progresso e divergências.	Leitura	–
`get_stock_transfer` GET/admin/stock-transfers/:id	Detalha uma transferência de estoque e seus itens.	Leitura	–
`list_inventory_batches` GET/admin/inventory/batches	Lista os lotes em estoque, com validade e saldo.	Leitura	–
`list_inventory_locations` GET/admin/inventory/locations	Lista os saldos por local de estoque.	Leitura	–
`list_inventory_movements` GET/admin/inventory/movements	Lista as movimentações de estoque (entradas, saídas, ajustes) com filtros.	Leitura	–
`list_inventory_serials` GET/admin/inventory/serials	Busca números de série e mostra onde estão ou para qual pedido foram.	Leitura	–
`list_stock_count_items` GET/admin/stock-counts/:id/items	Lista os itens de um inventário com o esperado e o contado.	Leitura	–
`list_stock_counts` GET/admin/stock-counts	Lista os inventários (contagens de estoque) e seus status.	Leitura	–
`list_stock_locations` GET/admin/stock-locations	Lista os locais de estoque da loja.	Leitura	–
`list_stock_transfers` GET/admin/stock-transfers	Lista as transferências entre locais de estoque.	Leitura	–
`start_stock_count` POST/admin/stock-counts/:id/start	Inicia a contagem de um inventário e congela o esperado.	Efeito visível	2 passos
`update_inventory_settings` PATCH/admin/inventory/settings	Altera o limiar default de estoque baixo da loja (afeta o card, o filtro e o alerta de estoque baixo).	Efeito visível	2 passos
`update_stock_location` PATCH/admin/stock-locations/:id	Edita nome, endereço ou status de um local de estoque.	Efeito visível	2 passos
`update_stock_transfer` PATCH/admin/stock-transfers/:id	Edita uma transferência de estoque em rascunho (locais e itens).	Alteração reversível	–

Marketing

Ferramenta	O que faz	Nível	Confirmação
`activate_journey` POST/admin/marketing/journeys/:id/activate	Ativa uma automação: a partir daí ela passa a inscrever e enviar sozinha.	Efeito visível	2 passos
`archive_journey` POST/admin/marketing/journeys/:id/archive	Arquiva uma automação e encerra as inscrições em aberto.	Efeito visível	2 passos
`archive_whatsapp_template` DELETE/admin/marketing/whatsapp/templates/:id	Arquiva um modelo de mensagem do WhatsApp (o histórico enviado é preservado).	Efeito visível	2 passos
`cancel_campaign` POST/admin/marketing/campaigns/:id/cancel	Cancela uma campanha agendada ou em disparo.	Efeito visível	2 passos
`count_segment` POST/admin/marketing/segments/:id/count	Recalcula quantas pessoas o segmento atinge por canal.	Leitura	–
`create_campaign` POST/admin/marketing/campaigns	Cria uma campanha de marketing em rascunho.	Alteração reversível	–
`create_journey` POST/admin/marketing/journeys	Cria uma automação de marketing em rascunho.	Alteração reversível	–
`create_journey_from_recipe` POST/admin/marketing/journeys/from-recipe	Cria uma automação a partir de uma receita pronta, em rascunho.	Alteração reversível	–
`create_segment` POST/admin/marketing/segments	Cria um segmento de público com as regras informadas.	Alteração reversível	–
`create_whatsapp_template` POST/admin/marketing/whatsapp/templates	Cria um modelo de mensagem do WhatsApp em rascunho.	Alteração reversível	–
`delete_campaign` DELETE/admin/marketing/campaigns/:id	Exclui uma campanha que ainda não foi disparada.	Efeito visível	2 passos
`delete_segment` DELETE/admin/marketing/segments/:id	Exclui um segmento de público não usado por campanhas ativas.	Efeito visível	2 passos
`get_campaign` GET/admin/marketing/campaigns/:id	Detalha uma campanha, com público, conteúdo e métricas.	Leitura	–
`get_journey` GET/admin/marketing/journeys/:id	Detalha uma automação, com gatilho, passos e versão.	Leitura	–
`get_journey_enrollment_stats` GET/admin/marketing/journeys/:id/enrollments/stats	Devolve o funil de uma automação (entradas, conversões e saídas).	Leitura	–
`get_marketing_dashboard` GET/admin/marketing/dashboard	Painel de marketing: receita atribuída, automações ativas e envios do período.	Leitura	–
`get_marketing_settings` GET/admin/marketing/settings	Mostra as configurações de marketing (remetente, quiet hours, atribuição).	Leitura	–
`get_segment` GET/admin/marketing/segments/:id	Detalha um segmento e as regras que definem o público.	Leitura	–
`get_whatsapp_conversation` GET/admin/marketing/whatsapp/conversations/:id	Detalha uma conversa de WhatsApp com o contato e a janela de atendimento.	Leitura	–
`get_whatsapp_status` GET/admin/marketing/whatsapp	Estado da conexão do WhatsApp do lojista e a URL do webhook do tenant.	Leitura	–
`get_whatsapp_template` GET/admin/marketing/whatsapp/templates/:id	Detalha um modelo de mensagem do WhatsApp.	Leitura	–
`list_campaigns` GET/admin/marketing/campaigns	Lista as campanhas de marketing com status, canal e resultado.	Leitura	–
`list_customer_consent_events` GET/admin/marketing/consents/:customerId/events	Mostra o histórico completo de consentimento de um titular.	Leitura	–
`list_journey_enrollments` GET/admin/marketing/journeys/:id/enrollments	Lista quem está em uma automação e em que passo cada pessoa parou.	Leitura	–
`list_journey_recipes` GET/admin/marketing/journeys/recipes	Lista as receitas prontas de automação disponíveis para ligar.	Leitura	–
`list_journeys` GET/admin/marketing/journeys	Lista as automações de marketing com status e desempenho.	Leitura	–
`list_marketing_consents` GET/admin/marketing/consents	Lista o consentimento de marketing por titular, com canal, origem e data.	Leitura	–
`list_marketing_messages` GET/admin/marketing/messages	Lista as mensagens de marketing enviadas, com canal, status e destinatário.	Leitura	–
`list_segments` GET/admin/marketing/segments	Lista os segmentos de público com o tamanho estimado.	Leitura	–
`list_whatsapp_messages` GET/admin/marketing/whatsapp/conversations/:id/messages	Lista o histórico de mensagens trocadas com um contato no WhatsApp.	Leitura	–
`list_whatsapp_templates` GET/admin/marketing/whatsapp/templates	Lista os modelos de mensagem do WhatsApp e o status de aprovação na Meta.	Leitura	–
`pause_journey` POST/admin/marketing/journeys/:id/pause	Pausa uma automação ativa sem perder as inscrições.	Efeito visível	2 passos
`restore_journey_recipe` POST/admin/marketing/journeys/:id/restore-recipe	Restaura os passos originais da receita, descartando as edições.	Efeito visível	2 passos
`revoke_marketing_consent` POST/admin/marketing/consents/:customerId/revoke	Revoga o consentimento de marketing de um titular a pedido dele.	Efeito visível	2 passos
`schedule_campaign` POST/admin/marketing/campaigns/:id/schedule	Agenda o disparo de uma campanha para data e hora.	Efeito visível	2 passos
`send_campaign` POST/admin/marketing/campaigns/:id/send	Dispara a campanha agora para todo o público selecionado.	Efeito visível	2 passos
`set_journey_steps` PUT/admin/marketing/journeys/:id/steps	Substitui os passos de uma automação e incrementa a versão.	Alteração reversível	–
`submit_whatsapp_template` POST/admin/marketing/whatsapp/templates/:id/submit	Submete o modelo à aprovação da Meta.	Efeito visível	2 passos
`sync_whatsapp_templates` POST/admin/marketing/whatsapp/templates/sync	Sincroniza com a Meta o status de aprovação dos modelos.	Alteração reversível	–
`test_campaign` POST/admin/marketing/campaigns/:id/test	Envia a campanha de teste para os endereços informados.	Efeito visível	2 passos
`test_journey` POST/admin/marketing/journeys/:id/test	Executa a automação em modo de teste para um contato informado.	Efeito visível	2 passos
`update_campaign` PATCH/admin/marketing/campaigns/:id	Edita conteúdo, público ou remetente de uma campanha em rascunho.	Alteração reversível	–
`update_journey` PATCH/admin/marketing/journeys/:id	Edita nome, gatilho ou configurações de uma automação.	Alteração reversível	–
`update_segment` PATCH/admin/marketing/segments/:id	Edita o nome ou as regras de um segmento de público.	Alteração reversível	–
`update_whatsapp_template` PATCH/admin/marketing/whatsapp/templates/:id	Edita um modelo de mensagem do WhatsApp ainda não submetido.	Alteração reversível	–

Pedidos

Ferramenta	O que faz	Nível	Confirmação
`add_order_note` POST/admin/orders/:id/notes	Registra uma observação interna na timeline do pedido.	Alteração reversível	–
`cancel_whatsapp_charge` POST/admin/marketing/whatsapp/charges/:id/cancel	Cancela uma cobrança de WhatsApp; o pedido segue como está.	Efeito visível	2 passos
`confirm_order_draft` POST/admin/orders/:id/confirm	Confirma o pedido em rascunho, reserva o estoque e o coloca no fluxo normal.	Efeito visível	2 passos
`create_order_draft` POST/admin/orders	Cria um pedido manual em rascunho (venda no balcão ou por telefone).	Alteração reversível	–
`delete_order_draft` DELETE/admin/orders/:id	Exclui um pedido em rascunho que nunca foi confirmado.	Alteração reversível	–
`get_carrier_label` GET/admin/orders/:id/carrier-label	Mostra a etiqueta contratada de um pedido e o status junto à transportadora.	Leitura	–
`get_order` GET/admin/orders/:id	Detalha um pedido com itens, pagamento, entrega, cliente e timeline.	Leitura	–
`get_order_shipping_label` GET/admin/orders/:id/shipping-label	Gera a etiqueta de envio imprimível do pedido.	Leitura	–
`get_order_status_counts` GET/admin/orders/status-counts	Devolve a contagem de pedidos por status para os cartões do painel.	Leitura	–
`get_payment` GET/admin/payments/:id	Detalha uma cobrança para suporte (provedor, status, tentativas e erros).	Leitura	–
`list_order_fiscal_documents` GET/admin/orders/:id/fiscal-documents	Lista as notas fiscais emitidas para um pedido, com status e links.	Leitura	–
`list_orders` GET/admin/orders	Lista os pedidos com filtros de status, período, canal e busca.	Leitura	–
`list_whatsapp_charges` GET/admin/marketing/whatsapp/charges	Lista as cobranças enviadas por WhatsApp de um pedido, com status.	Leitura	–
`mark_order_delivered` POST/admin/orders/:id/deliver	Marca o pedido como entregue.	Efeito visível	2 passos
`process_order` POST/admin/orders/:id/process	Marca o pedido como em separação/processamento.	Efeito visível	2 passos
`refresh_fiscal_document` POST/admin/fiscal-documents/:id/refresh	Reconsulta no provedor o status atual de uma nota fiscal.	Leitura	–
`resend_whatsapp_charge` POST/admin/marketing/whatsapp/charges/:id/resend	Reenvia ao cliente a mesma cobrança de WhatsApp, enquanto válida.	Efeito visível	2 passos
`search_order_variants` GET/admin/orders/variant-search	Busca variantes por título, SKU ou código de barras com o saldo do local, para a venda no balcão.	Leitura	–
`send_whatsapp_charge_code` POST/admin/marketing/whatsapp/charges/:id/send-code	Envia apenas o código Pix copia-e-cola na conversa do WhatsApp.	Efeito visível	2 passos
`set_order_tracking` POST/admin/orders/:id/tracking	Informa o código de rastreio do pedido e avisa o cliente.	Efeito visível	2 passos
`update_order_draft` PATCH/admin/orders/:id	Edita itens, cliente ou frete de um pedido ainda em rascunho.	Alteração reversível	–
`whatsapp_charge_order` POST/admin/marketing/whatsapp/charges	Envia ao cliente, por WhatsApp, a cobrança do pedido com o Pix copia-e-cola.	Efeito visível	2 passos

Contas a pagar

Ferramenta	O que faz	Nível	Confirmação
`list_payables` GET/admin/payables	Lista as contas a pagar com vencimento, fornecedor e situação.	Leitura	–

Pedidos de compra

Ferramenta	O que faz	Nível	Confirmação
`cancel_purchase_order` POST/admin/purchase-orders/:id/cancel	Cancela um pedido de compra ainda não recebido.	Efeito visível	2 passos
`close_purchase_order` POST/admin/purchase-orders/:id/close	Encerra um pedido de compra já recebido.	Efeito visível	2 passos
`close_quotation` POST/admin/quotations/:id/close	Encerra a cotação escolhendo o fornecedor vencedor.	Efeito visível	2 passos
`create_purchase_order` POST/admin/purchase-orders	Cria um pedido de compra em rascunho.	Alteração reversível	–
`create_quotation` POST/admin/quotations	Cria uma cotação de compra em rascunho.	Alteração reversível	–
`create_supplier` POST/admin/suppliers	Cadastra um fornecedor.	Alteração reversível	–
`get_purchase_order` GET/admin/purchase-orders/:id	Detalha um pedido de compra, com itens, recebimentos e financeiro.	Leitura	–
`get_quotation` GET/admin/quotations/:id	Detalha uma cotação, com itens e propostas por fornecedor.	Leitura	–
`list_purchase_orders` GET/admin/purchase-orders	Lista os pedidos de compra com status, fornecedor e valor.	Leitura	–
`list_quotations` GET/admin/quotations	Lista as cotações de compra com status e fornecedores convidados.	Leitura	–
`list_replenishment_suggestions` GET/admin/purchase-orders/replenishment-suggestions	Sugere o que recomprar a partir do giro, do estoque atual e do prazo do fornecedor.	Leitura	–
`list_suppliers` GET/admin/suppliers	Lista os fornecedores com contato e condições comerciais.	Leitura	–
`preview_nfe_import` POST/admin/purchase-orders/import-nfe	Lê o XML de uma NF-e de compra e devolve a prévia de conciliação com o catálogo.	Leitura	–
`send_purchase_order` POST/admin/purchase-orders/:id/send	Envia o pedido de compra ao fornecedor.	Efeito visível	2 passos
`send_quotation` POST/admin/quotations/:id/send	Envia a cotação aos fornecedores convidados.	Efeito visível	2 passos
`set_quotation_entry` PATCH/admin/quotations/:id/entries/:supplierId	Registra a proposta de um fornecedor em uma cotação.	Alteração reversível	–
`update_purchase_order` PATCH/admin/purchase-orders/:id	Edita itens, prazos ou custos de um pedido de compra em rascunho.	Alteração reversível	–
`update_supplier` PATCH/admin/suppliers/:id	Edita contato, prazos ou condições de um fornecedor.	Alteração reversível	–

Avaliações

Ferramenta	O que faz	Nível	Confirmação
`approve_review` POST/admin/reviews/:id/approve	Aprova uma avaliação e a publica na página do produto.	Efeito visível	2 passos
`list_reviews` GET/admin/reviews	Lista as avaliações de produto para moderação, com filtros de status e nota.	Leitura	–
`reject_review` POST/admin/reviews/:id/reject	Reprova uma avaliação, com o motivo registrado.	Efeito visível	2 passos
`reply_review` POST/admin/reviews/:id/reply	Publica a resposta da loja a uma avaliação.	Efeito visível	2 passos

settings

Ferramenta	O que faz	Nível	Confirmação
`get_checkout_settings` GET/admin/settings/checkout	Mostra as regras de campos e comportamento do checkout.	Leitura	–
`get_email_settings` GET/admin/settings/email	Mostra a configuração de envio de e-mail (remetente e servidor), sem a senha.	Leitura	–
`get_fiscal_integration` GET/admin/settings/fiscal-integration	Mostra a configuração da integração fiscal (provedor, ambiente e estado), sem segredos.	Leitura	–
`get_fiscal_settings` GET/admin/settings/fiscal	Mostra os parâmetros fiscais da loja (regime, CFOP e alíquotas padrão).	Leitura	–
`get_payment_settings` GET/admin/settings/payments	Mostra os meios de pagamento habilitados e quais credenciais já estão preenchidas (nunca os segredos).	Leitura	–
`get_shipping_integration` GET/admin/settings/shipping-integration	Mostra a integração de frete configurada (provedor e estado), sem segredos.	Leitura	–
`get_shipping_settings` GET/admin/settings/shipping	Mostra as regras de frete configuradas (faixas, frete grátis, retirada).	Leitura	–
`get_store_settings` GET/admin/settings/store	Mostra os dados da loja (nome, contato, endereço, fuso e moeda).	Leitura	–
`get_webhook` GET/admin/webhooks/:id	Detalha um webhook (URL, eventos assinados e estatísticas).	Leitura	–
`list_webhook_deliveries` GET/admin/webhooks/:id/deliveries	Lista as entregas de um webhook, com status e resposta do destino.	Leitura	–
`list_webhooks` GET/admin/webhooks	Lista os webhooks configurados, com eventos e estado de entrega.	Leitura	–
`quote_shipping_integration` POST/admin/settings/shipping-integration/quote	Cota o frete no provedor para um CEP e um pacote de teste.	Leitura	–
`redeliver_webhook` POST/admin/webhooks/:id/deliveries/:deliveryId/redeliver	Reenvia ao destino uma entrega de webhook que falhou.	Efeito visível	2 passos
`simulate_shipping` POST/admin/settings/shipping/simulate	Simula, para um CEP e um valor, as opções de frete que o cliente veria.	Leitura	–
`test_webhook` POST/admin/webhooks/:id/test	Dispara um evento de teste para o destino já configurado.	Efeito visível	2 passos
`update_checkout_settings` PATCH/admin/settings/checkout	Altera os campos obrigatórios e o comportamento do checkout.	Efeito visível	2 passos
`update_fiscal_settings` PUT/admin/settings/fiscal	Altera os parâmetros fiscais padrão da loja.	Efeito visível	2 passos
`update_gift_card_settings` PATCH/admin/gift-cards/settings	Altera as regras de vale-presente da loja.	Efeito visível	2 passos
`update_marketing_settings` PATCH/admin/marketing/settings	Altera as configurações de marketing da loja.	Efeito visível	2 passos
`update_shipping_settings` PUT/admin/settings/shipping	Substitui as regras de frete da loja.	Efeito visível	2 passos
`update_store_settings` PATCH/admin/settings/store	Altera os dados da loja exibidos na vitrine e nos documentos.	Efeito visível	2 passos

Site

Ferramenta	O que faz	Nível	Confirmação
`create_blog_post_draft` POST/admin/blog/posts	Cria um post do blog como rascunho.	Alteração reversível	–
`create_menu` POST/admin/menus	Cria um menu de navegação.	Alteração reversível	–
`create_page` POST/admin/pages	Cria uma página institucional do site.	Efeito visível	2 passos
`delete_blog_post` DELETE/admin/blog/posts/:id	Exclui um post do blog.	Efeito visível	2 passos
`delete_menu` DELETE/admin/menus/:id	Exclui um menu de navegação.	Efeito visível	2 passos
`delete_page` DELETE/admin/pages/:id	Exclui uma página institucional.	Efeito visível	2 passos
`discard_site_layout` POST/admin/site/layout/discard	Descarta o rascunho do site e volta ao que está publicado.	Alteração reversível	–
`get_blog_post` GET/admin/blog/posts/:id	Detalha um post do blog, com conteúdo e SEO.	Leitura	–
`get_blog_post_preview_link` GET/admin/blog/posts/:id/preview-link	Devolve o link de pré-visualização de um post ainda não publicado.	Leitura	–
`get_menu` GET/admin/menus/:id	Detalha um menu e seus itens.	Leitura	–
`get_order_tracking_config` GET/admin/site/order-tracking	Mostra a configuração da página de rastreio de pedidos.	Leitura	–
`get_page` GET/admin/pages/:id	Detalha uma página institucional, com blocos e SEO.	Leitura	–
`get_page_preview_token` GET/admin/pages/:id/preview-token	Devolve o token de pré-visualização de uma página não publicada.	Leitura	–
`get_sales_channels` GET/admin/channels	Estado dos canais de venda (Google, feed) e do token do feed.	Leitura	–
`get_site_construction` GET/admin/site/construction	Mostra o estado do modo em construção do site.	Leitura	–
`get_site_custom_code` GET/admin/site/custom-code	Mostra os trechos de código customizado instalados no site.	Leitura	–
`get_site_design` GET/admin/site/designs/:id	Detalha um rascunho de design: tema, configurações, identidade e seções.	Leitura	–
`get_site_design_preview_token` GET/admin/site/designs/:id/preview-token	Devolve o token que pré-visualiza um rascunho de design no site.	Leitura	–
`get_site_identity` GET/admin/site/identity	Mostra a identidade visual do site (logo, cores, tipografia).	Leitura	–
`get_site_layout` GET/admin/site/layout	Devolve o layout da home (seções publicadas e rascunho) do site.	Leitura	–
`get_site_preview_token` GET/admin/site/preview-token	Devolve o token de pré-visualização do rascunho do site.	Leitura	–
`get_site_theme` GET/admin/site/theme	Mostra o tema aplicado e as configurações dele.	Leitura	–
`get_theme_preview_token` GET/admin/site/theme/preview-token	Devolve o token que pré-visualiza o site publicado em outro tema.	Leitura	–
`list_blog_posts` GET/admin/blog/posts	Lista os posts do blog com filtros de status, tag e busca.	Leitura	–
`list_menus` GET/admin/menus	Lista os menus de navegação do site.	Leitura	–
`list_pages` GET/admin/pages	Lista as páginas institucionais do site com status.	Leitura	–
`list_site_designs` GET/admin/site/designs	Lista o design publicado do site e os rascunhos nomeados em edição.	Leitura	–
`publish_blog_post` POST/admin/blog/posts/:id/publish	Publica um post do blog na loja.	Efeito visível	2 passos
`publish_page` POST/admin/pages/:id/publish	Publica uma página institucional na loja.	Efeito visível	2 passos
`publish_site_layout` POST/admin/site/layout/publish	Publica o rascunho do site e coloca as alterações no ar.	Efeito visível	2 passos
`rename_menu` PATCH/admin/menus/:id	Renomeia um menu de navegação.	Alteração reversível	–
`search_collection_links` GET/admin/collections/search-links	Busca coleções por nome para montar links em menus e seções do site.	Leitura	–
`search_pages` GET/admin/pages/search	Busca páginas por título para montar links em menus e seções.	Leitura	–
`search_product_links` GET/admin/products/search-links	Busca produtos por título para montar links em menus e seções do site.	Leitura	–
`set_channel_enabled` PATCH/admin/channels/:channel	Liga ou desliga um canal de venda.	Efeito visível	2 passos
`set_menu_items` PUT/admin/menus/:id/items	Define os itens e a hierarquia de um menu exibido na loja.	Efeito visível	2 passos
`set_site_construction` PATCH/admin/site/construction	Liga ou desliga o modo em construção, que esconde a loja do público.	Efeito visível	2 passos
`set_site_sections` PUT/admin/site/layout/sections	Substitui as seções do rascunho da home do site.	Alteração reversível	–
`set_site_theme` PATCH/admin/site/theme	Troca o tema do site.	Efeito visível	2 passos
`sync_google_feed` POST/admin/channels/google/sync	Dispara a sincronização do catálogo com o Google Merchant.	Efeito visível	2 passos
`unpublish_blog_post` POST/admin/blog/posts/:id/unpublish	Despublica um post do blog e o tira do ar.	Efeito visível	2 passos
`unpublish_page` POST/admin/pages/:id/unpublish	Despublica uma página institucional e a tira do ar.	Efeito visível	2 passos
`update_blog_post` PATCH/admin/blog/posts/:id	Edita título, conteúdo, capa, tags ou SEO de um post do blog.	Alteração reversível	–
`update_page` PATCH/admin/pages/:id	Edita conteúdo, SEO ou status de uma página institucional.	Efeito visível	2 passos
`update_site_identity` PATCH/admin/site/identity	Altera logo, cores e tipografia do site.	Efeito visível	2 passos
`update_site_theme_settings` PATCH/admin/site/theme/settings	Altera as configurações do tema aplicado.	Efeito visível	2 passos

Contagens de estoque

Ferramenta	O que faz	Nível	Confirmação
`record_stock_count_item` PUT/admin/stock-counts/:id/items/:itemId	Registra a quantidade contada de um item do inventário.	Efeito visível	2 passos

Usuários e acessos

Ferramenta	O que faz	Nível	Confirmação
`get_access_logs_summary` GET/admin/access-logs/summary	Resumo dos acessos ao painel no período (tentativas, bloqueios e usuários ativos).	Leitura	–
`get_staff_user` GET/admin/users/:id	Detalha um usuário do painel e suas permissões efetivas.	Leitura	–
`list_access_logs` GET/admin/access-logs	Lista os acessos ao painel (quem entrou, quando, de onde) com filtros.	Leitura	–
`list_permission_groups` GET/admin/permission-groups	Lista os grupos de permissão e a matriz de acesso de cada um.	Leitura	–
`list_staff_user_access_logs` GET/admin/users/:id/access-logs	Lista os acessos ao painel de um usuário específico.	Leitura	–
`list_staff_users` GET/admin/users	Lista os usuários do painel com grupo, status e último acesso.	Leitura	–

Servidor meweb-loja. Toda ação é registrada em auditoria com a chave como autora, exatamente como uma requisição da API. As permissões da chave são o teto: o MCP nunca faz mais do que a chave pode.