Convertlyft

Análise web que aponta a solução: funis, gravações de sessão, cliques de raiva, formulários, erros, velocidade e SEO.

Servidor MCP hospedado

npx add-mcp 'https://mcp.convertlyft.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Conecte uma IA ao servidor MCP da Convertlyft

A Convertlyft é um servidor MCP remoto para análise web. Qualquer cliente MCP pode ler os números, sessões, erros e SEO do seu site. Com um token de acesso pessoal que permita, ele também pode propor alterações para você aprovar.

https://mcp.convertlyft.com/mcp

Esse é o endereço completo: MCP remoto via Streamable HTTP, nada para instalar ou executar no seu computador. Ele fala os protocolos MCP versões 2025-11-25, 2025-06-18 e 2025-03-26. Algumas ferramentas funcionam antes de você entrar, via MCP: a verificação de SEO gratuita de qualquer site público, a verificação de prontidão para agentes a partir dessa verificação e uma busca nestes documentos. Tudo sobre o seu próprio site pede que você entre uma vez, no seu navegador. A API REST sempre exige um token.

Um comando: npx convertlyft init

Ele encontra as ferramentas de IA no seu computador (Claude Code, Cursor, VS Code, Windsurf, Zed, Gemini CLI, Cline, Codex e Goose), mostra o que mudaria e então adiciona o servidor Convertlyft e suas habilidades a cada uma que você concordar. Você entra uma vez no seu navegador. Node 18 ou mais recente.

npx convertlyft init

npx convertlyft init --dry-run    # show what would change, change nothing
npx convertlyft init --no-skills  # add the server only

Prefere fazer manualmente? Cada cliente está abaixo.

Aplicativos de chat: cole o endereço

claude.ai

Abra Customize → Connectors.
Pressione + Add e depois Add custom connector.
Dê o nome Convertlyft, cole https://mcp.convertlyft.com/mcp e pressione Continue.
Mantenha as configurações de entrada que o Claude detectar e pressione Add. Quando o Claude precisar dos seus dados pela primeira vez, seu navegador abrirá a Convertlyft: entre, escolha o site e pressione Allow.

Os passos acima no claude.ai, 15 segundos, sem som.

No plano gratuito, o Claude permite um conector personalizado. Passos do artigo de ajuda do Claude.

Claude Desktop

Os mesmos passos, em Customize → Connectors do próprio aplicativo. Um servidor remoto como este é adicionado lá, não em claude_desktop_config.json, que é para servidores que rodam no seu computador.

Claude no celular

Adicione o conector no claude.ai ou no Claude Desktop primeiro. Nas palavras do Claude: "Depois que você se conectar a um serviço no Claude ou no Claude Desktop, ele estará disponível na próxima vez que você entrar na sua conta no Claude para iOS ou Android."

ChatGPT

Abra ChatGPT Plugins, pressione Add e depois Add custom MCP server.
Digite um nome e uma descrição e cole https://mcp.convertlyft.com/mcp como endpoint público.
Escolha OAuth para autenticação, revise o aviso, pressione I understand and want to continue e depois Create as a plugin.

Os passos acima no ChatGPT, 15 segundos, sem som.

Servidores MCP personalizados no ChatGPT dependem do seu plano e do modo de desenvolvedor, que a OpenAI controla e vem renomeando. Passos do guia da OpenAI; as regras do plano estão no artigo de ajuda da OpenAI.

Instalação com um clique

Cada botão abre o aplicativo e pede sua confirmação. Ele adiciona https://mcp.convertlyft.com/mcp e nada mais; a primeira chamada então abre seu navegador para você entrar.

Adicionar ao Cursor Adicionar ao VS Code Adicionar ao VS Code Insiders Adicionar ao Goose

Ou escreva o arquivo você mesmo.

Cursor ·.cursor/mcp.json ou ~/.cursor/mcp.json

{
  "mcpServers": {
    "convertlyft": {
      "url": "https://mcp.convertlyft.com/mcp"
    }
  }
}

VS Code ·.vscode/mcp.json

{
  "servers": {
    "convertlyft": {
      "type": "http",
      "url": "https://mcp.convertlyft.com/mcp"
    }
  }
}

Agentes de codificação e editores

