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.
https://api.ilojista.com.br/mcpO 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.
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.
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.
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.
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.
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.
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.