Adicione o servidor MCP do Storelift ao Cursor

Como este guia foi verificado

Documentação do Cursor: cursor.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.
• Cursor. O editor e o Cursor CLI leem o mesmo mcp.json: .cursor/mcp.json em um projeto ou ~/.cursor/mcp.json para todos os projetos.

Configuração

Servidor local com chave de API: adicione isto ao .cursor/mcp.json:

{
  "mcpServers": {
    "storelift": {
      "command": "npx",
      "args": [
        "-y",
        "storelift-mcp"
      ],
      "env": {
        "STORELIFT_API_KEY": "sl_live_..."
      }
    }
  }
}

Ou o endpoint hospedado com login (OAuth): o Cursor abre o login no navegador para os servidores que pedem isso.

{
  "mcpServers": {
    "storelift": {
      "url": "https://storelift.net/mcp"
    }
  }
}

Por padrão, o Cursor pede aprovação antes de usar ferramentas MCP. Pela linha de comando, cursor-agent mcp list-tools storelift confere a conexão e lista as ferramentas com os argumentos de cada uma.

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. No Cursor, desative ou remova o servidor em Customize, ou apague a entrada storelift do mcp.json. Pelo CLI, cursor-agent mcp disable storelift impede que ele seja carregado.
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