Ads Lighthouse MCP Server

Servidor MCP alojado para monitorear anuncios pagados en búsquedas de marca, revisar anunciantes y hallazgos de afiliados, y acceder a informes guardados mediante OAuth 2.1.

Servidor MCP alojado

npx add-mcp 'https://adslighthouse.com/api/v1/mcp'

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

Documentación

Servidor MCP de Ads Lighthouse

URL del servidor

https://adslighthouse.com/api/v1/mcp

HTTP Streamable. Inicia sesión con tu cuenta de Ads Lighthouse (OAuth 2.1 con PKCE). En el plan Scale y superiores, también puedes enviar una clave de API como token de portador.

El servidor MCP está incluido en todos los planes, incluidos los de prueba.

Qué es

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a los asistentes de IA llamar herramientas. Nuestro servidor alojado le da a un asistente los mismos datos que la API: proyectos, palabras clave, comprobaciones guardadas con sus anuncios, anunciantes, hallazgos de afiliados, alertas y uso.

Prueba preguntas como: ¿Quién anunció con nuestros términos de marca en EE. UU. la semana pasada? ¿Qué anunciantes usan nuestros IDs de afiliado? ¿Cambió algo en móvil desde el lunes?

Conecta tu asistente

Claude

  1. En Claude, abre Configuración > Conectores y elige Añadir conector personalizado.
  2. Pega la URL del servidor y añádela.
  3. Elige Conectar, inicia sesión en Ads Lighthouse y aprueba el acceso para tu cuenta.

ChatGPT

  1. En ChatGPT, activa el modo desarrollador en Configuración > Apps y conectores > Configuración avanzada.
  2. Crea un conector con la URL del servidor y elige OAuth como autenticación.
  3. Inicia sesión en Ads Lighthouse y aprueba el acceso. Los nombres de los menús pueden cambiar; sigue la ayuda de ChatGPT si difieren.

Claude Code

  1. Añade el servidor desde tu terminal y luego ejecuta /mcp en Claude Code y elige Autenticar.

Claude Code

claude mcp add --transport http ads-lighthouse https://adslighthouse.com/api/v1/mcp

VS Code y GitHub Copilot

  1. Añade el servidor a .vscode/mcp.json en tu espacio de trabajo, o a tu configuración de usuario.
  2. Inícialo desde el archivo e inicia sesión cuando VS Code lo solicite.

VS Code y GitHub Copilot

{
  "servers": {
    "ads-lighthouse": {
      "type": "http",
      "url": "https://adslighthouse.com/api/v1/mcp"
    }
  }
}

Gemini CLI

  1. Añade el servidor a ~/.gemini/settings.json y luego ejecuta /mcp auth ads-lighthouse para iniciar sesión.

Gemini CLI

{
  "mcpServers": {
    "ads-lighthouse": {
      "httpUrl": "https://adslighthouse.com/api/v1/mcp"
    }
  }
}

Cursor

  1. Añade el servidor a ~/.cursor/mcp.json, o a .cursor/mcp.json en un proyecto.
  2. En la configuración de MCP de Cursor, elige Conectar junto a ads-lighthouse, inicia sesión en Ads Lighthouse y aprueba el acceso para tu cuenta. Esto funciona en todos los planes.

Cursor

{
  "mcpServers": {
    "ads-lighthouse": {
      "url": "https://adslighthouse.com/api/v1/mcp"
    }
  }
}

Usa una clave de API en lugar de iniciar sesión

En los planes Scale y superiores, cualquier cliente que pueda enviar encabezados puede usar una clave de API: envía Authorization: Bearer als_your_key con cada solicitud. Una clave actúa para toda la cuenta; crea una clave de solo lectura a menos que el asistente necesite hacer cambios. En otros planes, conéctate iniciando sesión.

API de Ads Lighthouse

Herramientas

Toda herramienta que acepte project_id acepta el id del proyecto, el dominio de la marca o el nombre exacto del proyecto o la marca. Las herramientas que modifican datos necesitan acceso de escritura, y el asistente debe pedirte permiso antes de usarlas.

