Conectar o produto
Do que está em produção ao que precisa mudar.
Conectar em um clique
GitHub, Vercel, Supabase, Linear, Notion, Google Analytics e Search Console conectam com um botão: em Configurações → Integrações, clique em Conectar, autorize na ferramenta e volte. Nenhum token, nenhum campo para preencher. Depois, escolha os recursos que entram no produto e importe.
O Clarko lê o que está em produção: repositórios, deployments, projetos e páginas. Ele nunca escreve nas suas ferramentas.
Quando não há botão: o prompt pronto
Microsoft Clarity e PostHog não oferecem autorização em um clique. Para eles, o Clarko mostra “Copiar prompt”: um texto completo, já com o nome do seu produto, o endereço exato da página onde o token é gerado, o que copiar e onde colar de volta. Cole no Claude (ou em outro assistente com navegador) e ele faz tudo; ou siga os três passos à mão.
Ao colar o token, o Clarko valida na hora e diz o que encontrou. Um token errado explica em uma frase o que está errado. O mesmo caminho existe para o script de analytics e para os webhooks do GitHub e da Vercel, com URL e segredo já preenchidos no prompt.
Permissões e controle
A leitura de projetos e deployments permite importar contexto. A escrita permite criar projetos e deployments para as publicações confirmadas. O acesso ao usuário atual e à configuração da integração identifica a conta e a instalação autorizadas.
Para interromper a conexão, use Desconectar em Conexões e remova a integração nas configurações da Vercel. As fontes já importadas ficam no produto até serem excluídas. Revogar acesso não apaga projetos ou deployments já publicados na Vercel.
Analytics e consentimento de cookies
Em Configurações → Analytics, gere a chave do produto e cole o snippet antes do fechamento do <head>. Ele registra pageviews, cliques e os eventos que você envia com clarko('track'), e identifica pessoas e contas com clarko('identify') e clarko('group'). Nunca lê o que foi digitado em campos.
Se o seu site pede consentimento de cookies (LGPD), marque “Só depois do consentimento de cookies”: o snippet recebe data-consent="required" e fica em silêncio, sem gravar nem enviar nada, até o banner chamar clarko('consent'). O aceite fica guardado no navegador, então a chamada só precisa acontecer uma vez; clarko('consent', false) revoga e apaga os identificadores.
O Microsoft Clarity, conectado em Conexões com o ID do projeto e um token de Data Export, segue o mesmo consentimento: clarko('consent') avisa o Clarity (consentv2) e clarko('identify') espelha o identificador para o Clarity. O Clarko lê a frustração por tela uma vez por dia e o botão “Ver gravações” abre o painel do Clarity na rota da tela.
Resolver problemas
Se um recurso não aparecer, confira se sua conta tem acesso a ele e se ele foi incluído na autorização. Se a sessão expirar, reconecte a ferramenta. Limites de uso, permissões da organização e revisões pendentes dos provedores podem restringir uma conexão.
Para pedir ajuda, escreva para makeitclear.studio@gmail.com com o nome da ferramenta, a ação que tentou e a mensagem de erro. Não envie senhas, tokens ou segredos.