AppLovin MCP Server

MCP-сервер, який дає Claude доступ до вашого AppLovin/Axon акаунту: монiторинг результатів (Reporting API), завантаження креативів і керування кампаніями (Axon Campaign Management API).

Що вміє

Ключі беруться лише зі змінних середовища сервера — Claude ніколи не бачить і не вводить ваш API-ключ, він тільки викликає інструменти.

Related MCP server: Meta Ads MCP Server

1. Розгортання на VPS

Варіант А: Docker (рекомендовано)

# на вашому VPS
git clone <ваш-репозиторій-або-скопіюйте-цю-папку> applovin-mcp-server
cd applovin-mcp-server
cp .env.example .env
nano .env   # впишіть свої ключі, див. розділ "Де взяти ключі" нижче

docker build -t applovin-mcp .
docker run -d --name applovin-mcp \
  --env-file .env \
  -p 3000:3000 \
  --restart unless-stopped \
  applovin-mcp

Варіант Б: напряму через Node.js

# потрібен Node.js 20+
cd applovin-mcp-server
npm install
npm run build
cp .env.example .env
nano .env

# запуск через pm2, щоб сервер жив після розлогінення
npm install -g pm2
pm2 start dist/index.js --name applovin-mcp
pm2 save
pm2 startup   # виконайте команду, яку виведе pm2

Обов'язково: HTTPS

Claude.ai вимагає HTTPS для кастомних MCP-конекторів. Найпростіше — поставити Nginx/Caddy як реверс-проксі з Let's Encrypt перед портом 3000.

Приклад Caddyfile (Caddy сам візьме сертифікат):

mcp.your-domain.com {
    reverse_proxy localhost:3000
}

2. Де взяти ключі AppLovin

Report Key (у вас вже є): Axon dashboard → акаунт (правий верхній кут) → Keys → Report Key

Campaign Management API key + Account ID (додасте пізніше):

• Axon dashboard → акаунт → Keys → Campaign Management API key

• Axon dashboard → акаунт → Go to settings → Account ID — це число після назви акаунту

Поки цих двох немає в .env, інструменти для креативів і кампаній повертатимуть зрозумілу помилку з поясненням, а звітність вже працюватиме.

3. Підключення до Claude.ai

1. Claude.ai → Settings → Connectors → Add custom connector

2. URL: https://mcp.your-domain.com/mcp

3. Якщо ви задали MCP_SERVER_TOKEN в .env — Claude.ai запитає токен авторизації (Bearer token), вкажіть те саме значення.

4. Збережіть, увімкніть конектор у чаті — і інструменти applovin_* стануть доступні.

4. Безпека

• Обов'язково задайте MCP_SERVER_TOKEN — без нього будь-хто, хто дізнається URL сервера, зможе керувати вашими кампаніями.

• Тримайте .env поза git (уже в .gitignore).

• Дії, що витрачають бюджет (create_campaign, create_or_update_creative_set, update_campaign з активацією/збільшенням бюджету), позначені як destructiveHint: true — Claude завжди підтверджує їх з вами перед виконанням.

5. Оновлення після додавання Campaign Management ключа

Просто допишіть APPLOVIN_CAMPAIGN_API_KEY і APPLOVIN_AXON_ACCOUNT_ID у .env на сервері й перезапустіть:

docker restart applovin-mcp
# або
pm2 restart applovin-mcp

Нові інструменти одразу стануть активними — переустановлювати конектор у Claude.ai не потрібно.