Pergunte à sua IA

Conecte qualquer cliente MCP, como Claude ou Cursor, ao Runlight com um token só de leitura e pergunte sobre suas estatísticas com palavras simples.

O Runlight tem um servidor MCP embutido em /runlight/mcp, ao lado do painel. Depois de conectar um assistente de IA a ele, você pode perguntar coisas que de outra forma teria que procurar clicando, como a comparação da semana passada com a anterior, quais páginas as pessoas vindas do Google leem, o que está convertendo e se o pico de terça veio do Hacker News.

O servidor faz parte de rl.routes(), então ele roda onde quer que o seu painel rode.

Para perguntar no próprio painel, sem um app de assistente seu, use o assistente do botão do robô, que usa as mesmas ferramentas com uma chave que você adiciona nas Configurações.

Crie um token

No painel, vá em Configurações e abra API e IA. Dê ao token o nome do que vai usá-lo, como "Claude" ou "Script semanal", e crie-o. Se você acompanha vários sites, pode limitar um token a um deles.

Copie o token quando ele aparecer. O Runlight guarda só uma impressão dele, então só pode mostrar o token esta única vez. A página também preenche a configuração abaixo com o seu próprio endereço e token.

Um token de leitura, que é o que esta página cria a menos que você escolha outra coisa, nunca muda nada. Ele vê os mesmos números que o painel mostra e pode listar os links curtos com os cliques, e não pode criar nem apagar tokens, nem ver suas configurações de e-mail e links de compartilhamento. Um token de gestão fica limitado a um site e também pode mudar as metas, funis, links curtos, domínios de links, relatórios por email e links de compartilhamento desse site, além do nome, fuso horário e retenção, e obter tickets para o seletor de elementos, como descrito na API. Um servidor independente recebe um quando conecta um site, então raramente você cria um à mão. As ferramentas MCP só leem, qualquer que seja o token do assistente. Um token que você apaga no mesmo lugar para de funcionar na hora, e a lista mostra quando cada token foi usado pela última vez.

Conecte seu assistente

Em cada um destes, troque o endereço pelo seu e rl_... pelo seu token.

No Claude Code, rode este comando.

claude mcp add --transport http runlight https://example.com/runlight/mcp --header "Authorization: Bearer rl_..."

No Cursor, adicione isto a ~/.cursor/mcp.json ou ao .cursor/mcp.json de um projeto.

{
  "mcpServers": {
    "runlight": {
      "url": "https://example.com/runlight/mcp",
      "headers": { "Authorization": "Bearer rl_..." }
    }
  }
}

No VS Code, adicione isto a .vscode/mcp.json.

{
  "servers": {
    "runlight": {
      "type": "http",
      "url": "https://example.com/runlight/mcp",
      "headers": { "Authorization": "Bearer rl_..." }
    }
  }
}

O Claude Desktop se conecta pelo mcp-remote. Adicione isto a claude_desktop_config.json.

{
  "mcpServers": {
    "runlight": {
      "command": "npx",
      "args": ["mcp-remote", "https://example.com/runlight/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer rl_..." }
    }
  }
}

Qualquer outro cliente que fale MCP por Streamable HTTP e consiga enviar um cabeçalho funciona do mesmo jeito.

Conexão com OAuth

Os conectores dos apps web do Claude e do ChatGPT entram com OAuth em vez de um token colado, e o Runlight também aceita isso. Adicione o endereço do seu servidor MCP como um conector personalizado. O app leva você a uma página do Runlight que pede sua permissão, depois de você entrar se for preciso, e deixa você limitá-lo a um site. Ele então recebe um token só de leitura próprio, que aparece em Configurações, API e IA com "(OAuth)" depois do nome. Apagá-lo ali desconecta o app.

O servidor independente não precisa de mais nada. Dentro do seu próprio app, os clientes OAuth também procuram dois documentos na raiz do seu site, então roteie também /.well-known/oauth-authorization-server e /.well-known/oauth-protected-resource para o Runlight. No Next.js isso é mais um arquivo de rota.

import { rl } from "@/lib/runlight";
export const { GET, OPTIONS } = rl.routes();

O que ele consegue responder

Toda ferramenta aceita os períodos do painel (today, 7d, 30d, month, last_month, 12mo, all e os demais) ou datas. Cada uma também aceita uma comparação e filtros como channel:is:Organic Search ou page:contains:/blog. Os assistentes aprendem isso pelas descrições das ferramentas, então é só perguntar.

Aqui vão algumas coisas para experimentar.

• "Como o mês passado se compara com o anterior, e o que mais mudou?"
• "Quais posts do blog as pessoas vindas do Google leem por mais tempo?"
• "De onde vêm os visitantes que compram?"
• "Aconteceu algo fora do comum esta semana?"

Scripts

O mesmo token funciona com a API HTTP, então você pode usá-lo nos seus próprios scripts e painéis.

curl "https://example.com/runlight/api/stats?period=7d" -H "Authorization: Bearer rl_..."