AppLovin 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 (рекомендовано)

# на вашому 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 не потрібно.