Документація

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 (ключі створює адміністратор).

Ключ показується один раз — скопіюйте його.

Крок 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:

Варіант A. Підключення за URL (з версії 0.9.6.2)

Найшвидший варіант, і єдиний, що працює у браузерній версії Claude: трекер сам роздає MCP по HTTP через mcp.php.

  1. ⚙ → Users → API keys — створіть ключ (Read — лише аналітика, Write — плюс керування).
  2. Клацніть кнопку-посилання біля ключа — готовий URL скопіюється в буфер обміну:
https://ваш-трекер.example.com/mcp.php?k=ВАШ_КЛЮЧ
  1. У 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 з'являться в списку. Закрити вікно недостатньо; конфіг читається лише при старті.

Якщо сервер не з'явився:

Інструменти (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.

Безпека

Оновлення

MCP постачається з проєктом, тож звичайне оновлення (⚙ → Update або git pull) підтягує нові файли автоматично. Після оновлення, що змінило залежності, виконайте cd mcp && npm install. Якщо список інструментів змінився у новій версії, перепідключіть коннектор у клієнті, щоб він перечитав інструменти.

← Попередній
Telegram-бот
Усі гайди →
Вікі Orbitra
Переглянути джерело на GitHub: github.com/fenjo26/Orbitra.link/wiki
Усі гайди
Документація

Швидкий старт: ваша перша кампанія

Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.

Читати гайд →
Документація

Встановлення та оновлення

Встановіть 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 й керуйте кампаніями, офферами та доменами звичайними словами.

Читати гайд →