# Adicione o servidor MCP do Storelift ao Claude Code

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

Os passos para conectar o servidor MCP do Storelift ao Claude Code; 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 Claude Code: 2.1.296 · stdio, chave de API: conecta, lista as 8 ferramentas, é removido por completo com o comando de remoção; 2.1.296 · Streamable HTTP, chave de API em um cabeçalho: conecta, lista as 8 ferramentas. Uma chamada de ferramenta de dentro do Claude Code não foi testada; os passos abaixo seguem a documentação do próprio Claude Code.

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

| 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. |
| ✘ Failed to connect em claude mcp list | O servidor não iniciou (Node.js ausente ou antigo demais) ou o endpoint não respondeu a tempo. | Rode node --version; se o início for lento, aumente o tempo limite de inicialização, por exemplo MCP_TIMEOUT=10000 claude. |