KOLens
EntrarComeçar grátis
Claude · Custom Connector

Conecte o KOLens ao Claude

Cole uma URL na caixa Custom Connector do Claude.ai, clique em Approve uma vez e o Claude poderá buscar KOLs, pegar snapshots de audiência, espionar anúncios, gerenciar sua watchlist e alertas — tudo em linguagem natural. Usa MCP + OAuth 2.1 com PKCE; suas credenciais nunca saem do kolens.ai.

https://kolens.ai/mcp

A URL exata para colar no Claude.

Abrir o Claude.ai Leia o passo a passo completo

Configuração em 30 segundos

  1. 1

    Abra o Claude.ai e vá em Settings → Connectors.

    Disponível no Claude Pro, Team e Enterprise. Procure por Add custom connector no fim da lista de conectores.

  2. 2

    Cole https://kolens.ai/mcp e clique em Connect.

    O Claude descobre automaticamente nossos endpoints OAuth (RFC 9728/8414) e se registra dinamicamente como um cliente público (RFC 7591). Você não precisa criar uma API key nem lidar com secrets.

  3. 3

    Entre na sua conta do KOLens na página de consentimento.

    Você será redirecionado para https://kolens.ai/oauth/authorize. Não tem conta? Crie uma primeiro.

  4. 4

    Revise os scopes pedidos e clique em Approve.

    A página de consentimento lista exatamente o que o Claude está pedindo — normalmente read:kols, write:lists, run:scrape. Você pode revogar qualquer um deles em Conta → Connections a qualquer momento.

  5. 5

    Pronto — tente uma consulta.

    Abra qualquer conversa do Claude e tente uma destas:

    • “Busque KOLs de capinha de celular com mais de 50k seguidores nos EUA.”
    • “Pegue o snapshot de audiência de @creatorbeta.”
    • “Adicione @creatoralpha à minha watchlist A-list.”
    • “Marque como lidos todos os meus alertas de rising_kol.”

15 ferramentas, na hora

Descoberta

  • list_kols — Filtre KOLs por palavra-chave, número de seguidores, engajamento, região.
  • get_kol_profile — Perfil completo + vídeos recentes + informações de contato.
  • search_history — O que você (ou seu time) buscou recentemente.
  • run_scrape — Inicie um novo job de scraping por palavra-chave.

Audiência e crescimento

  • get_audience_snapshot — Distribuição por país, idioma, % de atividade, nichos top, com IC de 95%.
  • list_alerts — KOLs em ascensão + vídeos em tendência sinalizados pelo KOLens para você.
  • mark_alert_read — Dispense um alerta direto no chat.

Ad Spy

  • list_advertisers — Marcas que estão rodando Facebook Ads num nicho específico.
  • get_ad_detail — Pegue o payload completo de um anúncio — copy, criativo, datas de veiculação.
  • list_watches — Watches automáticos de ad spy que você salvou.

Listas e watchlist

  • add_to_list — Salve um KOL em uma lista nomeada para exportar depois.
  • add_to_watchlist — Acompanhe o crescimento de um KOL ao longo do tempo.
  • list_lists — Suas listas de KOLs.
  • list_watchlist — Seus KOLs acompanhados + deltas de mudança.
  • remove_from_watchlist — Pare de acompanhar um KOL.

Segurança

  • OAuth 2.1 + PKCE. Sua senha nunca sai do kolens.ai. O Claude troca um código de autorização por um access token opaco e revogável.
  • Scopes granulares. Cada ferramenta mapeia para um scope que você aprovou explicitamente. A tela de consentimento lista cada um por nome — nada de acesso escondido.
  • Revogável por aplicativo. Acesse /account/connections para ver todos os clientes conectados e revogar qualquer token com um clique (RFC 7009).
  • Sem secrets de longa duração para copiar. Os tokens expiram e renovam sozinhos. As URLs do Custom Connector podem ser compartilhadas com segurança dentro da sua organização.

Solução de problemas

Não vejo “Add custom connector” no Claude.ai.

Os Custom Connectors exigem um plano pago do Claude (Pro, Team ou Enterprise). No plano Free, a opção fica oculta. Faça upgrade em claude.ai/upgrade.

A página de consentimento mostra “Invalid client”.

O Claude registra um cliente novo a cada vez que você adiciona o conector. Se você já tinha tentado antes e o registro foi interrompido (aba fechada, etc.), remova o conector incompleto em Claude.ai → Settings → Connectors e adicione de novo. Cada registro é de uso único.

O Claude diz que não vê as ferramentas do KOLens depois de conectar.

Atualize a conversa do Claude ou comece uma nova — o Claude só atualiza a lista de ferramentas nos limites de uma conversa. Se ainda assim não aparecerem, confira em /account/connections se a conexão está ativa.

A URL https://kolens.ai/mcp retorna 404 quando acesso direto.

É esperado. /mcp só responde a POST com corpo JSON-RPC — não há nada para renderizar no navegador. O Claude faz o POST por baixo dos panos. Para confirmar que o endpoint está vivo, abra https://kolens.ai/.well-known/oauth-authorization-server em uma nova aba — você deverá ver um documento JSON.

Já conectou?

Gerencie e revogue os clientes Claude conectados em Conta → Connections.

Conecte o KOLens ao Claude (MCP + OAuth) — Custom Connector | KOLens