MCP: ШІ-асистент у трекері
Починаючи з версії 0.9.5.0, можна підключити ШІ-асистента (Claude Desktop та інші MCP-клієнти) до Orbitra через MCP-сервер — він живе в папці mcp/. Після підключення трекером можна керувати звичайною мовою:
«Як мої кампанії працювали за останні 7 днів?»
«Створи 10 кампаній для оффера #4 — по одній на GEO: US, CA, GB, DE, FR.»
«Додай домен track.example.com і постав кампанію 12 на його корінь.»
Сервер говорить із вашим трекером по HTTPS, використовуючи персональний API-ключ. У себе він нічого не зберігає, а ключі лише для читання фізично не можуть змінювати дані.
Як це працює
Claude Desktop ──stdio──► mcp/src/index.js ──HTTPS + API key──► ваш Orbitra (api.php)
MCP-сервер — тонкий клієнт над звичайним API трекера (api.php). Він просто загортає API-дії в інструменти, зрозумілі ШІ, і додає захист (ключі для читання не можуть писати).
Крок 1. Отримайте API-ключ
У панелі: ⚙ → AI / MCP або ⚙ → Users → API keys (ключі створює адміністратор).
- Read key — лише аналітика (метрики, списки, звіти).
- Write key — плюс керування (створення/редагування/видалення кампаній, офферів, доменів…).
Ключ показується один раз — скопіюйте його.
Крок 2. Встановіть залежності
При встановленні через install.sh залежності MCP ставляться автоматично. Вручну:
cd mcp
npm install
Самоперевірка (запускає сервер і друкує список інструментів; живий трекер не потрібен):
npm run smoke
Перевірка на живому трекері:
ORBITRA_URL=https://tracker.example.com ORBITRA_API_KEY=your_key npm run smoke -- --ping
Крок 3. Підключіть Claude Desktop
Конфігураційний файл Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Варіант A. Підключення за URL (з версії 0.9.6.2)
Найшвидший варіант, і єдиний, що працює у браузерній версії Claude: трекер сам роздає MCP по HTTP через mcp.php.
- ⚙ → Users → API keys — створіть ключ (Read — лише аналітика, Write — плюс керування).
- Клацніть кнопку-посилання біля ключа — готовий URL скопіюється в буфер обміну:
https://ваш-трекер.example.com/mcp.php?k=ВАШ_КЛЮЧ
- У Claude: Settings → Connectors → Add custom connector, вставте URL, задайте назву, «Add».
Нічого встановлювати не треба — ані Node, ані репозиторій на своїй машині.
🔑 Ключ їде прямо в URL, бо в діалозі коннектора немає поля для ключа і підтримується лише OAuth. Ставтеся до такого URL як до пароля: не публікуйте його, а щоб відібрати доступ, видаліть ключ у ⚙ → Users → API keys — URL перестане працювати негайно. Ключ для читання фізично не може нічого змінити.
Як це працює. mcp.php реалізує безсесійний MCP Streamable HTTP: кожен POST — самодостатній обмін JSON-RPC. Список інструментів береться з mcp/tools.json, який генерується з Node-сервера (node mcp/src/manifest.js), тож обидва типи підключення показують точно той самий набір із 41 інструменту. Виклик інструмента виконується як короткий CLI-процес cli/api_invoke.php — трекер не викликає сам себе по HTTP, що на VPS із двома PHP-FPM-воркерами інакше могло б заблокувати весь сайт.
Вимоги: PHP CLI (уже потрібен для cron) і дозволений proc_open. Якщо proc_open вимкнено в php.ini, ендпоінт скаже про це прямим текстом — використовуйте тоді варіант B. Шлях до PHP можна задати вручну налаштуванням mcp_php_binary.
Варіант B. Локальний сервер для Claude Desktop
⚠️ Це не діалог «Add custom connector». Розділ Connectors у Claude приймає лише віддалені MCP-сервери по HTTPS і авторизує їх через OAuth — саме тому там немає поля для API-ключа. Сервер Orbitra працює через stdio: він стартує локально поруч із асистентом і реєструється в конфіг-файлі нижче. URL трекера, вставлений у діалог коннектора, не запрацює.
Файл можна відкрити прямо із застосунку: Settings → Developer → Edit Config.
Додайте сервер orbitra (використайте абсолютний шлях до mcp/src/index.js):
{
"mcpServers": {
"orbitra": {
"command": "/usr/local/bin/node",
"args": ["/absolute/path/to/Orbitra/mcp/src/index.js"],
"env": {
"ORBITRA_URL": "https://tracker.example.com",
"ORBITRA_API_KEY": "ваш-api-ключ"
}
}
}
}
Повністю перезапустіть Claude Desktop (⌘Q на macOS) — інструменти Orbitra з'являться в списку. Закрити вікно недостатньо; конфіг читається лише при старті.
Якщо сервер не з'явився:
- Шлях до Node. У
commandпотрібен абсолютний шлях: застосунок стартує не з вашого шелла, тож Node із nvm або Homebrew ніколи не потрапляє в йогоPATH, і сервер мовчки не запускається. Знайдіть шлях черезwhich node(macOS/Linux) абоwhere node(Windows). - Залежності не встановлені.
cd mcp && npm install. - Неправильний ключ або URL. Перевірте окремо:
ORBITRA_URL=... ORBITRA_API_KEY=... npm run smoke -- --ping. 403 API key is read-onlyпри створенні або оновленні — потрібен ключ Write; ключ Read повертає лише аналітику.
Інструменти (41)
Читання: orbitra_ping, orbitra_get_metrics, orbitra_get_chart, orbitra_list_campaigns, orbitra_campaigns_stats, orbitra_get_campaign, orbitra_campaign_report, orbitra_list_offers, orbitra_get_offer, orbitra_all_offers, orbitra_list_domains, orbitra_ssl_environment, orbitra_get_integration_code, orbitra_list_app_configs, orbitra_telegram_status, orbitra_integrations_status, orbitra_list_traffic_sources, orbitra_list_landings, orbitra_list_affiliate_networks, orbitra_list_conversions, orbitra_recent_clicks, orbitra_system_status.
Керування (потрібен ключ write): orbitra_create_campaign, orbitra_update_campaign, orbitra_bulk_create_campaigns, orbitra_bulk_set_campaign_domain, orbitra_delete_campaign, orbitra_copy_campaign, orbitra_create_offer, orbitra_update_offer, orbitra_delete_offer, orbitra_create_domain, orbitra_delete_domain, orbitra_check_domain_dns, orbitra_reissue_ssl, orbitra_run_ssl_worker, orbitra_save_app_config, orbitra_create_traffic_source, orbitra_list_traffic_source_templates, orbitra_create_landing.
Розширені: orbitra_api_request — виклик будь-якої дії api.php напряму (запасний варіант).
Великі акаунти. orbitra_list_campaigns і orbitra_list_domains повертають компактні списки (id, name, alias, domain, link) із фільтрами за діапазоном ID і доменом та пагінацією — відповідь лишається маленькою навіть із тисячами кампаній. Статистика по всіх кампаніях береться з orbitra_campaigns_stats (важка відповідь), по одній кампанії — orbitra_campaign_report. Щоб змінити домен багатьох кампаній одразу — orbitra_bulk_set_campaign_domain: змінюється лише домен, потоки та постбеки не чіпаються, а відповідь несе старе й нове посилання кожної кампанії. orbitra_update_campaign зберігає ID потоків, їхні назви, логіку фільтрів, вибір офферів і Bot Challenge.
Повний довідник параметрів — у mcp/README.md.
Безпека
- Ставтеся до API-ключа як до пароля. За замовчуванням використовуйте ключ read; write — лише коли потрібне керування.
- Ключ іде тільки на ваш
ORBITRA_URL(заголовкиAuthorization: Bearer/X-Api-Key). - Дії запису йдуть через звичайний API і потрапляють в audit-логи, як будь-яка інша операція.
- Ключ read отримує
403на спроби запису і нічого не змінює. ORBITRA_INSECURE=1вимикає перевірку TLS — лише для локальної розробки.
Оновлення
MCP постачається з проєктом, тож звичайне оновлення (⚙ → Update або git pull) підтягує нові файли автоматично. Після оновлення, що змінило залежності, виконайте cd mcp && npm install. Якщо список інструментів змінився у новій версії, перепідключіть коннектор у клієнті, щоб він перечитав інструменти.
Швидкий старт: ваша перша кампанія
Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.
Читати гайд →ДокументаціяВстановлення та оновлення
Встановіть Orbitra на чистий сервер Ubuntu або Debian однією командою та безпечно оновлюйтеся до нових версій.
Читати гайд →ДокументаціяМіграція з Keitaro
Перенесіть кампанії, оффери, джерела та домени з Keitaro в Orbitra одним імпортом — що переноситься і що перевірити після нього.
Читати гайд →ДокументаціяМіграція з Binom
Перенесіть кампанії та потоки з Binom у Orbitra через Public API: що переноситься автоматично, а що налаштувати вручну.
Читати гайд →ДокументаціяОгляд можливостей
Усе, що вміє Orbitra: кампанії та потоки, клоакинг, лендинги, PWA, постбеки, витрати, звіти та інтеграції.
Читати гайд →ДокументаціяКампанії та потоки
Повна довідка: налаштування кампаній, типи потоків, схеми, ротація, фільтри, тестові посилання та кожна опція з поясненням.
Читати гайд →ДокументаціяКлоакинг
Повна довідка з клоакингу: шари детекції, глобальні налаштування, фільтри потоку, вердикти та звіти.
Читати гайд →ДокументаціяПеревірка браузера
Як JS-перевірка ловить ботів, віртуальні машини та емулятори за суперечностями в браузерному оточенні.
Читати гайд →ДокументаціяЛендинги
Типи лендингів, макрос {offer}, JS-адаптер, LeadForge та мультиофферні лендинги — повна довідка.
Читати гайд →ДокументаціяPWA та Web Push
Створюйте встановлювані PWA-застосунки та збирайте push-підписників: налаштування, іконки, події та сповіщення.
Читати гайд →ДокументаціяPWA-воронка
Воронка візиту на PWA-лендинг: екрани до встановлення, трекінг кожного екрана, статистика показів і матриця переходів.
Читати гайд →ДокументаціяКонверсійні попапи
Попап із кнопкою оффера на лендингах: вкладка Popup, вертикальні шаблони, тригери показу і метрики показів та CTR.
Читати гайд →ДокументаціяЗаписи сесій і теплові карти
Реплеї реальних візитів, теплові карти кліків і скролу, ліміти сховища, приватність і запис цілих сайтів.
Читати гайд →ДокументаціяГалерея контенту
Повна довідка Галереї: папки, завантаження, MediaPicker у редакторах, контракти розміру, обмеження форматів і відео.
Читати гайд →ДокументаціяБібліотека креативів
Креативи з витратами, доходом і ROI: синк файлів з Facebook і TikTok, дедуплікація, звіти і алерт вигорання креативів.
Читати гайд →ДокументаціяЗовнішні PWA та Telegram-канали
Сторонні PWA-сервіси як цілі потоків (/eflow) і Telegram-канали як оффери: funnel-бот, вступи-конверсії та атрибуція.
Читати гайд →ДокументаціяПостбеки та конверсії
Вхідні постбеки, статуси й типи конверсій, вихідні S2S-постбеки на джерело, черга доставки, тестер і імпорт конверсій.
Читати гайд →ДокументаціяВитрати
Імпорт витрат з Facebook, TikTok, Google Ads і push/pop-мереж, розподіл по кліках, агентські комісії та агрегатор доходу.
Читати гайд →ДокументаціяPush- і pop-мережі
Імпорт витрат із push/pop-мереж і Zone Killer: правила, що знаходять і блокують зони, які палять бюджет.
Читати гайд →ДокументаціяFacebook / Meta
Імпорт витрат з Meta Ads і Conversions API: токени, мапінг статусів, серверні події з дедуплікацією і діагностика.
Читати гайд →ДокументаціяDolphin / Fbtool
Отримуйте витрати Facebook у трекер через API Dolphin (Fbtool) у реальному часі: API-ключ, налаштування сервісів і розподіл витрат по кліках.
Читати гайд →ДокументаціяЧистильник коментарів FB
Масова модерація коментарів під рекламою Meta за розкладом: набори правил, винятки, сухий прогін, журнал дій і авто-пауза.
Читати гайд →ДокументаціяДжерела трафіку та партнерські мережі
Два довідники, що налаштовують «краї» воронки: шаблони джерел і мереж, параметри, постбек у джерело та офферні параметри.
Читати гайд →ДокументаціяЗвіти, логи та метрики
Дашборд, список кампаній, конструктор звітів, тренди й когорти, лог трафіку та картка кліка — і як рахується кожна метрика.
Читати гайд →ДокументаціяДомени та SSL
Додайте домени, наведіть DNS на сервер, отримайте безкоштовний сертифікат Let's Encrypt і розберіться з кожним перемикачем на сторінці Domains.
Читати гайд →ДокументаціяCloudflare
Інтеграція з Cloudflare через API: A-записи ставляться автоматично, а з проксі SSL роздає Cloudflare — без certbot і очікування валідації.
Читати гайд →ДокументаціяАдміністрування
Користувачі, ролі та права по ресурсах, налаштування безпеки, гео-бази, оновлення панелі й розширення Ads Manager.
Читати гайд →ДокументаціяTelegram-бот
Керуйте трекером із Telegram: статистика, конверсії та сповіщення в чаті, вебхук або поллінг і алерти в канали.
Читати гайд →ДокументаціяMCP: ШІ-асистент у трекері
Підключіть Claude або будь-який MCP-клієнт до Orbitra й керуйте кампаніями, офферами та доменами звичайними словами.
Читати гайд →