HerramientaQué haceAcceso
get_accountPlan, asignaciones mensuales, uso y límite de velocidadLectura
list_projectsProyectos en la cuentaLectura
get_project_detailsConfiguración de un proyecto y cobertura de datosLectura
create_projectCrear un proyecto e iniciar sus primeras comprobacionesEscritura, usa comprobaciones
list_keywordsPalabras clave monitoreadas con comprobaciones guardadas y anuncios en un períodoLectura
add_keywordsAñadir palabras clave a un proyectoEscritura
remove_keywordDejar de monitorear una palabra claveEscritura
list_observationsComprobaciones guardadas con los anuncios pagados que encontraronLectura
list_advertisersDominios de anunciantes con visibilidad y señalesLectura
list_affiliate_findingsTus IDs de afiliado vistos detrás de anuncios que usan tu marcaLectura
list_alert_eventsAlertas activadas para la cuentaLectura
run_realtime_checkIniciar una comprobación bajo demanda de las palabras clave de un proyectoEscritura, usa comprobaciones
get_check_statusProgreso de una comprobación bajo demandaLectura
get_summaryCifras principales para un proyecto y períodoLectura
get_timeseriesComprobaciones, anuncios y anunciantes por día, semana o mes localLectura
get_advertiserMétricas, categoría y anuncios guardados de un anuncianteLectura
list_competitorsOtros anunciantes clasificados por ocurrencias de anuncios, con tus categoríasLectura
set_advertiser_classificationGuardar la categoría de tu equipo para un dominio de anuncianteEscritura
get_keyword_reportComprobaciones guardadas, anuncios y anunciantes de una palabra clave en un períodoLectura
list_keyword_adsAnunciantes o anuncios distintos vistos para una palabra claveLectura
list_affiliate_idsTus IDs de afiliado vistos en URLs de anuncios guardadosLectura
set_affiliate_case_statusEstablecer el estado de revisión de un ID de afiliado no conformeEscritura
list_shopping_productsListados de productos patrocinados vistos en capturas de Google ShoppingLectura
export_paid_resultsLas filas de la exportación CSV de resultados pagados, como JSONLectura
export_paid_results_by_keywordLas filas de la vista Resultados pagados por palabra clave, como JSONLectura
export_affiliate_casesLas filas de la exportación CSV de afiliados no conformes, como JSONLectura
get_advertiser_historyCuándo y dónde apareció un anunciante, con el cronograma de observaciónLectura
get_advertiser_heatmapPresencia por hora local y día de la semanaLectura
list_ad_copy_versionsTextos de anuncios distintos de un anunciante, del más reciente al más antiguoLectura
list_ad_copy_changesCambios recientes en textos de anuncios entre anunciantesLectura
update_projectCambiar el plan de monitoreo, la marca o la configuración de afiliados de un proyectoEscritura
delete_projectEliminar permanentemente un proyecto y sus datos guardadosEscritura
remove_keywordsDejar de monitorear varias palabras claveEscritura
preview_check_demandPronosticar las comprobaciones mensuales y la asignación para un cambio propuestoLectura
get_monitoring_optionsMercados, motores de búsqueda, dispositivos y cronogramas que puedes configurarLectura
search_locationsEncontrar ciudades y regiones disponibles para monitoreo en un mercadoLectura
list_check_activityActividad de fondo reciente de un proyecto y búsquedas en colaLectura
get_time_zoneTu preferencia personal de zona horariaLectura
update_time_zoneCambiar tu preferencia personal de zona horariaEscritura
get_themeTu preferencia personal de aparienciaLectura
update_themeCambiar tu preferencia personal de aparienciaEscritura
list_alert_rulesReglas de alerta configuradas en la cuentaLectura
get_alert_ruleUna regla de alertaLectura
create_alert_ruleCrear una regla de alerta (correo electrónico, Slack o webhook)Escritura
update_alert_ruleHabilitar, deshabilitar o cambiar una regla de alertaEscritura
delete_alert_ruleEliminar una regla de alerta y su historial de alertasEscritura
send_test_alertPoner en cola una alerta sintética a través del canal de una reglaEscritura
rotate_webhook_secretReemplazar el secreto de firma de una regla de webhookEscritura
get_alert_eventUna alerta con su registro de entregaLectura
list_teamMiembros, roles e invitaciones abiertasLectura
invite_team_memberEnviar por correo electrónico una invitación para unirse a la cuentaEscritura, usa comprobaciones
resend_invitationReenviar una invitación abierta con un nuevo enlaceEscritura, usa comprobaciones
cancel_invitationRevocar una invitación abiertaEscritura
change_member_roleConvertir a un miembro en administrador o a un administrador en miembroEscritura
remove_team_memberEliminar a una persona de la cuentaEscritura
list_accountsLa cuenta que esta credencial puede usarLectura
get_account_overviewLímites del plan, fechas de suscripción, medidores y pronósticoLectura
get_email_preferencesTus preferencias de correo electrónico de producto y boletínLectura
update_email_preferencesActivar o desactivar correos electrónicos de producto o el boletínEscritura
list_google_connectionsTus conexiones de Google Ads y Search Console en un proyectoLectura
list_google_accountsClientes de Google Ads o sitios de Search Console que una conexión puede leerLectura
run_google_ads_reportRendimiento de palabras clave o términos de búsqueda de Google AdsLectura
run_search_console_reportClics, impresiones, CTR y posición de Search ConsoleLectura
trace_redirectsPoner en cola un rastreo del lado del servidor de un destino de anuncio guardadoEscritura, usa comprobaciones
get_redirect_chainUna cadena de redireccionamiento rastreadaLectura
list_redirect_chainsCadenas de redireccionamiento rastreadas de un proyectoLectura
list_policy_rulesReglas de política de un proyectoLectura
get_policy_ruleUna regla de políticaLectura
create_policy_ruleDeclarar una regla de política para un proyectoEscritura
update_policy_ruleRenombrar, pausar, reconfigurar o redefinir el alcance de una regla de políticaEscritura
delete_policy_ruleEliminar una regla de política y conservar sus casosEscritura
preview_policy_ruleLo que coincidiría con una regla borrador, sin guardarlaLectura
evaluate_policy_rulesComprobar anuncios guardados contra las reglas habilitadas y registrar casosEscritura
list_policy_casesCasos abiertos por reglas de políticaLectura
get_policy_caseUn caso con su cronologíaLectura
list_policy_case_evidenceLos anuncios guardados que coincidieron con la regla de un casoLectura
update_policy_caseCambiar el estado o el propietario de un casoEscritura
add_policy_case_noteAñadir una nota a la cronología de un casoEscritura
create_reportSolicitar un informe PDF de proyecto para un período y filtrosEscritura
list_reportsInformes PDF de un proyecto, del más reciente al más antiguoLectura
get_report_statusEstado de un informe PDFLectura
get_report_download_linkUn enlace de corta duración para descargar un informe listoLectura

Seguridad

  • Tú eliges la cuenta y si el asistente puede hacer cambios cuando apruebas la conexión. Desconecta cualquier aplicación en Configuración > API y MCP.
  • Los tokens de acceso expiran después de una hora y los tokens de actualización rotan en cada uso. Un token de actualización reutilizado termina la conexión.
  • El asistente actúa como tú: si sales de la cuenta, o la cuenta ya no tiene un plan activo o prueba, su acceso también termina.
  • Crear un proyecto e iniciar una comprobación bajo demanda usan la asignación de tu plan y necesitan una clave de idempotencia, por lo que una llamada reintentada nunca ejecuta las comprobaciones dos veces.
  • Los asistentes pueden malinterpretar datos. Verifica los hallazgos importantes en la aplicación, donde cada observación muestra su contexto completo.