A base de lojas no seu assistente de IA

Claude (web e desktop)

Conecta com login (OAuth).

1. Em Configurações → Conectores, clique em Adicionar conector personalizado.
2. Dê um nome (ecommercebase) e cole a URL do servidor: https://ecommercebase.com.br/api/mcp
3. Clique em Conectar: abre a tela de login da ecommercebase. Entre, escolha a organização e autorize.
4. Numa conversa, ative o conector ecommercebase e pergunte sobre as lojas.

ChatGPT

Conecta com login (OAuth).

1. Em Configurações → Aplicativos e conectores, ative o modo desenvolvedor (Avançado) e crie um conector.
2. Cole a URL do servidor: https://ecommercebase.com.br/api/mcp e escolha autenticação OAuth.
3. Entre na ecommercebase, escolha a organização e autorize.

Claude Code

Conecta com login (OAuth).

1. Rode o comando abaixo e, no Claude Code, use /mcp para entrar com a sua conta.

claude mcp add --transport http ecommercebase https://ecommercebase.com.br/api/mcp

Cursor

Usa uma chave da API.

1. Crie uma chave em Integrações → API e ponha no arquivo .cursor/mcp.json (do projeto) ou ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ecommercebase": {
      "url": "https://ecommercebase.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer eb_live_SUA_CHAVE"
      }
    }
  }
}

Outros clientes (chave da API)

Usa uma chave da API.

1. Clientes que aceitam servidor HTTP com cabeçalho: use a URL e o cabeçalho Authorization com a chave.
2. Clientes que só rodam servidores locais (stdio): use a ponte mcp-remote, como no exemplo.

{
  "mcpServers": {
    "ecommercebase": {
      "type": "http",
      "url": "https://ecommercebase.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer eb_live_SUA_CHAVE"
      }
    },
    "ecommercebase-stdio": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ecommercebase.com.br/api/mcp",
        "--header",
        "Authorization: Bearer eb_live_SUA_CHAVE"
      ]
    }
  }
}

buscar_lojas · Buscar lojas

Lista lojas virtuais do Brasil que atendem aos filtros (plataforma, uf, cidade, segmento, pagamento, porte, status, apps, dados da empresa…), paginado. Devolve domínio, nome, plataforma, cidade/UF, porte, status, segmento e pagamentos. Não gasta cota.

contar_lojas · Contar lojas

Total de lojas de um recorte e a contagem por plataforma, UF, pagamento, porte, status, segmento e marketplace (cada um com os outros filtros aplicados). Use para dimensionar um mercado. Não gasta cota.

ficha_loja · Ficha da loja

Ficha completa de uma loja pelo domínio: pagamentos, parcelas, frete, apps, catálogo e preços, contato da loja, CNPJ, contato nominal e dados públicos da empresa. Gasta 1 da cota de lojas na primeira leitura da loja em 12 meses (reler não gasta).

opcoes_de_filtro · Opções de filtro

Valores aceitos em cada filtro das outras ferramentas; segmentos e apps vêm com o número de lojas. Use antes de buscar para acertar os valores. Não gasta cota.

listar_mudancas · Mudanças nas lojas

Mudanças registradas nas lojas de um recorte num período (app que entrou ou saiu, troca de gateway, lançamentos, catálogo, faixa de preço, loja nova, fora do ar, troca de plataforma). Plano Business. Não gasta cota.