> For the complete documentation index, see [llms.txt](https://ajuda.uplaces.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.uplaces.com.br/agentes-de-ia.md).

# Agentes de IA: Claude e ChatGPT na loja

Conecte o Claude, o ChatGPT, o Cursor ou o Claude Code à sua loja Uplaces e configure produtos, preços e cupons por conversa, com simulação e histórico.

Peça por conversa e o agente configura a loja. Conecte o Claude, o ChatGPT, o Cursor, o Claude Code, o n8n ou um agente seu à sua loja Uplaces. Ele cadastra produtos, ajusta preços, cria cupons e consulta pedidos, e você revisa a simulação antes de gravar.

A conexão usa um servidor MCP, o padrão que os aplicativos de IA usam para falar com outros sistemas. Você não precisa entender o padrão: basta colar um endereço no aplicativo e aprovar o acesso. Cada conexão vale para uma loja, com as permissões e o prazo que você escolher, e tudo o que o agente fizer fica no histórico, com o antes e o depois.

Os Agentes de IA são um módulo diferente da [Uplaces IA](/uplaces-ai.md). A Uplaces IA monta pedidos a partir da mensagem do cliente; os Agentes de IA servem para você configurar e consultar a loja por conversa.

{% hint style="info" %}
Os Agentes de IA fazem parte do módulo **Agentes de IA**, que depende do plano da loja. Se o card aparecer em **Módulos** com cadeado e a etiqueta **Fora do seu plano**, fale com o suporte. O que cada plano inclui está nos [planos da Uplaces](https://uplaces.com.br/planos-industrias-e-distribuidoras/).
{% endhint %}

## Para que serve

* Cadastrar o catálogo sem digitar: anexe a planilha na conversa e peça o cadastro dos produtos.
* Corrigir cadastro em lote: achar os produtos sem foto, sem preço ou sem NCM e atualizar estoque e preços por tabela.
* Montar promoções e descontos: criar cupons, destaques e regras de desconto pedindo em português.
* Consultar a operação: listar clientes de uma cidade, ver a política comercial de cada um e os pedidos mais recentes.
* Automatizar com n8n ou um agente próprio: a mesma conexão aceita chave de acesso, com permissões por área e prazo.

Veja receitas prontas em [Agentes de IA: o que pedir ao agente](/agentes-de-ia/o-que-pedir.md).

## O que você precisa

Você precisa de:

* Ser administrador da loja na Uplaces. O agente age com as suas permissões e nunca com mais.
* O módulo **Agentes de IA** ligado em **Módulos**. Ao ligar, o item **Agentes de IA** aparece no menu.
* Uma conta no aplicativo que vai conectar (Claude, ChatGPT, Cursor ou outro). Conectores personalizados dependem do plano e das configurações dessa conta; confira na ajuda do próprio aplicativo.

1. Abra **Módulos**.
2. No grupo **Inteligência**, localize **Agentes de IA** e ligue o interruptor.
3. Abra **Agentes de IA** no menu.

## O endereço do servidor

O endereço é o mesmo para todas as lojas. Quem decide em qual loja o agente trabalha é a conexão que você aprova:

```
https://mcp.admin.uplaces.com.br/api/mcp
```

Você também encontra o endereço, com botão de copiar, em **Como conectar**, no alto da tela **Agentes de IA**.

Os dois jeitos de conectar:

| Jeito                       | Para quem                                          | Como funciona                                                                      |
| --------------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Conexão de 1 clique (OAuth) | Claude, ChatGPT, Cursor, VS Code                   | Você cola o endereço, aprova na tela da Uplaces e pronto. Não há chave para copiar |
| Chave de acesso             | Claude Code, Claude Desktop, n8n, servidor próprio | Você cria a chave na Uplaces e cola na configuração do agente                      |

Os dois seguem as mesmas regras e aparecem na mesma lista, com o mesmo histórico.

{% hint style="warning" %}
Se a janela **Como conectar**, na tela **Agentes de IA**, avisar que o conector de 1 clique no Claude.ai e no ChatGPT ainda não está disponível, use a chave de acesso (seção 6), que funciona no Claude Code, no Claude Desktop, no Cursor, no VS Code, no n8n e em servidores próprios.
{% endhint %}

## Conectar no Claude (1 clique)

1. No Claude, abra a área de conectores e adicione um conector personalizado.
2. Dê o nome Uplaces e cole o endereço do servidor.
3. Conecte. O Claude abre a tela de login da Uplaces. Entre com o seu usuário de administrador da loja.
4. Na tela de aprovação, que tem o título "Conectar Claude à sua loja", escolha:
   * a **Loja**;
   * as **Permissões**, por área, marcando **Ler** e **Alterar**;
   * por quanto tempo a conexão vale, em **A conexão vale por**.
5. Confira o endereço para onde a tela diz que você vai voltar. Para o Claude, ele deve ser o do próprio Claude.
6. Clique em **Permitir acesso**.
7. De volta ao Claude, abra uma conversa, ative o conector **Uplaces** e faça o primeiro pedido (veja a seção 7).

{% hint style="info" %}
A tela já vem marcada com o que o aplicativo pediu. Dê só o que a tarefa precisa. Para começar, marque **Ler** em todas as áreas e **Alterar** só em **Produtos**.
{% endhint %}

{% hint style="warning" %}
Se você não reconhece o endereço de retorno na tela de aprovação, clique em **Recusar**. O nome do aplicativo é declarado por ele mesmo, e o endereço é o que mostra para onde a aprovação vai.
{% endhint %}

## Conectar no ChatGPT (1 clique)

1. No ChatGPT, abra a área de conectores e crie um conector personalizado.
2. Dê o nome Uplaces, cole o endereço do servidor e escolha a autenticação **OAuth**.
3. Salve e conecte. O ChatGPT abre a tela de login da Uplaces.
4. Faça login, escolha a **Loja**, as **Permissões** e o prazo, e clique em **Permitir acesso**. Os passos são os mesmos da seção anterior.
5. Em uma conversa, ative o conector **Uplaces** e faça o primeiro pedido.

## Conectar no Cursor ou no VS Code

Com OAuth: adicione a Uplaces como servidor HTTP, só com o endereço, e aprove na tela da Uplaces, como nas seções anteriores.

Com chave: crie a chave (veja a seção 6) e coloque no arquivo de configuração:

* Cursor: arquivo `.cursor/mcp.json`
* VS Code: arquivo `.vscode/mcp.json`, usando `servers` no lugar de `mcpServers`

```json
{ "mcpServers": { "uplaces": {
    "url": "https://mcp.admin.uplaces.com.br/api/mcp",
    "headers": { "Authorization": "Bearer SUA_CHAVE" } } } }
```

Troque `SUA_CHAVE` pela chave que você copiou ao criar.

## Conectar com chave: Claude Code, Claude Desktop, n8n e servidor próprio

1. Abra **Agentes de IA** e clique em **Nova chave** (na primeira vez, o botão se chama **Criar chave e conectar**). Escolha o nome, o acesso e a validade, e clique em **Criar chave**. O passo a passo completo está em [Agentes de IA: chaves, permissões e histórico](/agentes-de-ia/chaves-permissoes-e-historico.md).
2. Copie a chave. Ela aparece uma única vez.
3. Escolha o seu cliente abaixo e cole a chave na **configuração do agente**, nunca dentro da conversa.

No Claude Code (terminal):

```bash
claude mcp add --transport http uplaces https://mcp.admin.uplaces.com.br/api/mcp \
  --header "Authorization: Bearer SUA_CHAVE"
```

No Claude Desktop (arquivo `claude_desktop_config.json`, com o pacote `mcp-remote`):

```json
{ "mcpServers": { "uplaces": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.admin.uplaces.com.br/api/mcp",
             "--header", "Authorization: Bearer ${UPLACES_MCP_KEY}"],
    "env": { "UPLACES_MCP_KEY": "SUA_CHAVE" } } } }
```

No n8n, no nó **MCP Client**, use o transporte **HTTP Streamable**, informe o endereço do servidor e, na autenticação, **Bearer** com a chave.

Teste rápido pelo terminal (lista as ferramentas disponíveis para a chave):

```bash
curl https://mcp.admin.uplaces.com.br/api/mcp \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

Quando o agente fizer a primeira chamada, a tela da chave mostra **Conectado** e você pode começar a pedir.

## Seu primeiro pedido ao agente

**Como fazer:**

1. **Comece lendo.** Peça algo que não altera nada: "Quais produtos ativos estão sem foto ou sem preço?"
2. **Peça uma alteração pequena, com simulação.** Por exemplo: "Simule a criação do cupom BEMVINDO com 10% de desconto, válido a partir de amanhã, sem gravar."
3. **Leia a simulação.** O agente mostra o que mudaria. Nada foi gravado.
4. **Confirme.** Se estiver certo, diga: "Pode gravar."
5. **Confira no histórico.** Abra **Agentes de IA** e veja o bloco **Atividade dos agentes**. A simulação aparece como **simulação**, e a gravação como **gravou**, com o antes e o depois.

{% hint style="info" %}
Peça sempre "simule antes de gravar". Toda alteração aceita simulação. As exclusões exigem confirmação explícita do agente.
{% endhint %}

## O que dá para pedir

O agente faz o que a chave permite: cada chave enxerga só as áreas que recebeu e os módulos ligados na sua loja. Alguns exemplos de pedidos:

* "Quais produtos ativos estão sem foto, sem preço, sem NCM ou sem categoria?"
* "Cadastre os produtos desta planilha na categoria Limpeza."
* "Crie o cupom BEMVINDO com 10% de desconto, válido a partir de amanhã."
* "Liste os 10 pedidos mais recentes, com o cliente e a situação."

A lista completa, com a permissão que cada pedido exige, está em [Agentes de IA: o que pedir ao agente](/agentes-de-ia/o-que-pedir.md). Na Uplaces, clique em **O que o agente pode fazer**, no alto da tela **Agentes de IA**, para ver as ações disponíveis na sua loja, agrupadas por área.

Peça uma coisa por vez e dê o nome exato do que quer mudar (código do produto, nome da tabela, código do cupom). Quanto mais claro o pedido, menos o agente precisa perguntar.

## O que o agente não faz

* **Não cria nem altera pedidos.** Ele só consulta. Pedidos entram pelo aplicativo, pela loja ou pela API.
* **Não alcança credenciais de pagamento.** Chaves de gateway, chave Pix e conta de recebimento só se alteram pela tela, por uma pessoa.
* **Não tem mais poder que você.** Se a pessoa que criou a conexão perder o acesso à loja, a conexão para junto.
* **Não trabalha com o módulo desligado.** Enquanto **Agentes de IA** estiver desligado em **Módulos**, nenhuma conexão funciona.

## Desconectar

**Como fazer:**

1. Abra **Agentes de IA**.
2. Na tabela **Chaves de acesso**, localize a conexão. As conexões de 1 clique aparecem como **conector OAuth**.
3. Clique em **Revogar** e confirme em **Confirmar revogação**. O acesso termina na hora.

Para ter certeza de que o acesso acabou, revogue também na Uplaces, mesmo que você remova o conector no Claude ou no ChatGPT. Veja mais em [Agentes de IA: chaves, permissões e histórico](/agentes-de-ia/chaves-permissoes-e-historico.md).

## Perguntas frequentes

<details>

<summary>O agente pode apagar produtos?</summary>

As ferramentas de hoje não excluem produtos. As poucas exclusões que existem exigem confirmação explícita e aparecem no histórico.

</details>

<details>

<summary>O agente fala com os meus clientes?</summary>

Não. As ferramentas não enviam mensagem a clientes.

</details>

<details>

<summary>Para onde vão os dados que o agente lê?</summary>

Os dados lidos passam pelo serviço de IA que você escolheu, como Claude, ChatGPT ou Cursor. Confira a política de privacidade e as configurações de treino do plano que você usa nesse serviço.

</details>

<details>

<summary>Preciso do Claude ou do ChatGPT pago?</summary>

Depende do plano da sua conta nesses aplicativos. Confira na ajuda do próprio aplicativo.

</details>

<details>

<summary>O que é um servidor MCP?</summary>

É o padrão que Claude, ChatGPT, Cursor e outros aplicativos de IA usam para se conectar a sistemas externos. O endereço da Uplaces funciona como esse servidor: o aplicativo se conecta, você aprova, e ele passa a poder consultar e configurar a loja dentro das permissões que você deu.

</details>

<details>

<summary>Funciona com o n8n?</summary>

Funciona. Crie uma chave em **Agentes de IA** e use o nó **MCP Client** do n8n com o endereço do servidor e a chave como Bearer.

</details>

<details>

<summary>Posso conectar mais de um agente?</summary>

Pode. Crie uma chave (ou uma conexão) para cada agente, com um nome claro, como "Claude, catálogo". A loja tem um limite de chaves ativas. Se chegar nele, a tela pede para revogar as que você não usa.

</details>

## Não conectou?

Confira nesta ordem:

1. **O módulo está ligado?** Em **Módulos**, o card **Agentes de IA** precisa estar ativo.
2. **Você é administrador da loja?** Se não for, a tela de aprovação diz: "Você não é administrador de nenhuma loja. Peça a um administrador para fazer a conexão."
3. **O endereço está completo?** Ele termina em `/api/mcp`, sem espaço no fim.
4. **A conta da loja está ativa?** Conta suspensa ou bloqueada não conecta agentes. Fale com o suporte.
5. **A chave foi copiada inteira?** Ela começa com `upl_mcp_`. Se não copiou, revogue e crie outra.
6. **A chave venceu ou foi revogada?** A coluna **Expira** mostra **expirou** ou **revogada**. Crie outra chave.
7. **A chave tem lista de IPs?** Se o agente roda num servidor com IP diferente, a chamada é recusada. Veja a coluna **Expira**, que mostra **IP restrito**.
8. **O agente parou no meio de uma tarefa grande?** Cada chave tem limite de chamadas e de alterações por minuto. O agente recebe o tempo de espera e deve aguardar.
9. **Nada resolveu?** Veja o bloco **Atividade dos agentes**, na tela **Agentes de IA**: a linha recusada diz o motivo.

## Veja também

* [Agentes de IA: o que pedir ao agente](/agentes-de-ia/o-que-pedir.md)
* [Agentes de IA: chaves, permissões e histórico](/agentes-de-ia/chaves-permissoes-e-historico.md)
* [Pedidos com IA para vendas B2B: a Uplaces IA](/uplaces-ai.md)
* No site: [IA para vendas B2B](https://uplaces.com.br/ia-para-vendas-b2b/) e [integrações](https://uplaces.com.br/integracoes/)

{% hint style="success" %}
**Ainda não usa a Uplaces?** Teste grátis por 10 dias, sem cartão de crédito, com o app de vendas, a loja B2B e a integração com o ERP. Os Agentes de IA fazem parte dos planos maiores: veja os [planos](https://uplaces.com.br/planos-industrias-e-distribuidoras/). [Começar o teste grátis](https://b2b.admin.uplaces.com.br/login?cadastro\&utm_source=ajuda\&utm_medium=cta\&utm_campaign=central-de-ajuda)
{% endhint %}