> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/assistente-ia-mcp/visao-geral.md).

# Visão Geral

O **Assistente IA** deixa você **conversar com a sua loja em português normal** — sem saber nada de API, sem colar token. Você conecta o assistente uma vez ao Claude, ao ChatGPT ou a outro aplicativo de IA compatível e passa a perguntar em linguagem natural: *"quantos produtos eu tenho?"*, *"me mostre os últimos pedidos"*, *"quais clientes compraram acima de R$ 1.000?"*.

Nos bastidores, ele usa o **MCP (Model Context Protocol)** — um padrão aberto que permite diferentes IAs se conectarem à sua loja com segurança. Por isso funciona em vários aplicativos de IA, não só em um.

## Como funciona

Você pergunta em linguagem natural → o assistente entende, busca os dados **da sua loja** e responde. Você pode encadear perguntas que ele continua o raciocínio:

1. *"Liste os produtos da minha loja."*
2. *"E desses, quais estão sem estoque?"*
3. *"Monte uma tabela com SKU e preço."*

Pense nele como um **analista de dados da sua loja**: ele lê, cruza informações de vários lugares (produtos, pedidos, clientes...) e explica — tudo a partir de uma conversa.

{% hint style="info" %}
**O assistente consulta&#x20;*****e*****&#x20;altera a sua loja.**

Além de **consultar, cruzar e explicar** os dados, o assistente também **executa ações** por você — sempre pedindo **confirmação** antes de mudar algo.

**O que dá para consultar:** listar, buscar, comparar, resumir e analisar produtos, pedidos, clientes, cupons, departamentos, newsletter, webhooks e informações da loja.

**O que dá para alterar:** editar produtos e ajustar estoque; mudar o status de um pedido (inclusive cancelar), informar código de rastreio e nota fiscal; cadastrar e editar departamentos, cupons, inscritos da newsletter e webhooks.

**A única coisa que ele&#x20;*****não*****&#x20;faz é excluir.** Nenhum registro é apagado pelo assistente — cadastros e edições sim, exclusões não.
{% endhint %}

## O que você precisa

* Ser o dono da loja e ter o **login de acesso** (Loja, Login e Senha do painel).
* Um aplicativo de IA compatível com conectores MCP (ex.: Claude ou ChatGPT). Alguns exigem plano pago — veja os detalhes na página de instalação.

Pronto para conectar?

{% content-ref url="/pages/79HYKHeJB2eE2YGxwf2y" %}
[Instalação e Ativação](/assistente-ia-mcp/instalacao-e-ativacao.md)
{% endcontent-ref %}
