# Adicione o servidor MCP do Storelift ao Cursor

URL: https://storelift.net/pt/guide/storelift-mcp-cursor/
Language: pt
Updated: 2026-10-13

Os passos para conectar o servidor MCP do Storelift ao Cursor; a versão, os requisitos e as respostas de erro foram medidos no próprio servidor.

## Como este guia foi verificado

NOTE: Como isto foi verificado (2026-10-11). O lado do servidor foi medido com o storelift-mcp 1.1.1: handshake, lista de ferramentas, chamadas de leitura, respostas de erro e remoção do acesso. Visto no Cursor: cursor-agent 2025.09.17-25b418f · stdio, chave de API: conecta, lista as 8 ferramentas. Uma chamada de ferramenta de dentro do Cursor não foi testada; os passos abaixo seguem a documentação do próprio Cursor.

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

| O que você vê | Por quê | O que fazer |
| --- | --- | --- |
| “No API key was sent…” | O servidor local iniciou sem chave. As ferramentas ainda aparecem na lista, mas toda chamada devolve isto. | Adicione STORELIFT_API_KEY à configuração do servidor e reinicie o cliente. |
| “This API key is not valid…” | A chave foi digitada errado ou foi apagada. O endpoint hospedado responde HTTP 401. | Crie uma chave nova em Configurações → Chaves de API e troque a que está na configuração. |
| “The Public API is available on the Pro and Studio plans…” | O plano da conta não libera o acesso por MCP (HTTP 403). Nesta versão o acesso está em Pro, Studio ou Enterprise. | Faça upgrade em storelift.net/pricing; a chave é mantida e volta a funcionar assim que o plano permitir. |
| “fetch failed…” | O servidor local não conseguiu chegar ao Storelift: rede, proxy ou firewall. | Confira se esta máquina alcança https://storelift.net; defina STORELIFT_API só se você recebeu um endpoint diferente. |
| O endpoint hospedado pede login mesmo com um cabeçalho Authorization configurado | O Cursor CLI 2025.09.17 não enviou o cabeçalho configurado ao conectar, então o endpoint respondeu 401 e pediu login. | Use o servidor local (a chave vai em env) ou faça login. |