Servidor MCP e API REST
Seus dados de ASO dentro do seu assistente de IA
O servidor MCP do Rankglass permite que o Claude Code, o Cursor, o Claude Desktop, o Codex, o app ChatGPT para desktop e outros clientes MCP leiam suas palavras-chave monitoradas, posições, concorrentes e pontuações da página. Uma API REST entrega os mesmos dados aos seus próprios scripts.
Em resumo
- Endpoint MCP
https://app.rankglass.com/api/mcp- Transporte
- Streamable HTTP
- Autenticação
- Uma chave de API do espaço de trabalho, enviada como Authorization: Bearer YOUR_API_KEY
- Acesso
- Somente leitura
- Planos
- Starter, Pro e Agency
- Limites de requisições
- 60 requisições por minuto e 2.000 por dia por chave
Funciona com clientes MCP que conseguem enviar um cabeçalho
O Rankglass verifica uma chave de API em cada requisição, então o cliente só precisa enviá-la no cabeçalho. Estes clientes estão configurados abaixo:
- Claude Code
- Cursor
- Claude Desktop, via mcp-remote (exige Node.js)
- Codex e o app ChatGPT para desktop
- Outros clientes MCP e agentes que você cria, com o endpoint e o cabeçalho acima
Um cliente que só se conecta por login OAuth não consegue enviar a chave, então ainda não pode adicionar o Rankglass.
Configure em três passos
Passo 1
Crie uma chave de API
No Rankglass, abra Configurações → Espaço de trabalho → API e MCP e crie uma chave. Ela aparece só uma vez, então copie na hora. Uma chave lê um espaço de trabalho; crie uma por assistente ou script para poder revogar cada uma separadamente.
Passo 2
Adicione o Rankglass ao seu assistente
Cole a configuração do seu cliente e substitua YOUR_API_KEY pela sua chave.
Claude Code
Execute isto em um terminal. Com --scope user, o Rankglass fica disponível em todos os seus projetos.
claude mcp add --transport http --scope user rankglass https://app.rankglass.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"Cursor e outros clientes
No Cursor, adicione isto a ~/.cursor/mcp.json, ou a .cursor/mcp.json em um projeto. Outros clientes guardam os servidores MCP nas próprias configurações; o endpoint e o cabeçalho são tudo de que precisam.
{ "mcpServers": { "rankglass": { "url": "https://app.rankglass.com/api/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }Claude Desktop
Adicione isto a claude_desktop_config.json (Settings → Developer → Edit Config) e reinicie o Claude. Ele executa o mcp-remote com npx, então o Node.js precisa estar instalado.
{ "mcpServers": { "rankglass": { "command": "npx", "args": [ "-y", "mcp-remote", "https://app.rankglass.com/api/mcp", "--header", "Authorization:${RANKGLASS_AUTH}" ], "env": { "RANKGLASS_AUTH": "Bearer YOUR_API_KEY" } } } }Codex e o app ChatGPT para desktop
Adicione isto a ~/.codex/config.toml, compartilhado pela Codex CLI, pela extensão Codex para IDE e pelo app ChatGPT para desktop. Coloque sua chave, sem Bearer, em uma variável de ambiente chamada RANKGLASS_API_KEY.
[mcp_servers.rankglass] url = "https://app.rankglass.com/api/mcp" bearer_token_env_var = "RANKGLASS_API_KEY"Clientes que não conseguem definir o cabeçalho Authorization podem enviar x-api-key: YOUR_API_KEY no lugar.
Passo 3
Pergunte com suas palavras
Seu assistente escolhe a ferramenta certa. Nenhuma delas pode alterar nada no seu espaço de trabalho.
O que seu assistente pode ler
11 ferramentas somente leitura. Cada uma tem um endpoint GET correspondente na API REST.
| Ferramenta MCP | O que retorna | Endpoint REST |
|---|---|---|
list_apps | Seus apps com as lojas, os países monitorados, o número de palavras-chave e os principais números da semana. Uma boa primeira chamada. | GET /v1/apps |
get_keyword_rankings | Todas as palavras-chave monitoradas de um app em uma loja e um país: posição, variação em 7 dias, entrada ou saída dos resultados, melhor posição, buscas mensais estimadas, dificuldade e posições dos concorrentes. | GET /v1/keywords |
get_rank_changes | Os maiores ganhos e perdas de posição dos últimos dias, em todas as palavras-chave, lojas e países, e as palavras-chave que entraram ou saíram do top 10. | GET /v1/rank-changes |
get_competitors | Concorrentes seguidos com as avaliações, em quantas palavras-chave cada lado está mais bem posicionado e as palavras-chave em que um concorrente está no top 10 e você não. | GET /v1/competitors |
get_competitor_keywords | As palavras-chave para as quais um concorrente ranqueia em um país, inclusive as que você ainda não monitora, com buscas mensais, dificuldade e as duas posições. | GET /v1/competitor-keywords |
get_competitor_insights | Os dados de loja de um concorrente, avaliações por estrelas, posições nas paradas, downloads e receita mensais estimados e o resumo de resenhas com IA mais recente. | GET /v1/competitor-insights |
get_competitor_growthBeta | Como um concorrente conquista usuários: anúncios, contas em redes sociais, criadores de conteúdo, busca na loja e site, com gasto com anúncios, instalações vindas de anúncios e alcance nas redes sociais estimados, e a estratégia de IA mais recente. Pro e Agency. | GET /v1/competitor-growth |
get_store_page_changes | Alterações recentes nas suas páginas da loja e nas dos concorrentes: título, subtítulo, descrição, capturas de tela, versão e notas da versão. | GET /v1/store-page-changes |
get_aso_score | Sua pontuação de ASO de 0 a 100 para uma loja e um país, as verificações por trás dela, ganhos rápidos de palavras-chave e as sugestões de IA mais recentes para a página. | GET /v1/aso-score |
get_weekly_brief | O briefing semanal mais recente do seu app: o que mudou, os motivos prováveis e até três coisas a fazer em seguida. | GET /v1/weekly-brief |
get_keyword_game_planBeta | O plano de ação mais recente de uma palavra-chave monitorada: a posição-alvo e até cinco passos para chegar lá. | GET /v1/keyword-game-plan |
API REST
Os mesmos dados em JSON para seus scripts, painéis e planilhas. Cada endpoint é uma requisição GET em https://app.rankglass.com/api/v1 e usa a mesma chave.
Uma primeira requisição: as maiores variações de posição dos últimos sete dias.
curl "https://app.rankglass.com/api/v1/rank-changes?days=7" -H "Authorization: Bearer YOUR_API_KEY"Limites e acesso
- Somente leitura. As ferramentas e os endpoints só leem o que o Rankglass já armazenou; nunca iniciam uma nova busca. Trabalhos pagos, como encontrar as palavras-chave de um concorrente em um novo país, são iniciados no painel.
- Cada chave pode fazer 60 requisições por minuto e 2.000 por dia, compartilhadas entre o servidor MCP e a API REST. Acima disso, as requisições recebem uma resposta 429 com o cabeçalho Retry-After.
- O acesso à API e ao MCP vem com os planos Starter, Pro e Agency. Sem ele, as requisições recebem uma resposta 403.
- Uma chave lê tudo no espaço de trabalho dela, então trate-a como uma senha. A página de configurações mostra quando cada chave foi usada pela última vez, e você pode revogá-la ali.
Perguntas para testar
- Quais das minhas palavras-chave caíram esta semana?
- Em que posição meu app está para “habit tracker” na Alemanha, e quem está acima de mim?
- Para quais palavras-chave meu principal concorrente ranqueia que eu ainda não monitoro?
- O que meus concorrentes mudaram nas páginas da loja neste mês?
- Qual é minha pontuação de ASO no Reino Unido, e o que devo corrigir primeiro?
- Resuma o briefing desta semana de cada um dos meus apps.
Perguntas sobre o servidor MCP
Funciona com o ChatGPT?
Sim, no app ChatGPT para desktop. Ele compartilha os servidores MCP com a Codex CLI e a extensão Codex para IDE em ~/.codex/config.toml, que consegue enviar sua chave a partir de uma variável de ambiente (bearer_token_env_var); a configuração acima mostra como. O ChatGPT na web adiciona ferramentas por conectores que só oferecem login OAuth, e esses ainda não conseguem enviar a chave. Qualquer coisa que chame uma API com um cabeçalho pode usar a API REST no lugar.
Meu assistente pode alterar algo no Rankglass?
Não. Todas as ferramentas e endpoints só leem. Adicionar apps, monitorar palavras-chave e iniciar buscas acontece no painel.
Com que frequência os dados são atualizados?
Com a mesma frequência do painel: nos planos pagos, cada palavra-chave monitorada é verificada uma vez por dia, e o briefing semanal é escrito toda segunda-feira. As ferramentas leem o que o Rankglass armazenou e nunca iniciam uma verificação.
Para onde vão meus dados?
Só para o cliente que os pede, e só do espaço de trabalho ao qual a chave pertence. A partir daí, o provedor do seu assistente os trata segundo os próprios termos. Exclua a chave para interromper o acesso a qualquer momento.
Prefere um passo a passo? Leia como configurar o servidor MCP do Rankglass.
Descubra o próximo passo para o seu app
Adicione seu app com um link da loja e veja sua posição hoje.
Começar grátisPlano Gratuito · Sem cartão de crédito · Cancele quando quiser