Conexão api e-com.plus e Claude

APIs e SDKs
#1

E-Com Plus para Claude

Gerencie sua loja inteira conversando com o Claude. Consulte pedidos, atualize estoque, analise vendas, encontre clientes e muito mais — tudo em linguagem natural, direto no Claude Desktop.

Sem dashboards complicados. Sem exportar planilhas. Sem abrir dezenas de abas. Você pergunta, o Claude responde e age como nesse exemplo.

image
image1005×750 46.4 KB

image
image1370×783 64.3 KB

Pré-requisito

Passo a passo

1. Instalar o mcp-remote

No terminal do seu computador executar o seguinte comando:

npm install -g mcp-remote

2. Configurar o Claude Desktop

Abra (ou crie) o arquivo de configuração do Claude Desktop:

  • Windows: C:\Users\<seu-usuario>\AppData\Roaming\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Adicione o seguinte trecho logo após a primeira chave “{”, sendo usuário de windows, atenção para colocar o nome do seu usuário em SEU-SUSUÁRIO.

Windows



  "mcpServers": {
    "ecomplus": {
      "command": "C:\\Users\\SEU-SUSUÁRIO\\AppData\\Roaming\\npm\\mcp-remote.cmd",
      "args": ["https://ai.ecomplus.io/api/mcp"]
    }
  },

macOS / Linux


  "mcpServers": {
    "ecomplus": {
      "command": "mcp-remote",
      "args": ["https://ai.ecomplus.io/api/mcp"]
    }
  },

Crie um usuário exclusivo para a integração em app.e-com.plus/#/resources/authentications/new. Não use as credenciais de um usuário existente.

3. Reiniciar o Claude Desktop e autenticar

Feche e abra o Claude Desktop novamente.

Na primeira conexão, o Claude vai abrir uma janela no navegador com o formulário de login da E-Com Plus.

  • Se a sua loja usa a API V1 mantenha o toggle em API V1 e entre com usuário e senha.

  • Se a sua loja usa a API V2 selecione API V2 no toggle antes de entrar.

Após autenticar, o conector ecomplus aparece ativo em Conectores na barra de composição.

image

Depurar erros

Se o conector não aparecer ou apresentar mensagem de erro antes ou após o login, verifique o log do MCP no terminal do seu computador (com o Claude aberto) com o seguinte comando:

Get-Content "$env:APPDATA\Claude\logs\mcp-server-ecomplus.log" -Tail 50

Cole o conteúdo do log em uma conversa com o Claude e peça ajuda — ele identificará o problema e instruirá como seguir.

Trocar de loja

A sessão fica ativa por 30 dias. Para conectar uma loja diferente antes desse prazo, é preciso limpar o cache local do mcp-remote e refazer o login.

Windows — execute no PowerShell com o Claude fechado:


Remove-Item -Recurse -Force "$env:USERPROFILE\.mcp-auth" -ErrorAction SilentlyContinue

macOS / Linux — execute no terminal com o Claude fechado:


rm -rf ~/.mcp-auth

Depois abra o Claude novamente. O formulário de login será exibido automaticamente para você autenticar com a nova loja.

Depois abra o Claude novamente. O formulário de login será exibido automaticamente para você autenticar com a nova loja.

Exemplos de uso

Com o conector ativo, basta perguntar em linguagem natural:

Oportunidade de kits e bundles


Nos pedidos pagos dos últimos 3 meses, quais pares de produtos aparecem

juntos com mais frequência? Quero identificar combinações para criar

kits ou sugestões de "compre junto".

Risco de ruptura de estoque


Cruza os 20 produtos mais vendidos em junho com o relatório de estoque crítico.

Me diz quais desses produtos têm menos de 10 unidades em estoque e quanto

tempo de vendas isso representa com base no ritmo atual.

Clientes VIP em risco de churn


Pega os 30 clientes que mais compraram em 2024 e verifica quais deles

não fizeram nenhum pedido nos últimos 90 dias. Retorna nome, e-mail, telefone

e data do último pedido para eu montar uma campanha de reativação.

Pedidos pagos parados sem envio


Liste todos os pedidos com pagamento confirmado (status paid) criados

antes de [data - 5 dias] que ainda não têm código de rastreamento nem

status de envio. Agrupa por data de criação, do mais antigo para o mais novo.

Receita perdida com cancelamentos e reembolsos


Em maio, quanto deixei de faturar por causa de pedidos cancelados, estornados

ou reembolsados? Compara esse valor com o faturamento efetivo (paid) do mesmo

período e me diz qual é a taxa de perda.

Análise de sazonalidade mês a mês


Compara o faturamento semana a semana de maio e junho deste ano.

Aponta quais semanas tiveram queda e sugere se algum evento ou

feriado pode ter influenciado.

Carrinhos abandonados com alto valor


Quais são os 10 carrinhos abandonados com maior valor total?

Para cada um, me dá o nome do cliente, e-mail, os produtos que estavam

no carrinho e há quantos dias está abandonado.

Clientes recorrentes que sumiram esse mês


Quais clientes compraram nos 3 meses anteriores consecutivamente

(março, abril e maio) mas ainda não fizeram nenhum pedido em junho?

Esses são meus clientes de ciclo mensal que podem estar indo para o concorrente.
#2