Claude Code

claude mcp add --transport http convertlyft https://mcp.convertlyft.com/mcp

Depois execute /mcp em uma sessão para entrar.

Windsurf

mcp_config.json · a documentação do Windsurf agora fica no Devin Desktop

{
  "mcpServers": {
    "convertlyft": {
      "serverUrl": "https://mcp.convertlyft.com/mcp"
    }
  }
}

Zed

settings.json · o Zed pede que você entre quando nenhum cabeçalho Authorization estiver definido

{
  "context_servers": {
    "convertlyft": {
      "url": "https://mcp.convertlyft.com/mcp"
    }
  }
}

JetBrains AI Assistant

Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add → HTTP

{
  "mcpServers": {
    "convertlyft": {
      "url": "https://mcp.convertlyft.com/mcp"
    }
  }
}

Gemini CLI

~/.gemini/settings.json · httpUrl, não url: no Gemini CLI, url significa o transporte SSE mais antigo

{
  "mcpServers": {
    "convertlyft": {
      "httpUrl": "https://mcp.convertlyft.com/mcp"
    }
  }
}

Ou: gemini mcp add --transport http convertlyft https://mcp.convertlyft.com/mcp

Cline

cline_mcp_settings.json · defina type: sem ele, o Cline usa o transporte SSE mais antigo

{
  "mcpServers": {
    "convertlyft": {
      "type": "streamableHttp",
      "url": "https://mcp.convertlyft.com/mcp"
    }
  }
}

Codex

codex mcp add convertlyft --url https://mcp.convertlyft.com/mcp
codex mcp login convertlyft

# or in ~/.codex/config.toml
[mcp_servers.convertlyft]
url = "https://mcp.convertlyft.com/mcp"

Habilidades e plugins

As habilidades ensinam sua IA a ler as evidências da Convertlyft: qual ferramenta chamar, em que ordem e o que os números podem e não podem dizer. São 21, públicas em github.com/Convertlyft/skills.

Plugin do Claude Code

O servidor MCP, todas as habilidades e uma verificação que pergunta antes de sua IA registrar um marcador de alteração na linha do tempo do seu site (cvl_change_apply, que não edita seu site) ou iniciar uma execução de operador (cvl_operator_run).

/plugin marketplace add Convertlyft/skills
/plugin install convertlyft@convertlyft

Plugin do Codex

O servidor MCP e todas as habilidades, sem a verificação acima.

codex plugin marketplace add Convertlyft/skills
codex plugin add convertlyft@convertlyft

O Cursor também lê o mesmo repositório como um mercado de plugins.

Qualquer agente que leia habilidades

Codex, Cursor, Gemini CLI, GitHub Copilot e outros. Isso adiciona apenas as habilidades; adicione o servidor com os passos acima.

npx skills add Convertlyft/skills
# or, from this website
npx skills add https://convertlyft.com

IAs conectadas também podem ler todas as habilidades como um recurso MCP em convertlyft://skills/, ou escolher uma nos prompts do servidor, sem entrar. Dois dos prompts guiam uma IA pela instalação da tag Convertlyft e pelo diagnóstico de uma instalação.

Escolha quais ferramentas carregar

Sua IA carrega todas as ferramentas que recebe antes de ler sua primeira mensagem, então o endereço acima carrega um conjunto principal: as leituras iniciais, as ferramentas sem conta, todas as ferramentas que escrevem algo e quatro auxiliares. cvl_search_tools encontra qualquer outra ferramenta, cvl_call_read executa uma ferramenta de leitura pelo nome, e cvl_skills_list e cvl_skill_read listam e abrem as habilidades. Para carregar grupos inteiros de antemão, adicione ?features= ao endereço:

Grupo	Adiciona
`behaviour`	sessões, gravações, cliques de raiva e mortos, atrito em formulários, funis, caminhos, mapas de calor, feed ao vivo
`seo`	rankings, palavras-chave, concorrentes, backlinks, auditoria do site, visibilidade em assistentes de IA
`errors`	grupos de erros, um erro completo, o resumo da correção
`site`	páginas rastreadas e seu conteúdo, velocidade da página, status do rastreamento, verificação da tag
`workspace`	seus sites, contas conectadas, o quadro, propostas, memória, recomendações
`all`	tudo

