> 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**:

![](https://1882612469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MObfj7Rt58mdIJ_2Oby%2Fuploads%2Fgit-blob-05376285a6e70faa0e39c40ea64bd54bcade2958%2Fmcp-oauth-login.png?alt=media)

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**:

![](https://1882612469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MObfj7Rt58mdIJ_2Oby%2Fuploads%2Fgit-blob-5c3dd769ccf951750b9ab8bc422eb67ea003baa1%2Fmcp-oauth-autorizar.png?alt=media)

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:

![](https://1882612469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MObfj7Rt58mdIJ_2Oby%2Fuploads%2Fgit-blob-f3f5860101aec975286ea9595c43a1d1c7a4dcd9%2Fmcp-claude-exemplo.png?alt=media)

O mesmo pedido no ChatGPT:

![](https://1882612469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MObfj7Rt58mdIJ_2Oby%2Fuploads%2Fgit-blob-b519164cddddf7fff19459b3117793a83b3cd86a%2Fmcp-chatgpt-exemplo.png?alt=media)

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 %}