Convertlyft

Analítica web que identifica la solución: embudos, repeticiones, clics de ira, formularios, errores, velocidad y SEO.

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

Conecta una IA al servidor MCP de Convertlyft

Convertlyft es un servidor MCP remoto para analítica web. Cualquier cliente MCP puede leer los números, sesiones, errores y SEO de tu sitio. Con un token de acceso personal que lo permita, también puede proponer cambios para que tú los apruebes.

https://mcp.convertlyft.com/mcp

Esa es la dirección completa: MCP remoto sobre Streamable HTTP, nada que instalar o ejecutar en tu computadora. Habla los protocolos MCP versiones 2025-11-25, 2025-06-18 y 2025-03-26. Algunas herramientas funcionan antes de que inicies sesión, a través de MCP: el escaneo SEO gratuito de cualquier sitio público, la verificación de preparación para agentes de ese escaneo, y una búsqueda en estos documentos. Todo lo relacionado con tu propio sitio te pedirá iniciar sesión una vez, en tu navegador. La API REST siempre requiere un token.

Un solo comando: npx convertlyft init

Encuentra las herramientas de IA en tu computadora (Claude Code, Cursor, VS Code, Windsurf, Zed, Gemini CLI, Cline, Codex y Goose), muestra lo que cambiaría, y luego añade el servidor de Convertlyft y sus habilidades a cada una con la que aceptes. Inicias sesión una vez en tu navegador. Node 18 o más reciente.

npx convertlyft init

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

¿Prefieres hacerlo a mano? Cada cliente está abajo.

Aplicaciones de chat: pega la dirección

claude.ai

Abre Personalizar → Conectores.
Pulsa + Añadir, luego Añadir conector personalizado.
Nómbralo Convertlyft, pega https://mcp.convertlyft.com/mcp y pulsa Continuar.
Mantén la configuración de inicio de sesión que Claude detecte, luego pulsa Añadir. Cuando Claude necesite tus datos por primera vez, tu navegador abrirá Convertlyft: inicia sesión, elige el sitio, pulsa Permitir.

Los pasos anteriores en claude.ai, 15 segundos, sin sonido.

En el plan gratuito, Claude permite un conector personalizado. Pasos del artículo de ayuda de Claude.

Claude Desktop

Los mismos pasos, en Personalizar → Conectores de la propia aplicación. Un servidor remoto como este se añade allí, no en claude_desktop_config.json, que es para servidores que se ejecutan en tu computadora.

Claude en tu teléfono

Añade el conector en claude.ai o en Claude Desktop primero. En palabras de Claude: "Una vez que te conectas a un servicio en Claude o Claude Desktop, estará disponible la próxima vez que inicies sesión en tu cuenta en Claude para iOS o Android".

ChatGPT

Abre Plugins de ChatGPT, pulsa Añadir, luego Añadir servidor MCP personalizado.
Introduce un nombre y una descripción, y pega https://mcp.convertlyft.com/mcp como endpoint público.
Elige OAuth para la autenticación, revisa la advertencia, pulsa Entiendo y quiero continuar, luego Crear como plugin.

Los pasos anteriores en ChatGPT, 15 segundos, sin sonido.

Los servidores MCP personalizados en ChatGPT dependen de tu plan y del modo desarrollador, que OpenAI controla y ha estado renombrando. Pasos de la guía de OpenAI; las reglas del plan están en el artículo de ayuda de OpenAI.

Instalación con un clic

Cada botón abre la aplicación y te pide confirmación. Añade https://mcp.convertlyft.com/mcp y nada más; la primera llamada abrirá tu navegador para iniciar sesión.

Añadir a Cursor Añadir a VS Code Añadir a VS Code Insiders Añadir a Goose

O escribe el archivo tú mismo.

Cursor ·.cursor/mcp.json o ~/.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 codificación y editores

Claude Code

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

Luego ejecuta /mcp en una sesión para iniciar sesión.

Windsurf

mcp_config.json · Los documentos de Windsurf ahora viven en Devin Desktop

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

Zed

settings.json · Zed te pide iniciar sesión cuando no se establece un encabezado Authorization

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

JetBrains AI Assistant

Configuración → Herramientas → AI Assistant → Model Context Protocol (MCP) → Añadir → HTTP

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

Gemini CLI

~/.gemini/settings.json · httpUrl, no url: en Gemini CLI, url significa el transporte SSE más antiguo

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

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

