Servidor MCP de AdMob

Un servidor local de Model Context Protocol que conecta Claude a la API de Google AdMob, brindándote una interfaz conversacional para tus datos de ingresos publicitarios.

Dos formas de usar este servidor:

• stdio local (Claude Code en una máquina): ejecuta ./setup.sh y elige L.

• Vercel + Conector de Claude.ai (multidispositivo): haz clic en el botón de arriba y sigue docs/VERCEL.md. O ejecuta ./setup.sh y elige V.

Requisitos previos

• Node.js 18+

• Un proyecto de Google Cloud con la API de AdMob habilitada

• Credenciales de cliente OAuth 2.0: tipo Aplicación de escritorio para el modo local, tipo Aplicación web para el modo Vercel (consulta docs/VERCEL.md para la configuración específica de Vercel).

Related MCP server: Google Ads MCP Server

Configuración

1. Obtener credenciales de Google OAuth

1. Ve a la Consola de API de Google

2. Crea o selecciona un proyecto

3. Habilita la API de AdMob en la Biblioteca de API

4. Ve a Credenciales > Crear credenciales > ID de cliente de OAuth

5. Selecciona Aplicación de escritorio, ponle un nombre y haz clic en Crear

6. Haz clic en Descargar JSON para descargar el archivo de secreto del cliente

7. Copia el archivo descargado en la carpeta secrets/ de este proyecto

2. Instalar y configurar

cd admob-mcp
./setup.sh

El script de configuración hará lo siguiente:

• Buscar y renombrar el JSON de Google OAuth a secrets/client_secret.json

• Instalar dependencias y compilar

• Abrir un navegador para la autorización de Google OAuth (el token se guarda en secrets/token.json)

• Registrar el servidor MCP con Claude Code

Para volver a autorizar con ámbitos actualizados (por ejemplo, después de añadir otro MCP de Google):

./setup.sh --reauth

Nota: Si la pantalla de consentimiento de OAuth de tu proyecto de Google Cloud no se ha publicado (es decir, todavía está en estado "En pruebas"), verás un error de autorización. Para solucionarlo, publica la aplicación o añade tu cuenta de Google como usuario de prueba en Pantalla de consentimiento de OAuth > Audiencia en la Consola de Google Cloud.

Configuración manual

Si prefieres no usar setup.sh, añade esto a tu configuración de MCP de Claude Code:

{
  "mcpServers": {
    "admob": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/admob-mcp/dist/src/index.js"],
      "env": {
        "ADMOB_CREDENTIALS_PATH": "/absolute/path/to/admob-mcp/secrets/client_secret.json"
      }
    }
  }
}

Configuración del conector (Vercel)

Úsalo si quieres que las herramientas de AdMob estén disponibles en Claude.ai en todos los dispositivos, no solo en Claude Code en tu portátil.

1. Haz un fork del repositorio.

2. Haz clic en Desplegar con Vercel arriba.

3. Aprovisiona Upstash Redis en la pestaña de almacenamiento de Vercel: inyecta automáticamente las variables de entorno KV_* que usa nuestro código. (Vercel dejó de dar soporte a "Vercel KV" independiente; Upstash es el mismo backend).

4. Crea un cliente OAuth de Google Cloud (aplicación web). URI de redireccionamiento autorizado = https://<tu-despliegue>.vercel.app/api/oauth/callback.

5. Establece las variables de entorno en Vercel: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, OAUTH_REDIRECT_URI, CONNECTOR_TOKEN (genéralo con openssl rand -hex 32). Ten cuidado con los espacios en blanco.

6. Visita https://<tu-despliegue>.vercel.app/api/setup, pega el CONNECTOR_TOKEN, haz clic en Autorizar y completa el inicio de sesión de Google. Esto autoriza al servidor a leer datos de AdMob en tu nombre.

7. En Claude.ai → Configuración → Conectores → Añadir conector personalizado: pega https://<tu-despliegue>.vercel.app/api/mcp como URL, deja el ID de cliente y el secreto de OAuth en blanco, haz clic en Añadir y luego en Conectar. Se abrirá una pestaña del navegador en /oauth/authorize: pega el mismo CONNECTOR_TOKEN una vez. Claude.ai se encarga del resto.

Dos flujos de OAuth están protegidos por el mismo CONNECTOR_TOKEN: Google ↔ servidor (paso 6) y Claude.ai ↔ servidor (paso 7). Guía completa que incluye solución de problemas: docs/VERCEL.md.

Uso

Simplemente hazle a Claude una pregunta sobre tus datos de AdMob en lenguaje natural. En el primer uso, Claude llamará automáticamente a list_accounts para descubrir tus cuentas de AdMob y preguntarte con cuál quieres trabajar. Después de eso, usará las herramientas adecuadas para responder a tus preguntas.

Herramientas

Herramientas principales de la API

Herramientas de informes

Herramientas de optimización de ingresos

Estructura del proyecto

• src/index.ts — punto de entrada stdio (Claude Code).

• src/tools.ts — las 36 definiciones de herramientas; registerTools(server, getClient).

• src/auth.ts — ayudantes de Google OAuth (getAuthenticatedClient, authorizeViaLocalServer).

• src/token-store.ts — interfaz TokenStore + FileTokenStore (local) + KvTokenStore (Vercel KV).

• src/oauth-store.ts — almacenamiento respaldado por KV para el flujo OAuth del conector (códigos de autenticación + tokens de acceso).

• src/http-auth.ts — verificación de portador segura contra temporización para endpoints HTTP (sincronización contra CONNECTOR_TOKEN, asíncrona contra tokens de acceso emitidos por KV).

• src/admob-client.ts, src/helpers.ts — cliente REST y utilidades de formato de informes.

• api/mcp.ts — función de Vercel: endpoint HTTP MCP (HTTP transmitible, protegido por portador, emite WWW-Authenticate en 401).

• api/setup.ts — función de Vercel: formulario que inicia el flujo OAuth Google ↔ servidor.

• api/oauth/callback.ts — función de Vercel: URI de redireccionamiento de Google; almacena tokens en KV.

• api/oauth/authorize.ts, api/oauth/token.ts, api/oauth/register.ts — funciones de Vercel que implementan el flujo OAuth 2.1 Claude.ai ↔ servidor con PKCE y registro dinámico de clientes.

• api/well-known/oauth-authorization-server.ts, api/well-known/oauth-protected-resource.ts — metadatos RFC 8414 / RFC 9728 para que Claude.ai pueda descubrir los endpoints de OAuth.

• setup.sh — script de configuración interactivo ([L]ocal / [V]ercel / [B]oth).

• docs/VERCEL.md — guía de despliegue para forks.

• AGENTS.md — notas canónicas del proyecto (CLAUDE.md es un enlace simbólico a este).

Desarrollo

npm run build     # Compile TypeScript
npm run start     # Run the server directly (stdio)