> 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/instalacao-e-ativacao.md).

# Instalação e Ativação

Conectar sua loja ao assistente leva poucos minutos. O processo é parecido em todos os aplicativos: você adiciona um **conector** informando a URL abaixo e autoriza com o login da sua loja.

## A URL do conector

```
https://admin-mcp.toplojas.com.br
```

{% hint style="warning" %}
Conectores personalizados costumam exigir um **plano pago** do aplicativo de IA (por exemplo, planos pagos do Claude ou do ChatGPT). No plano gratuito, a opção de adicionar um conector pode não aparecer.
{% endhint %}

## Escolha o seu aplicativo

O passo a passo muda um pouco em cada aplicativo. Siga o guia do que você usa:

{% content-ref url="/pages/GwOvoOEuxyOAVBIoyIXj" %}
[Conectar no Claude](/assistente-ia-mcp/instalacao-e-ativacao/conectar-no-claude.md)
{% endcontent-ref %}

{% content-ref url="/pages/l19rZNX8YZvEow5fNdL8" %}
[Conectar no ChatGPT](/assistente-ia-mcp/instalacao-e-ativacao/conectar-no-chatgpt.md)
{% endcontent-ref %}

As seções abaixo (**login na loja**, **confirmação** e **solução de problemas**) valem para qualquer aplicativo.

## Fazendo login na sua loja

Em todos os aplicativos, a autorização acontece numa tela da **própria Toplojas**, aberta no seu navegador. Primeiro você informa **Loja, Login e Senha**:

![](/files/PauwPenqsig17GS8VH34)

Depois, confira as **permissões concedidas** — de **leitura** (`GET`) e de **escrita** (`POST` para cadastrar, `PUT` para editar). O assistente **não recebe permissão de exclusão**. Clique em **Autorizar**:

![](/files/llsBsAjPeJS4uy8r6gB4)

Alguns pontos importantes:

* Você usa as **mesmas credenciais do painel** (Loja, Login e Senha).
* **Nenhum token é colado manualmente** — o login cuida disso para você.
* O assistente **nunca vê a sua senha**: ela fica só no navegador, na tela da Toplojas.
* O acesso é **limitado a essa loja** e pode ser **revogado a qualquer momento**.

## Confirme que funcionou

Depois de conectar, faça um teste simples. Peça ao assistente:

> *"Liste os produtos da minha loja."*

Se ele retornar dados reais da sua loja, está tudo certo. 🎉

Você também pode pedir análises mais elaboradas — o assistente busca os dados e monta a resposta. Por exemplo:

> *"Crie um gráfico que mostra os estados com mais vendas em 2025."*

No Claude:

![](/files/GFWfcYAvx6tBmHUPymw6)

O mesmo pedido no ChatGPT:

![](/files/oEa8mhBscSSAYlNNbd7O)

Veja mais ideias em [O que pedir](/assistente-ia-mcp/o-que-pedir.md).

## Solução de problemas

| Situação                                             | O que fazer                                                                     |
| ---------------------------------------------------- | ------------------------------------------------------------------------------- |
| Não aparece a opção de adicionar conector            | Verifique se o seu plano do aplicativo de IA permite conectores personalizados. |
| Erro ao fazer login                                  | Confira **Loja, Login e Senha** — são os mesmos do painel da sua loja.          |
| O assistente pede para reconectar depois de um tempo | A sessão expirou. Basta reconectar/autorizar novamente com o seu login.         |

Agora que está conectado, veja tudo o que dá para pedir:

{% content-ref url="/pages/BErSemrf6qLdSlbTJ2ln" %}
[O que pedir](/assistente-ia-mcp/o-que-pedir.md)
{% endcontent-ref %}