Pular para o conteúdo principal

Use sua IA com os dados da sua loja

Peça ao Claude, ao ChatGPT ou a outra IA para consultar seus aparelhos, preços e etapas do Funil no iLojista. A conexão só lê: não muda nada nem conversa com seus clientes.

MCP é a conexão que permite à sua IA consultar esses dados com sua autorização. Ela é separada da IA que atende seus clientes no WhatsApp e no Instagram.

Comece com um pedido

Depois de conectar, escreva um destes pedidos na conversa com sua IA:

  • Liste os iPhones disponíveis na minha loja, com preço e saúde da bateria.
  • Compare os iPhones 15 do catálogo por armazenamento, preço e valor de troca.
  • Mostre as etapas do meu Funil, na ordem em que aparecem no iLojista.

Conecte no seu assistente de IA

Abra as configurações de conectores ou integrações da sua IA e escolha adicionar um servidor MCP remoto. Os nomes dos menus e a disponibilidade dependem do aplicativo e da sua conta.

Dê à conexão o nome iLojista e cole o endereço abaixo no campo de servidor. Não cole uma chave na conversa.

Inicie a conexão. Sua IA abre app.ilojista.com.br/conectar. Entre na sua conta como dono da loja. Confira a loja, o nome do app e o endereço para onde você vai voltar. Só então clique em Conectar.

Volte à conversa com sua IA e faça um dos pedidos acima. Se o aplicativo não aceitar servidores MCP remotos com autorização pelo navegador, use outro cliente compatível ou peça ajuda a quem programa.

Endereço do servidor MCP
https://api.ilojista.com.br/mcp

O que você permite

A conexão pelo navegador permite ler o Catálogo inteiro e os nomes das etapas do Funil de uma única loja: a que você confirmou na autorização. Inclui os preços cadastrados, mesmo se você desligou a opção de falar preços no atendimento.

Ela não lê contatos, conversas ou horários livres. Não altera preços, não move clientes no Funil, não marca visitas e não envia mensagens. O atendimento pelo WhatsApp e Instagram continua como você configurou no iLojista.

Os dados consultados chegam ao aplicativo de IA que você escolheu. Confira a política de privacidade desse aplicativo antes de conectar.

Como o iLojista trata conexões de IA

Desconecte quando quiser

No app do iLojista, abra Configurações → Integrações → Chaves de acesso. Localize a chave com o nome do assistente e apague. Só o dono da loja pode fazer isso.

A próxima chamada já é recusada. Apagar a conexão só no assistente não substitui apagar a chave no iLojista. Isso corta novas consultas, mas não apaga o que a outra IA já recebeu.

Abrir Integrações no app

A conexão não funcionou?

  • Não abriu a autorização? Confira se o aplicativo aceita MCP remoto e se o endereço termina em /mcp. Refaça a conexão nas configurações da sua IA.
  • Você não é dono da loja? Peça ao dono para conectar na própria conta. Não compartilhe a senha nem a chave dele.
  • A loja já tem 10 chaves ativas? Apague uma conexão que não usa mais em Configurações → Integrações e tente de novo.
  • A assinatura não está ativa? Renove no app do iLojista e tente consultar de novo.
  • A IA não encontrou um aparelho? Confira o Catálogo no iLojista e peça uma nova consulta. O MCP não lê planilhas ou conversas fora do Catálogo.

Para quem programa

Servidor e autorização

O servidor https://api.ilojista.com.br/mcp usa Streamable HTTP. Não há instalação local nem transporte stdio. A autorização pelo navegador usa OAuth com PKCE e entrega uma chave com catalog:read e crm:read. As chamadas MCP exigem Authorization: Bearer, inclusive a inicialização.

Para um cliente que aceita cabeçalhos, o dono pode criar uma chave em Configurações → Integrações → Chaves de acesso. Escolha catalog:read, crm:read ou ambos. A chave começa com ilojista_ e aparece inteira uma vez. Guarde-a como segredo e envie-a no cabeçalho, nunca em um prompt ou na URL.

Metadados de autorização OAuth

Metadados do recurso MCP

Faça a primeira chamada

Defina ILOJISTA_API_KEY no seu ambiente com a chave criada no app. Esta chamada lista o Catálogo. O JSON de resposta tem a lista no campo data.

Terminal
curl https://api.ilojista.com.br/v1/catalog/items \
  -H "Authorization: Bearer $ILOJISTA_API_KEY"

Duas operações, na API e no MCP

API é o endereço que seu código chama para consultar os dados. A referência OpenAPI descreve os campos e as respostas e pode ser aberta sem chave. As duas ferramentas MCP não recebem argumentos e só aparecem se a chave tiver a permissão correspondente.

  • list_catalog_items: GET /v1/catalog/items, com catalog:read. Lista aparelhos e produtos, incluindo os vendidos. Traz nome, categoria, priceInCents, descrição, durationMinutes, tradeValueInCents, condition, storageGb, color, batteryHealth, status e datas de criação e atualização.
  • Preços e valores de troca vêm em centavos: 549000 é R$ 5.490,00. condition é seminovo ou lacrado, storageGb é a capacidade em GB e batteryHealth é a saúde da bateria de 0 a 100. Esses campos podem ser null. durationMinutes é o tempo da visita. status é available ou sold.
  • list_crm_stages: GET /v1/crm/stages, com crm:read. Lista as etapas em ordem, com id, nome, cor, posição e tipo: open, won ou lost. Não traz contatos nem quantidade de clientes por etapa.
  • As listas vêm inteiras, sem paginação. O MCP e a API executam as mesmas operações e respeitam as mesmas permissões.

Abrir a referência OpenAPI

Conecte um terminal sem navegador

Peça um código com o client_id ilojista-agent. O dono abre app.ilojista.com.br/conectar/codigo em outro aparelho, confere o código e aprova. Ele vale por 10 minutos. Guarde o device_code retornado em DEVICE_CODE e consulte o token no intervalo indicado pela resposta, sem repetir mais rápido.

Autorização por código
curl https://api.ilojista.com.br/oauth/device_authorization \
  -d client_id=ilojista-agent \
  -d resource=https://api.ilojista.com.br/mcp

curl https://api.ilojista.com.br/oauth/token \
  -d client_id=ilojista-agent \
  -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
  -d "device_code=$DEVICE_CODE"

Limites e erros

Cada loja pode ter até 10 chaves ativas. Cada chave permite até 100 chamadas de ferramenta ou operação por minuto. A API também limita pedidos por endereço de origem.

A chave é conferida a cada chamada. Apagá-la, desativar quem a criou, encerrar a loja ou ficar sem assinatura ativa impede novas consultas. Nenhum endpoint público permite escrever dados.

  • 401: falta a chave, ela está errada ou foi apagada. Confira o cabeçalho e crie outra chave no app se necessário.
  • 403: falta uma permissão, quem criou a chave perdeu acesso ou a loja foi encerrada. Peça ao dono para conferir o acesso no app. Se a resposta for PAYMENT_REQUIRED, renove a assinatura.
  • 429: o limite de chamadas foi atingido. Respeite Retry-After antes de tentar de novo. No MCP, o erro da ferramenta informa quantos segundos esperar.