https://mcp.convertlyft.com/mcp?features=behaviour,seo

Para dar a uma IA apenas leituras, use o endereço abaixo. Ele não lista nenhuma ferramenta que escreve e recusa uma se for chamada mesmo assim.

https://mcp.convertlyft.com/mcp?read_only=true

Entrada e tokens

A maioria dos clientes entra pelo seu navegador: entre, escolha o site e pressione Allow. Leituras são permitidas por padrão; iniciar rastreamentos e fazer alterações de SEO ficam desativados a menos que você os marque.

Clientes que não podem entrar pelo navegador podem enviar um token de acesso pessoal como Authorization: Bearer …; crie um na página do Desenvolvedor no aplicativo. Mantenha-o em uma variável de ambiente ou no cofre de segredos do seu cliente, nunca em um arquivo que você envie para o repositório.

claude mcp add --transport http convertlyft https://mcp.convertlyft.com/mcp \
  --header "Authorization: Bearer $CONVERTLYFT_TOKEN"

# Codex, in ~/.codex/config.toml
[mcp_servers.convertlyft]
url = "https://mcp.convertlyft.com/mcp"
bearer_token_env_var = "CONVERTLYFT_TOKEN"

Um token serve para ambos: um token da entrada ou um token de acesso pessoal é aceito pelo servidor MCP e pela API REST igualmente, para o único site para o qual foi criado.

Uma credencial dura 90 dias; depois seu cliente entra novamente. Não há token de atualização. Uma entrada é listada em Connected apps no aplicativo, onde você pode revogá-la.

Para construtores de clientes: o servidor publica seus metadados OAuth em /.well-known/oauth-authorization-server. Ele suporta registro dinâmico de clientes e documentos de metadados de ID de cliente, e exige PKCE com S256.

Limites

Quem	Por minuto	Por dia
Cada token de acesso pessoal	120 chamadas	20.000 chamadas
Sem conta, por endereço (as ferramentas MCP sem conta)	20 chamadas	200 chamadas e 5 novas verificações

Uma chamada é uma solicitação; initialize e tools/list contam cada uma. Acima do limite, a resposta é HTTP 429 nomeando o limite atingido. Respostas que contam contra um limite trazem X-RateLimit-Requests-Limit, -Remaining e -Reset, e cvl_whoami lê seu uso atual. Uma verificação de um site já verificado nas últimas 24 horas reutiliza esse resultado e não conta como uma nova verificação.

Ferramentas sem código

Elas se conectam como clientes MCP. Use o endereço acima e, onde a ferramenta não tiver entrada pelo navegador, um token de acesso pessoal como token de portador.

Zapier: adicione o aplicativo MCP Client (beta). URL do servidor https://mcp.convertlyft.com/mcp, Transport Streamable HTTP, depois OAuth ou seu token em Bearer Token. As ações incluem Run Tool e Run Read-Only Tool. Guia do Zapier.
n8n: o nó MCP Client Tool para um agente de IA, ou o nó independente MCP Client. Endpoint https://mcp.convertlyft.com/mcp, Server Transport HTTP Streamable, Authentication Bearer Auth ou MCP OAuth2. Documentação do n8n.
Make: o módulo Call a tool do aplicativo MCP Client. Adicione o servidor por URL e dê seu token como token de acesso. Documentação do Make.

Scripts

Toda ferramenta de leitura também é uma chamada HTTP simples: GET https://convertlyft.com/api/tools/<name>, argumentos na string de consulta, seu token no cabeçalho. Os exemplos práticos cobrem datas, cotas e erros. O documento OpenAPI lista os endpoints das ferramentas em /api/tools/; a lista de capacidades cobre o resto da API REST, como iniciar um rastreamento e ler suas páginas.

curl

curl -s "https://convertlyft.com/api/tools/cvl_whoami" \
  -H "Authorization: Bearer $CONVERTLYFT_TOKEN"

Python (biblioteca padrão)

import json, os, urllib.request

req = urllib.request.Request(
    "https://convertlyft.com/api/tools/cvl_whoami",
    headers={"Authorization": "Bearer " + os.environ["CONVERTLYFT_TOKEN"]},
)
print(json.load(urllib.request.urlopen(req)))

