MCP Convertmax

El servidor MCP de Convertmax está alojado en una URL. Apunta un cliente a esa dirección, aprueba el acceso en el navegador y Max puede leer ingresos, atribución y datos de comercio del workspace que elijas.

https://mcp.convertmax.ai/mcp

La conexión abre el navegador en auth.convertmax.io para que puedas iniciar sesión. Es el mismo host de login que Slack y Make. Eliges el workspace (o una cuenta de agencia), qué puede ver esta IA y pulsas Allow.

Cada aprobación crea una conexión de ese cliente (Cursor, Claude, ChatGPT, …) a ese workspace. No es la clave API del workspace. Gestiona las conexiones en Convertmax:

https://app.convertmax.io/mcp/grants

Ahí ves qué IA está conectada, qué workspace usa, a qué puede acceder y puedes desconectarla. Desconectar Cursor no rompe Slack, Make ni la API de Convertmax. La siguiente llamada de un cliente desconectado o restringido se rechaza.

Conectar un cliente

Usa HTTP Streamable. El cliente descubre OAuth en el servidor; no hace falta pegar client IDs ni URLs de redirección.

Cursor

Añade esto a .cursor/mcp.json (proyecto) o ~/.cursor/mcp.json (usuario):

{
  "mcpServers": {
    "convertmax": {
      "type": "http",
      "url": "https://mcp.convertmax.ai/mcp"
    }
  }
}

Recarga los servidores MCP en Cursor. Se abre una ventana del navegador para el consentimiento de Convertmax.

Claude Code

claude mcp add --transport http convertmax https://mcp.convertmax.ai/mcp

Claude Desktop

En Settings → Connectors, añade un conector personalizado con la URL https://mcp.convertmax.ai/mcp. Claude Desktop abre la misma página de consentimiento de Convertmax.

ChatGPT

En ChatGPT, añade un conector MCP personalizado y pega https://mcp.convertmax.ai/mcp. ChatGPT no corre en tu máquina, así que hace falta una URL remota con OAuth; un servidor stdio local no funciona.

VS Code (Copilot)

{
  "servers": {
    "convertmax": {
      "type": "http",
      "url": "https://mcp.convertmax.ai/mcp"
    }
  }
}

Codex

codex mcp add convertmax --url https://mcp.convertmax.ai/mcp

Cualquier otro cliente MCP que soporte HTTP remoto y OAuth usa la misma URL.

¿Sin navegador? Usa una clave API

OAuth asume un navegador y alguien que pulse Allow. Un job de CI no tiene ni lo uno ni lo otro, así que el servidor también acepta una clave API del workspace como cabecera:

claude mcp add --scope user --transport http convertmax https://mcp.convertmax.ai/mcp \
  --header "Authorization: Bearer private-<your_key>"

Usa una clave de Account → API. La clave está ligada a un solo workspace; en este camino no hay selector de cuenta. Prefiere una clave restringida y no la subas al repositorio. OAuth es el camino correcto para Cursor, Claude y ChatGPT en un portátil.

También puedes enviar x-api-key: private-<your_key> si el cliente no puede enviar Authorization.

Qué puede hacer el servidor

El catálogo es solo herramientas. Tras conectar, pregunta en lenguaje natural; el cliente llama a las herramientas. No pasas un ID de tenant.

Preguntas típicas:

• ¿Qué campañas generaron más ingresos este mes?
• ¿Cómo se comparan los ingresos con la semana pasada?
• Desglosa la adquisición por fuente.
• Resume conversiones e ingresos por tipo de evento.
• Muestra beneficio, adquisición, retención o LTV de producto en un rango de fechas.
• ¿Cuáles fueron las consultas de búsqueda principales la semana pasada?

Las herramientas cubren salud del servicio, resumen de reporting, búsqueda, adquisición y PPC, conversiones, beneficio de comercio y LTV, e insights del tenant. Las acciones de escritura (mcp.actions.write) están desactivadas salvo que las actives al pulsar Allow.

Esas casillas deciden qué herramientas ve el cliente:

Allow por defecto da lectura de workspace, métricas y comercio. Desmarca lo que no quieras dar a ese cliente. Puedes cambiarlo después en conexiones MCP sin tocar Slack u otras integraciones.

Por qué remoto

Los agentes que corren en un navegador o un datacenter (ChatGPT, Claude en la web, agentes alojados) no pueden lanzar un proceso local ni leer una clave de tu portátil. Un endpoint HTTP con OAuth se comporta igual en tu terminal o en otro sitio.

Un plugin público o un mcp.json compartido tampoco puede llevar una clave API real. OAuth saca el secreto del paquete: la URL es pública, apruebas en el navegador y cada IA tiene su propia conexión en Convertmax.

Probar la conexión

Cuando el cliente muestre Convertmax como conectado, pregunta:

Resume el rendimiento de ingresos de los últimos 7 días

Si Max responde con datos del workspace que aprobaste, la conexión funciona.

También puedes probar:

• Ejecuta un health check del servidor MCP de Convertmax.
• ¿Cuáles fueron las consultas de búsqueda principales la semana pasada?
• Compara los ingresos de búsqueda de pago de este mes con el mes pasado.

Para preguntar a Max en Slack en lugar de un cliente MCP, consulta Slack.

Resolución de problemas

El navegador nunca se abre

Confirma que el cliente usa HTTP (o HTTP Streamable), no stdio/npx. La URL debe ser exactamente https://mcp.convertmax.ai/mcp.

El consentimiento funcionó pero las herramientas fallan con 401

El token de acceso caducó o la conexión se desconectó en Convertmax. Desconecta y vuelve a conectar el servidor en el cliente, o abre conexiones MCP y confirma que sigue activa.

Max no tiene los datos que espero

Comprueba que elegiste el workspace correcto en la pantalla de consentimiento, sobre todo en una cuenta de agencia con más de un cliente. Confirma que las fuentes de datos de ese workspace están conectadas en Convertmax.

Quiero que este cliente vea menos

Abre conexiones MCP y reduce lo que ese cliente puede ver, o desconéctalo. La siguiente llamada a una herramienta usa los nuevos permisos. Vuelve a conectar solo si quieres un segundo cliente en otro workspace.

Listo

Tu agente de código ya puede hacer a Convertmax las mismas preguntas que harías a un analista de ingresos:

Ask → Understand → Act