Cline

cline_mcp_settings.json · establece type: sin él, Cline usa el transporte SSE más antiguo

{
  "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 y plugins

Las habilidades enseñan a tu IA cómo leer la evidencia de Convertlyft: qué herramienta llamar, en qué orden, y qué pueden y no pueden decirte los números. Hay 21, públicas en github.com/Convertlyft/skills.

Plugin de Claude Code

El servidor MCP, cada habilidad, y una verificación que te pregunta antes de que tu IA registre un marcador de cambio en la línea de tiempo de tu sitio (cvl_change_apply, que no edita tu sitio) o inicie una ejecución de operador (cvl_operator_run).

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

Plugin de Codex

El servidor MCP y cada habilidad, sin la verificación anterior.

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

Cursor también lee el mismo repositorio como mercado de plugins.

Cualquier agente que lea habilidades

Codex, Cursor, Gemini CLI, GitHub Copilot y otros. Esto añade solo las habilidades; añade el servidor con los pasos anteriores.

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

Las IAs conectadas también pueden leer cada habilidad como un recurso MCP bajo convertlyft://skills/, o elegir una de los prompts del servidor, sin iniciar sesión. Dos de los prompts guían a una IA para instalar la etiqueta de Convertlyft y diagnosticar una instalación.

Elige qué herramientas cargar

Tu IA carga todas las herramientas que se le dan antes de leer tu primer mensaje, por lo que la dirección anterior carga un conjunto básico: las lecturas de inicio, las herramientas sin cuenta, cada herramienta que escribe algo, y cuatro ayudantes. cvl_search_tools encuentra cualquier otra herramienta, cvl_call_read ejecuta una herramienta de lectura por nombre, y cvl_skills_list y cvl_skill_read listan y abren las habilidades. Para cargar grupos completos de antemano, añade ?features= a la dirección:

Grupo	Añade
`behaviour`	sesiones, repeticiones, clics de ira y muertos, fricción de formularios, embudos, rutas, mapas de calor, el feed en vivo
`seo`	rankings, palabras clave, competidores, backlinks, la auditoría del sitio, visibilidad del asistente de IA
`errors`	grupos de errores, un error completo, el resumen de corrección
`site`	páginas rastreadas y su contenido, velocidad de página, estado del rastreo, la verificación de la etiqueta
`workspace`	tus sitios, cuentas conectadas, el tablero, propuestas, memoria, recomendaciones
`all`	todo

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

Para dar a una IA solo lecturas, usa la dirección siguiente. No lista ninguna herramienta que escriba, y rechaza una si se llama de todos modos.

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

Inicio de sesión y tokens

La mayoría de los clientes inician sesión a través de tu navegador: inicia sesión, elige el sitio y pulsa Permitir. Las lecturas están permitidas por defecto; iniciar rastreos y hacer cambios de SEO permanecen desactivados a menos que los marques.

Los clientes que no pueden iniciar sesión a través de un navegador pueden enviar un token de acceso personal como Authorization: Bearer …; crea uno en la página de Desarrollador en la aplicación. Mantenlo en una variable de entorno o en el almacén de secretos de tu cliente, nunca en un archivo que confirmes.

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"

Un token funciona para ambos: un token de inicio de sesión, o un token de acceso personal, es aceptado tanto por el servidor MCP como por la API REST, para el único sitio para el que fue creado.

Una credencial dura 90 días; luego tu cliente inicia sesión de nuevo. No hay token de actualización. Un inicio de sesión se lista en Aplicaciones conectadas en la aplicación, donde puedes revocarlo.

Para constructores de clientes: el servidor publica sus metadatos OAuth en /.well-known/oauth-authorization-server. Soporta registro dinámico de clientes y documentos de metadatos de ID de cliente, y requiere PKCE con S256.

Límites

Quién	Un minuto	Un día
Cada token de acceso personal	120 llamadas	20,000 llamadas
Sin cuenta, por dirección (las herramientas MCP sin cuenta)	20 llamadas	200 llamadas, y 5 escaneos nuevos

Una llamada es una solicitud; initialize y tools/list cuentan cada una. Pasado un límite, la respuesta es HTTP 429 nombrando el límite que alcanzó. Las respuestas que cuentan contra un límite llevan X-RateLimit-Requests-Limit, -Remaining y -Reset, y cvl_whoami lee tu uso actual. Un escaneo de un sitio ya escaneado en las últimas 24 horas reutiliza ese resultado y no cuenta como un escaneo nuevo.

Herramientas sin código

Estas se conectan como clientes MCP. Usa la dirección anterior y, donde la herramienta no tenga inicio de sesión en navegador, un token de acceso personal como token portador.

Zapier: añade la aplicación MCP Client (beta). URL del servidor https://mcp.convertlyft.com/mcp, Transporte Streamable HTTP, luego OAuth o tu token en Bearer Token. Sus acciones incluyen Run Tool y Run Read-Only Tool. Guía de Zapier.
n8n: el nodo MCP Client Tool para un agente de IA, o el nodo independiente MCP Client. Endpoint https://mcp.convertlyft.com/mcp, Transporte del servidor HTTP Streamable, Autenticación Bearer Auth o MCP OAuth2. Documentos de n8n.
Make: el módulo Call a tool de la aplicación MCP Client. Añade el servidor por URL y da tu token como token de acceso. Documentos de Make.

Scripts

Cada herramienta de lectura es también una llamada HTTP simple: GET https://convertlyft.com/api/tools/<name>, argumentos en la cadena de consulta, tu token en el encabezado. Los ejemplos trabajados cubren fechas, cuotas y errores. El documento OpenAPI lista los endpoints de herramientas bajo /api/tools/; la lista de capacidades cubre el resto de la API REST, como iniciar un rastreo y leer sus páginas.

curl

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

Python (biblioteca estándar)

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 · mantén el token en 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());
}

