Guía · paid-media-os
Conectar paid-media-os por API, paso a paso
Para quien usa paid-media-os sin Climent Ads. Son los pasos que el sistema no puede hacer por ti: estas cuentas solo las puedes abrir tú.
Respuesta corta: sin Climent Ads, paid-media-os se conecta a Google Ads, GA4 y Meta por sus API oficiales. Creas un proyecto de Google Cloud con acceso Explorer, inicias sesión una vez con un comando y pones hasta tres variables de Windows. Para Meta, añades su conector con tu propio App ID. Después, /welcome prueba cada fuente.
¿Por qué Climent Ads es el camino más seguro?
Por API, el fichero que abre tus cuentas se queda en tu ordenador, y cuidarlo es cosa tuya. Con Climent Ads puedes desconectar cada cuenta cuando quieras.
- Un cambio solo llega a la cuenta cuando una persona de tu equipo aprueba ese cambio concreto, y cada uno se puede deshacer.
- Te enseña primero lo que cambiaría, y espera.
- Cada acción propuesta se para en una aprobación con registro, y ese paso no se puede apagar.
- Lee Google Ads, Meta Ads, GA4 y Search Console cada día, en una sola lectura y no en cuatro pestañas. Y te dice qué etiqueta de Tag Manager dispara cada conversión.
Si lo de abajo es más de lo que quieres llevar tú, pregúntame antes.
Climent Ads está en beta privada: entran cuentas una a una. Escríbeme y te digo si la tuya puede entrar ya.
¿Qué necesito antes de empezar?
- Windows 10 u 11, con paid-media-os ya instalado.
- La Google Cloud CLI, que se llama
gcloud. Instálala antes con el instalador de Windows de Google: el paso de iniciar sesión la necesita. - El comando
claude, para el paso de Meta. En el PC donde lo comprobé, la app de Claude no lo añadía. Escribeclaude --versionen el Símbolo del sistema: si Windows no lo reconoce, instálalo con el comando para CMD de Anthropic. - Una regla para toda la página: ninguna clave se escribe en el chat de Claude ni en un fichero de la carpeta del sistema. Esa carpeta es donde está instalado paid-media-os.
Esta ruta aún no la ha recorrido nadie de principio a fin. Los pasos salen de las instrucciones del paquete y de la documentación de Google y de Meta. Si un paso no coincide con lo que ves, escríbeme.
¿Cómo conecto Google Ads?
- Crea un proyecto de Google Cloud en la consola y activa la Google Ads API. Son minutos. Apunta el ID del proyecto.
- Pide el acceso Explorer. En ese proyecto, abre Google Ads API Overview en la consola de Google Cloud y solicítalo. Google lo revisa de forma automática y suele aprobarlo. No hace falta una cuenta de administrador.
- Configura la pantalla de consentimiento en ese mismo proyecto (consola de Google Cloud, Google Auth Platform, Audience). Si el proyecto está dentro de una organización de Google Workspace, elige Internal. Con una cuenta personal de Google solo cabe External: pulsa Publish app, porque mientras ponga Testing, Google corta tu sesión a los 7 días. Al iniciar sesión, Google te avisará de que la app no está verificada. Es tu propia app: abre las opciones avanzadas (Advanced, si la ves en inglés) y pulsa el enlace para ir a tu app (Go to).
- Crea un cliente OAuth de tipo App de escritorio (Desktop app) en ese mismo proyecto, con las instrucciones de Google, y descarga su fichero JSON.
- Inicia sesión una vez. Abre el Símbolo del sistema (escribe
cmden el menú Inicio), no PowerShell, que le quita las comas. Pega abajo la ruta del fichero que descargaste (Mayús y clic derecho en él, Copiar como ruta de acceso) y la página escribe el comando. Ejecútalo en una sola línea, porque Windows no lo acepta partido. Entra con un usuario de Google que tenga acceso a tus cuentas de Google Ads.
gcloud auth application-default login --client-id-file=RUTA_DEL_JSON_DEL_CLIENTE --scopes=https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform
Google guarda ese inicio de sesión en %APPDATA%\gcloud\application_default_credentials.json (Google, credenciales predeterminadas, leída el 21 de noviembre de 2026). Los tres permisos salen de las páginas de instalación del servidor de Google Ads y del de Analytics (leídas el 7 de noviembre de 2026), y así un fichero sirve para los dos.
Último paso: guárdalas como variables de usuario de Windows. Rellena tus ID y ejecuta el comando en el mismo Símbolo del sistema. Se quedan en Windows, nunca en un fichero de la carpeta.
setx GOOGLE_APPLICATION_CREDENTIALS "%APPDATA%\gcloud\application_default_credentials.json" & setx GOOGLE_PROJECT_ID ID_DE_TU_PROYECTO
Lo que escribes en estas cajas se queda en esta página, y no se envía nada. Después, reinicia la app de Claude.
¿Te atascas con la pantalla de consentimiento o con el comando? Escríbeme lo que ves¿Por qué me dice que no Google?
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION: el proyecto solo tiene acceso Test. Vuelve al paso de Explorer y pídelo.- No te dan Explorer ni Basic: puede que tu proyecto esté en la prueba gratuita de Google Cloud, o que tenga la facturación suspendida o desactivada. Google lo publica como problema conocido, con la solución temporal, en su página de acceso, leída el 7 de noviembre de 2026.
invalid_granta la semana: la pantalla de consentimiento sigue en Testing. Pulsa Publish app y vuelve a ejecutar el comando de iniciar sesión.- Un tutorial te pide un developer token: está desfasado. Google los retiró el 9 de septiembre de 2026. En mi guía de la API de Google Ads está lo que cambió.
¿Cómo conecto GA4?
- En el mismo proyecto de Google Cloud, activa la Google Analytics Admin API y la Google Analytics Data API.
- El usuario de Google con el que iniciaste sesión necesita acceso de lectura a cada propiedad. Se lo da quien administra la propiedad.
- No hay nada más que configurar. Usa el mismo fichero de credenciales.
¿Cómo conecto Meta Ads?
- Crea tu propia app de Meta en Meta for Developers y elige el caso de uso de crear y gestionar anuncios. Apunta su App ID, arriba en la página de la app. Son minutos.
- Usa un usuario de Meta con acceso a las cuentas publicitarias. Los tokens de usuario del sistema con rol de administrador no funcionan con este conector.
- Abre un terminal dentro de la carpeta del sistema: ve a esa carpeta en el Explorador de archivos, escribe
cmden la barra de direcciones y pulsa Intro. Escribe tu App ID en la caja de abajo, y la página lo pone en el comando. Ejecútalo ahí. El App ID va solo en ese comando, nunca en un fichero.
claude mcp add --transport http --client-id <META_APP_ID> meta-ads https://mcp.facebook.com/ads
La primera vez que lo uses, Facebook te pedirá iniciar sesión y dar permisos. Meta pide ads_mcp_management y uno de dos permisos de anuncios: da ads_read si solo quieres leer, y ads_management si quieres que el sistema aplique los cambios que apruebes. El conector de Meta está en beta.
¿Cómo sé que ha funcionado?
Abre la carpeta en la pestaña Code de la app de Claude y escribe /welcome. Prueba cada fuente con una lectura y te dice cuáles funcionan. Si una falla, te da el error en una línea y sigue con la siguiente.
Preguntas antes de empezar
¿Necesito una cuenta de administrador?
Para empezar, no. El acceso Explorer se pide desde el proyecto de Cloud, sin ella. Solo la usas si ya llegas a tus cuentas a través de ella, y entonces su ID va en la variable opcional.
¿Dónde quedan mis credenciales?
En tu ordenador: el fichero que crea el comando de acceso y las variables de Windows que apuntan a él. Por eso nada se escribe en el chat de Claude ni en un fichero de la carpeta del sistema.
¿Y si una pantalla no coincide con estos pasos?
Los menús cambian de nombre. Escríbeme lo que ves y te digo dónde mirar.
Para seguir leyendo
- API de Google Ads. Los niveles de acceso, y lo que necesita un MCP para tus propias cuentas.
- MCP de Meta Ads. Las opciones para conectar Claude o ChatGPT a Meta, y cuáles pueden gastar presupuesto.
- MCP de Google Ads. Las opciones para conectar Claude o ChatGPT a Google Ads.
Escrito por Manuel Climent · Última actualización:
Quién ha escrito esto
Soy Manu. Llevo cuentas de anuncios, y construí Climent Ads Assistant porque ningún software de anuncios que pagué lo valía. Lee Meta, Google Ads, GA4 y Search Console cliente a cliente, y solo cambia una campaña con una propuesta que aprueba una persona.
Climent Ads está en beta privada: entran cuentas una a una. Escríbeme y te digo si la tuya puede entrar ya.