Skip to main content

​
Como funciona

O Testly MCP conecta o Claude Code diretamente à sua conta Testly. Em vez de abrir o dashboard para criar um experimento, você descreve o que quer testar e o Claude cria, retorna o código pronto e você cola no seu projeto. 
Você → Claude Code → Testly MCP → Supabase
                         ↓
              Experimento criado + código gerado

​
Instalação

​
1. Pegue sua API Key

Acesse app.testly.com.br/settings e copie sua API Key (tk_live_...).

​
2. Adicione o MCP ao Claude Code

claude mcp add testly -e TESTLY_API_KEY=tk_live_... -- npx @testlyjs/mcp
Pronto. Não precisa instalar nada globalmente — o npx cuida disso automaticamente.

​
3. Verifique

Abra o Claude Code e peça: 
Liste meus experimentos do Testly

​
Uso

Com o MCP configurado, você faz tudo em linguagem natural:

Criar experimento

“Crie um teste A/B para o botão do hero”

Ver resultados

“Qual variante está ganhando no meu teste do hero?”

Listar ativos

“Liste todos os meus experimentos rodando”

Controlar

“Pause o experimento pricing-test”

​
Exemplo completo

Fluxo real de criar e integrar um teste A/B sem sair do editor: 1. Você diz ao Claude: 
Crie um teste A/B chamado "Hero CTA Color" para testar se um botão verde 
converte mais que o azul. O evento de conversão é "cta_clicked".
2. Claude cria o experimento via MCP e responde: 
✅ Experimento criado: "Hero CTA Color"

Key: hero-cta-color
Variantes: control, variant-b
Dashboard: app.testly.com.br/experiments/hero-cta-color

── Integração ──

1. npm install @testlyjs/react

2. <TestlyProvider apiKey={process.env.TESTLY_API_KEY}>
     <App />
   </TestlyProvider>

3. const { variant, convert } = useExperiment('hero-cta-color');

   if (variant === 'variant-b') {
     // botão verde
   }

   // no clique:
   convert('cta_clicked');
3. Claude escreve o código no seu arquivo automaticamente.

​
Ferramentas disponíveis

FerramentaO que faz
create_experimentCria experimento e retorna código de integração
list_experimentsLista todos os experimentos com status e impressões
get_resultsRetorna taxa de conversão, uplift e veredito estatístico
start_experimentInicia um experimento pausado
stop_experimentPausa um experimento ativo

​
Configuração avançada

​
Apontar para staging

claude mcp add testly \
  -e TESTLY_API_KEY=tk_live_... \
  -e TESTLY_API_URL=https://dmfxwugjxevbrpuzgeqb.supabase.co/functions/v1/manage-experiments \
  -- npx @testlyjs/mcp

​
Via arquivo .mcp.json (compartilhar com o time)

Crie .mcp.json na raiz do seu projeto: 
{
  "mcpServers": {
    "testly": {
      "command": "npx",
      "args": ["@testlyjs/mcp"],
      "env": {
        "TESTLY_API_KEY": "tk_live_..."
      }
    }
  }
}
Não comite .mcp.json com a API Key. Use variáveis de ambiente ou adicione ao .gitignore.