MCP en sí, sin token: lista las herramientas

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

Crea un token de acceso personal en la página de Desarrollador con solo los alcances que el trabajo necesite, guárdalo como un secreto de CI llamado CONVERTLYFT_TOKEN, y llama a la API REST o al servidor MCP con él como arriba.

Inicio de sesión sin interfaz (código de dispositivo, RFC 8628)

La API también tiene un flujo de código de dispositivo, para una máquina sin navegador. El paso 1 pide un 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"}

Paso 2: una persona abre verification_uri (https://convertlyft.com/app/device, o verification_uri_complete con el código rellenado), inicia sesión, verifica que el código coincida con user_code, elige el sitio y pulsa Permitir. Los códigos duran diez minutos y funcionan una vez. El paso 3 consulta cada interval segundos hasta que llegue el token:

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 más rápido que interval responde slow_down con un intervalo más largo; úsalo. Una negativa en la página responde access_denied, y un código dejado demasiado tiempo responde expired_token. El token es de solo lectura a menos que la persona marque una escritura en la página, dura 90 días, y se lista en Aplicaciones conectadas, donde puede revocarse.

Equipos y empresas

Claude Team y Enterprise: un Propietario añade el conector una vez en Configuración de organización → Conectores (Añadir → Personalizado → Web, luego la dirección anterior). Cada miembro lo encuentra luego en Personalizar → Conectores y pulsa Conectar, lo que les inicia sesión en Convertlyft como ellos mismos. Artículo de ayuda de Claude.
ChatGPT Business y Enterprise: los administradores del espacio de trabajo crean la aplicación desde la configuración del espacio de trabajo y la publican a los miembros. El artículo de ayuda de OpenAI tiene los pasos actuales para cada plan.

Cada persona que se conecta inicia sesión y elige un sitio, por lo que solo ven los sitios a los que pertenecen.

Verificaciones gratuitas para constructores de agentes

El mismo rastreador que alimenta el servidor MCP ejecuta tres verificaciones gratuitas en cualquier sitio público, sin necesidad de cuenta:

El verificador WebMCP: prueba las herramientas WebMCP que tus propias páginas exponen, con una guía en lenguaje sencillo para añadirlas.
La verificación gratuita de preparación para agentes (robots.txt por agente de IA, llms.txt, archivos de agente).
La auditoría SEO gratuita, sin cuenta: hasta 16 páginas, con lo que el escaneo no pudo verificar.

Para rastreadores y registros

ConvertlyftBot: el rastreador detrás de las auditorías, su agente de usuario y cómo ralentizarlo o bloquearlo.
/.well-known/ai-catalog.json y /.well-known/mcp/server-card.json: la tarjeta del servidor MCP (SEP-2127).
La lista de capacidades: cada herramienta y los ámbitos que necesita.
/.well-known/skills/index.json: las habilidades, para npx skills add https://convertlyft.com.
llms.txt y llms-full.txt: la guía de API para un modelo.