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
- En Claude, abre Configuración > Conectores y elige Añadir conector personalizado.
- Pega la URL del servidor y añádela.
- Elige Conectar, inicia sesión en Ads Lighthouse y aprueba el acceso para tu cuenta.
ChatGPT
- En ChatGPT, activa el modo desarrollador en Configuración > Apps y conectores > Configuración avanzada.
- Crea un conector con la URL del servidor y elige OAuth como autenticación.
- 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
- 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
- Añade el servidor a .vscode/mcp.json en tu espacio de trabajo, o a tu configuración de usuario.
- 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
- 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
- Añade el servidor a ~/.cursor/mcp.json, o a .cursor/mcp.json en un proyecto.
- 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.
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.
| Herramienta | Qué hace | Acceso |
|---|---|---|
get_account | Plan, asignaciones mensuales, uso y límite de velocidad | Lectura |
list_projects | Proyectos en la cuenta | Lectura |
get_project_details | Configuración de un proyecto y cobertura de datos | Lectura |
create_project | Crear un proyecto e iniciar sus primeras comprobaciones | Escritura, usa comprobaciones |
list_keywords | Palabras clave monitoreadas con comprobaciones guardadas y anuncios en un período | Lectura |
add_keywords | Añadir palabras clave a un proyecto | Escritura |
remove_keyword | Dejar de monitorear una palabra clave | Escritura |
list_observations | Comprobaciones guardadas con los anuncios pagados que encontraron | Lectura |
list_advertisers | Dominios de anunciantes con visibilidad y señales | Lectura |
list_affiliate_findings | Tus IDs de afiliado vistos detrás de anuncios que usan tu marca | Lectura |
list_alert_events | Alertas activadas para la cuenta | Lectura |
run_realtime_check | Iniciar una comprobación bajo demanda de las palabras clave de un proyecto | Escritura, usa comprobaciones |
get_check_status | Progreso de una comprobación bajo demanda | Lectura |
get_summary | Cifras principales para un proyecto y período | Lectura |
get_timeseries | Comprobaciones, anuncios y anunciantes por día, semana o mes local | Lectura |
get_advertiser | Métricas, categoría y anuncios guardados de un anunciante | Lectura |
list_competitors | Otros anunciantes clasificados por ocurrencias de anuncios, con tus categorías | Lectura |
set_advertiser_classification | Guardar la categoría de tu equipo para un dominio de anunciante | Escritura |
get_keyword_report | Comprobaciones guardadas, anuncios y anunciantes de una palabra clave en un período | Lectura |
list_keyword_ads | Anunciantes o anuncios distintos vistos para una palabra clave | Lectura |
list_affiliate_ids | Tus IDs de afiliado vistos en URLs de anuncios guardados | Lectura |
set_affiliate_case_status | Establecer el estado de revisión de un ID de afiliado no conforme | Escritura |
list_shopping_products | Listados de productos patrocinados vistos en capturas de Google Shopping | Lectura |
export_paid_results | Las filas de la exportación CSV de resultados pagados, como JSON | Lectura |
export_paid_results_by_keyword | Las filas de la vista Resultados pagados por palabra clave, como JSON | Lectura |
export_affiliate_cases | Las filas de la exportación CSV de afiliados no conformes, como JSON | Lectura |
get_advertiser_history | Cuándo y dónde apareció un anunciante, con el cronograma de observación | Lectura |
get_advertiser_heatmap | Presencia por hora local y día de la semana | Lectura |
list_ad_copy_versions | Textos de anuncios distintos de un anunciante, del más reciente al más antiguo | Lectura |
list_ad_copy_changes | Cambios recientes en textos de anuncios entre anunciantes | Lectura |
update_project | Cambiar el plan de monitoreo, la marca o la configuración de afiliados de un proyecto | Escritura |
delete_project | Eliminar permanentemente un proyecto y sus datos guardados | Escritura |
remove_keywords | Dejar de monitorear varias palabras clave | Escritura |
preview_check_demand | Pronosticar las comprobaciones mensuales y la asignación para un cambio propuesto | Lectura |
get_monitoring_options | Mercados, motores de búsqueda, dispositivos y cronogramas que puedes configurar | Lectura |
search_locations | Encontrar ciudades y regiones disponibles para monitoreo en un mercado | Lectura |
list_check_activity | Actividad de fondo reciente de un proyecto y búsquedas en cola | Lectura |
get_time_zone | Tu preferencia personal de zona horaria | Lectura |
update_time_zone | Cambiar tu preferencia personal de zona horaria | Escritura |
get_theme | Tu preferencia personal de apariencia | Lectura |
update_theme | Cambiar tu preferencia personal de apariencia | Escritura |
list_alert_rules | Reglas de alerta configuradas en la cuenta | Lectura |
get_alert_rule | Una regla de alerta | Lectura |
create_alert_rule | Crear una regla de alerta (correo electrónico, Slack o webhook) | Escritura |
update_alert_rule | Habilitar, deshabilitar o cambiar una regla de alerta | Escritura |
delete_alert_rule | Eliminar una regla de alerta y su historial de alertas | Escritura |
send_test_alert | Poner en cola una alerta sintética a través del canal de una regla | Escritura |
rotate_webhook_secret | Reemplazar el secreto de firma de una regla de webhook | Escritura |
get_alert_event | Una alerta con su registro de entrega | Lectura |
list_team | Miembros, roles e invitaciones abiertas | Lectura |
invite_team_member | Enviar por correo electrónico una invitación para unirse a la cuenta | Escritura, usa comprobaciones |
resend_invitation | Reenviar una invitación abierta con un nuevo enlace | Escritura, usa comprobaciones |
cancel_invitation | Revocar una invitación abierta | Escritura |
change_member_role | Convertir a un miembro en administrador o a un administrador en miembro | Escritura |
remove_team_member | Eliminar a una persona de la cuenta | Escritura |
list_accounts | La cuenta que esta credencial puede usar | Lectura |
get_account_overview | Límites del plan, fechas de suscripción, medidores y pronóstico | Lectura |
get_email_preferences | Tus preferencias de correo electrónico de producto y boletín | Lectura |
update_email_preferences | Activar o desactivar correos electrónicos de producto o el boletín | Escritura |
list_google_connections | Tus conexiones de Google Ads y Search Console en un proyecto | Lectura |
list_google_accounts | Clientes de Google Ads o sitios de Search Console que una conexión puede leer | Lectura |
run_google_ads_report | Rendimiento de palabras clave o términos de búsqueda de Google Ads | Lectura |
run_search_console_report | Clics, impresiones, CTR y posición de Search Console | Lectura |
trace_redirects | Poner en cola un rastreo del lado del servidor de un destino de anuncio guardado | Escritura, usa comprobaciones |
get_redirect_chain | Una cadena de redireccionamiento rastreada | Lectura |
list_redirect_chains | Cadenas de redireccionamiento rastreadas de un proyecto | Lectura |
list_policy_rules | Reglas de política de un proyecto | Lectura |
get_policy_rule | Una regla de política | Lectura |
create_policy_rule | Declarar una regla de política para un proyecto | Escritura |
update_policy_rule | Renombrar, pausar, reconfigurar o redefinir el alcance de una regla de política | Escritura |
delete_policy_rule | Eliminar una regla de política y conservar sus casos | Escritura |
preview_policy_rule | Lo que coincidiría con una regla borrador, sin guardarla | Lectura |
evaluate_policy_rules | Comprobar anuncios guardados contra las reglas habilitadas y registrar casos | Escritura |
list_policy_cases | Casos abiertos por reglas de política | Lectura |
get_policy_case | Un caso con su cronología | Lectura |
list_policy_case_evidence | Los anuncios guardados que coincidieron con la regla de un caso | Lectura |
update_policy_case | Cambiar el estado o el propietario de un caso | Escritura |
add_policy_case_note | Añadir una nota a la cronología de un caso | Escritura |
create_report | Solicitar un informe PDF de proyecto para un período y filtros | Escritura |
list_reports | Informes PDF de un proyecto, del más reciente al más antiguo | Lectura |
get_report_status | Estado de un informe PDF | Lectura |
get_report_download_link | Un enlace de corta duración para descargar un informe listo | Lectura |
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.