# AppLovin MCP Server

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

## Що вміє

| Інструмент | Що робить | Потребує |
|---|---|---|
| `applovin_get_report` | Звіти по кампаніях/монетизації (impressions, cost, revenue...) | `APPLOVIN_REPORT_KEY` |
| `applovin_list_assets` | Список завантажених креативів | Campaign Management ключ |
| `applovin_upload_assets` | Завантажити нові креативи (URL або base64) | Campaign Management ключ |
| `applovin_get_upload_result` | Перевірити статус обробки завантаження | Campaign Management ключ |
| `applovin_create_or_update_creative_set` | Створити/оновити набір креативів і прив'язати до кампанії | Campaign Management ключ |
| `applovin_clone_creative_set` | Клонувати набір креативів в іншу кампанію | Campaign Management ключ |
| `applovin_remove_creative_set_from_campaigns` | Зняти креативи з показу | Campaign Management ключ |
| `applovin_create_campaign` | Створити нову кампанію | Campaign Management ключ |
| `applovin_update_campaign` | Змінити бюджет/таргетинг/паузу кампанії | Campaign Management ключ |

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

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

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

```bash
# на вашому 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

```bash
# потрібен 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` на сервері й перезапустіть:

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

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