AdMob MCP Server

Локальный сервер Model Context Protocol, который подключает Claude к Google AdMob API, предоставляя вам диалоговый интерфейс для работы с данными о доходах от рекламы.

Два способа использования этого сервера:

• Локальный stdio (Claude Code на одном компьютере): запустите ./setup.sh и выберите L.

• Vercel + Claude.ai Connector (несколько устройств): нажмите на кнопку выше, затем следуйте docs/VERCEL.md. Или запустите ./setup.sh и выберите V.

Предварительные требования

• Node.js 18+

• Проект в Google Cloud с включенным AdMob API

• Учетные данные клиента OAuth 2.0 — тип Desktop app для локального режима, тип Web application для режима Vercel (см. docs/VERCEL.md для настройки под Vercel).

Related MCP server: Google Ads MCP Server

Настройка

1. Получение учетных данных Google OAuth

1. Перейдите в Google API Console

2. Создайте или выберите проект

3. Включите AdMob API в библиотеке API

4. Перейдите в Credentials > Create Credentials > OAuth client ID

5. Выберите Desktop app, дайте ему имя и нажмите Create

6. Нажмите Download JSON, чтобы загрузить файл с секретом клиента

7. Скопируйте загруженный файл в папку secrets/ в этом проекте

2. Установка и настройка

cd admob-mcp
./setup.sh

Скрипт настройки выполнит следующие действия:

• Найдет и переименует JSON-файл Google OAuth в secrets/client_secret.json

• Установит зависимости и выполнит сборку

• Откроет браузер для авторизации Google OAuth (токен будет сохранен в secrets/token.json)

• Зарегистрирует MCP-сервер в Claude Code

Для повторной авторизации с обновленными областями доступа (например, после добавления другого Google MCP):

./setup.sh --reauth

Примечание: Если экран согласия OAuth вашего проекта Google Cloud не был опубликован (т.е. он все еще находится в статусе "Тестирование"), вы увидите ошибку авторизации. Чтобы исправить это, либо опубликуйте приложение, либо добавьте свою учетную запись Google в качестве тестового пользователя в разделе OAuth consent screen > Audience в Google Cloud Console.

Ручная настройка

Если вы предпочитаете не использовать setup.sh, добавьте это в конфигурацию Claude Code MCP:

{
  "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"
      }
    }
  }
}

Настройка коннектора (Vercel)

Используйте этот способ, если хотите, чтобы инструменты AdMob были доступны в Claude.ai на любом устройстве, а не только в Claude Code на вашем ноутбуке.

1. Сделайте форк репозитория.

2. Нажмите Deploy with Vercel выше.

3. Подготовьте Upstash Redis на вкладке Vercel Storage — он автоматически внедрит переменные окружения KV_*, которые использует наш код. (Vercel объявил устаревшим автономный "Vercel KV"; Upstash использует тот же бэкенд.)

4. Создайте клиент Google Cloud OAuth (Web app). Авторизованный URI перенаправления = https://<your-deploy>.vercel.app/api/oauth/callback.

5. Установите переменные окружения в Vercel: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, OAUTH_REDIRECT_URI, CONNECTOR_TOKEN (сгенерируйте с помощью openssl rand -hex 32). Следите за отсутствием лишних пробелов.

6. Посетите https://<your-deploy>.vercel.app/api/setup, вставьте CONNECTOR_TOKEN, нажмите Authorize и завершите вход в Google. Это авторизует сервер для чтения данных AdMob от вашего имени.

7. В Claude.ai → Settings → Connectors → Add custom connector: вставьте https://<your-deploy>.vercel.app/api/mcp в качестве URL, оставьте OAuth Client ID и Secret пустыми, нажмите Add, затем нажмите Connect. Откроется вкладка браузера по адресу /oauth/authorize — вставьте тот же CONNECTOR_TOKEN один раз. Claude.ai сделает все остальное.

Два потока OAuth защищены одним и тем же CONNECTOR_TOKEN: Google ↔ сервер (шаг 6) и Claude.ai ↔ сервер (шаг 7). Полное руководство, включая устранение неполадок: docs/VERCEL.md.

Использование

Просто задайте Claude вопрос о ваших данных AdMob на естественном языке. При первом использовании Claude автоматически вызовет list_accounts, чтобы обнаружить ваши аккаунты AdMob и спросить, с каким из них вы хотите работать. После этого он будет использовать соответствующие инструменты для ответов на ваши вопросы.

Инструменты

Основные инструменты API

Инструменты отчетности

Инструменты оптимизации дохода

Структура проекта

• src/index.ts — точка входа stdio (Claude Code).

• src/tools.ts — все 36 определений инструментов; registerTools(server, getClient).

• src/auth.ts — помощники Google OAuth (getAuthenticatedClient, authorizeViaLocalServer).

• src/token-store.ts — интерфейс TokenStore + FileTokenStore (локально) + KvTokenStore (Vercel KV).

• src/oauth-store.ts — хранилище на базе KV для потока OAuth коннектора (коды авторизации + токены доступа).

• src/http-auth.ts — проверка bearer-токена с защитой от тайминговых атак для HTTP-эндпоинтов (синхронизация с CONNECTOR_TOKEN, асинхронная проверка с токенами доступа, выданными KV).

• src/admob-client.ts, src/helpers.ts — REST-клиент и утилиты форматирования отчетов.

• api/mcp.ts — функция Vercel: HTTP MCP-эндпоинт (Streamable HTTP, защищен bearer-токеном, выдает WWW-Authenticate при 401).

• api/setup.ts — функция Vercel: форма, которая инициирует поток OAuth Google ↔ сервер.

• api/oauth/callback.ts — функция Vercel: URI перенаправления Google; сохраняет токены в KV.

• api/oauth/authorize.ts, api/oauth/token.ts, api/oauth/register.ts — функции Vercel, реализующие поток OAuth 2.1 Claude.ai ↔ сервер с PKCE и динамической регистрацией клиента.

• api/well-known/oauth-authorization-server.ts, api/well-known/oauth-protected-resource.ts — метаданные RFC 8414 / RFC 9728, чтобы Claude.ai мог обнаружить эндпоинты OAuth.

• setup.sh — интерактивный скрипт настройки ([L]ocal / [V]ercel / [B]oth).

• docs/VERCEL.md — руководство по развертыванию для форков.

• AGENTS.md — канонические заметки по проекту (CLAUDE.md является символической ссылкой на него).

Разработка

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