JavaScript (Node 18+)

const res = await fetch("https://convertlyft.com/api/tools/cvl_whoami", {
  headers: { Authorization: \`Bearer ${process.env.CONVERTLYFT_TOKEN}\` },
});
console.log(await res.json());

Google Apps Script · mantenha o token em Script Properties

function whoami() {
  const token = PropertiesService.getScriptProperties().getProperty("CONVERTLYFT_TOKEN");
  const res = UrlFetchApp.fetch("https://convertlyft.com/api/tools/cvl_whoami", {
    headers: { Authorization: "Bearer " + token },
  });
  Logger.log(res.getContentText());
}

O próprio MCP, sem token: liste as ferramentas

curl -s https://mcp.convertlyft.com/mcp \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

CI

Crie um token de acesso pessoal na página do Desenvolvedor com apenas os escopos que o trabalho precisa, armazene-o como um segredo de CI chamado CONVERTLYFT_TOKEN e chame a API REST ou o servidor MCP com ele como acima.

Entrada sem cabeçalho (código de dispositivo, RFC 8628)

A API também tem um fluxo de código de dispositivo, para uma máquina sem navegador. O passo 1 pede um código:

curl -s -X POST https://convertlyft.com/api/tokens/device/code \
  -H "content-type: application/json" \
  -d '{"client_id":"my-ci-job","scopes":["reports:read","sessions:read"]}'
# → {"device_code","user_code","verification_uri","verification_uri_complete","expires_in","interval"}

Passo 2: uma pessoa abre verification_uri (https://convertlyft.com/app/device, ou verification_uri_complete com o código preenchido), entra, verifica se o código corresponde a user_code, escolhe o site e pressiona Allow. Os códigos duram dez minutos e funcionam uma vez. O passo 3 consulta a cada interval segundos até o token chegar:

curl -s -X POST https://convertlyft.com/api/tokens/device/token \
  -H "content-type: application/json" \
  -d '{"device_code":"<device_code>","client_id":"my-ci-job"}'
# → 400 {"error":"authorization_pending"} until approved, then
# → 200 {"access_token":"cvl_pat_…","token_type":"bearer","scope":"…"}

Consultar mais rápido que interval responde slow_down com um intervalo maior; use-o. Uma recusa na página responde access_denied, e um código deixado por muito tempo responde expired_token. O token é somente leitura, a menos que a pessoa marque uma escrita na página, dura 90 dias e é listado em Connected apps, onde pode ser revogado.

Equipes e empresas

Claude Team e Enterprise: um proprietário adiciona o conector uma vez em Organization settings → Connectors (Add → Custom → Web, depois o endereço acima). Cada membro então o encontra em Customize → Connectors e pressiona Connect, o que os conecta à Convertlyft como eles mesmos. Artigo de ajuda do Claude.
ChatGPT Business e Enterprise: administradores do espaço de trabalho criam o aplicativo nas configurações do espaço de trabalho e o publicam para os membros. O artigo de ajuda da OpenAI tem os passos atuais para cada plano.

Cada pessoa que se conecta entra e escolhe um site, então vê apenas os sites aos quais pertence.

Verificações gratuitas para construtores de agentes

O mesmo rastreador que alimenta o servidor MCP executa três verificações gratuitas em qualquer site público, sem conta:

O verificador WebMCP: teste as ferramentas WebMCP que suas próprias páginas expõem, com um guia em linguagem simples para adicioná-las.
A verificação gratuita de prontidão para agentes (robots.txt por agente de IA, llms.txt, arquivos de agente).
A auditoria de SEO gratuita, sem conta: até 16 páginas, com o que a verificação não pôde checar.

Para rastreadores e registros

ConvertlyftBot: o crawler por trás das auditorias, seu user agent e como desacelerá-lo ou bloqueá-lo.
/.well-known/ai-catalog.json e /.well-known/mcp/server-card.json: o cartão do servidor MCP (SEP-2127).
A lista de capacidades: cada ferramenta e os escopos que ela necessita.
/.well-known/skills/index.json: as habilidades, para npx skills add https://convertlyft.com.
llms.txt e llms-full.txt: o guia da API para um modelo.