Adicione o servidor MCP do Storelift ao Claude Code

Como este guia foi verificado

Documentação do Claude Code: code.claude.com.

Versão

Este guia descreve o servidor que está no ar: storelift-mcp 1.1.1 no npm (2026-09-14) e o endpoint hospedado https://storelift.net/mcp, os dois com as mesmas 8 ferramentas: get_ai_visibility, get_charts, get_history, get_keywords, get_reviews, get_rivals, get_store_page, list_apps.

Todas as ferramentas desta versão são de leitura; nenhuma altera nada na sua conta. O servidor local responde por stdio com a versão 2024-11-05 do protocolo, e o endpoint hospedado, por Streamable HTTP com a 2025-06-18; o endpoint é sem estado: não usa id de sessão nem stream enviado pelo servidor.

Requisitos

• Plano. O acesso por MCP exige o plano Pro, Studio ou Enterprise, tanto com chave de API quanto com login (OAuth).
• Chave. Storelift → Configurações → Chaves de API. A chave começa com sl_live_. Nesta versão as chaves não têm escopos: uma chave lê todos os apps do workspace dela. Guarde-a só na configuração do cliente.
• Ambiente. Node.js 18 ou mais recente para o servidor local (o npx baixa o pacote na primeira execução). O endpoint hospedado não exige instalar nada.
• Claude Code. Qualquer versão recente; os comandos abaixo vêm de claude mcp add --help e da documentação de MCP do Claude Code.

Configuração

Servidor local com chave de API (rode no diretório do projeto; o escopo padrão é só este projeto):

claude mcp add storelift -e STORELIFT_API_KEY=sl_live_... -- npx -y storelift-mcp

Ou o endpoint hospedado, sem nada para instalar, com a chave em um cabeçalho:

claude mcp add --transport http storelift https://storelift.net/mcp --header "Authorization: Bearer sl_live_..."

Para fazer login (OAuth) em vez de usar uma chave, adicione o endpoint sem cabeçalho e depois rode /mcp dentro do Claude Code:

claude mcp add --transport http storelift https://storelift.net/mcp

Confira a conexão com claude mcp list; a linha deve mostrar ✔ Connected.

Primeira leitura

Pergunte: “Liste meus apps do Storelift e depois mostre as posições das palavras-chave do primeiro nos EUA.” O assistente chama primeiro list_apps e depois get_keywords para o app que você escolher. A resposta de list_apps é assim (dados de exemplo do Storelift, 2026-09-28; a sua conta devolve os seus próprios apps):

{
  "apps": [
    {
      "id": "sbx-lumen",
      "name": "Lumen — Sleep Sounds",
      "countries": [
        "us",
        "gb",
        "de"
      ],
      "keywords": [
        "sleep sounds",
        "white noise",
        "rain sounds"
      ]
    }
  ]
}

get_keywords devolve uma linha por palavra-chave acompanhada:

{
  "country": "us",
  "platform": "ios",
  "keywords": [
    {
      "term": "sleep sounds",
      "measured": true,
      "rank": null,
      "demand": 73,
      "searchDepth": 200
    },
    {
      "term": "white noise",
      "measured": true,
      "rank": 57,
      "demand": 37,
      "searchDepth": 200
    }
  ]
}

Um número em rank é a posição; null significa que a palavra-chave foi medida e o app não está nos resultados; measured: false significa que não foi possível medir. Os três ficam separados: contar um dia sem medição como zero dá uma resposta errada.

A conexão funciona. A seguir, três primeiras tarefas: quais palavras-chave caíram, quem está à frente nelas e o que dizer quando uma palavra-chave não tem medição hoje, cada uma com a resposta esperada.

Remover o acesso

1. Rode claude mcp remove storelift. Em uma conexão por login, o Claude Code também apaga os tokens que guardou; /mcp → Clear authentication faz o mesmo sem remover o servidor.
2. Apague a chave em Storelift → Configurações → Chaves de API. A próxima requisição com essa chave é recusada (um erro de ferramenta no servidor local, HTTP 401 no endpoint hospedado); não há sessão aberta para esperar expirar.
3. Se você conectou com login (OAuth), remova a conexão em Configurações → API → Apps conectados; o token dessa conexão recebe um 401 na próxima requisição.

Solução de problemas

Leia também