# Conecte o Storelift ao Claude como conector personalizado

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

Os passos para conectar o servidor MCP do Storelift ao Claude; 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: claude.ai custom connector · Streamable HTTP, login: conecta, lista as 8 ferramentas. Uma chamada de ferramenta de dentro do Claude não foi testada; os passos abaixo seguem a documentação do próprio Claude.

Documentação do Claude: support.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.
- Claude. Os conectores personalizados funcionam nos planos Free, Pro, Max, Team e Enterprise do Claude; o Free é limitado a um conector personalizado e, no Team, só os Owners podem adicioná-los. Um conector adicionado no Claude também fica disponível no Claude Desktop.

## Configuração

1. No Claude, abra Customize → Connectors, clique em + Add e depois em Add custom connector. No Team e no Enterprise, um owner vai em Organization settings → Connectors → Add → Custom → Web.
2. Dê o nome Storelift, informe https://storelift.net/mcp como URL e salve.
3. Clique em Connect. O Claude leva você a uma página do Storelift que mostra o app que está pedindo acesso e o endereço para onde você volta; faça login, se for preciso, e autorize.
4. Em uma conversa nova, confira no menu de ferramentas se o Storelift está ativado: list_apps e as outras ferramentas aparecem na lista.

O Claude também permite adicionar um conector com um cabeçalho fixo (uma chave de API); com o Storelift, o login é o caminho mais curto e não há chave para copiar.

## 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 Claude, abra Customize → Connectors e escolha Remove ao lado do Storelift (no Team e no Enterprise, um owner faz isso em Organization settings).
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 |
| --- | --- | --- |
| “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. |
| Add custom connector não aparece | No plano Free do Claude o limite é um conector personalizado, e no Team só os Owners adicionam conectores. | Remova outro conector personalizado ou peça a um owner para adicionar o Storelift. |