Довідка

ШІ-асистент (MCP)

Що це таке

MCP (Model Context Protocol) — стандартний спосіб дати ШІ-асистенту — Claude та іншим MCP-клієнтам — інструменти для роботи з вашим софтом. Orbitra постачається з MCP-сервером, тож після одноразового підключення ви можете просто написати асистенту:

«Як мої кампанії працювали за останні 7 днів? Яка з них втратила гроші?»
«Покажи вчорашні конверсії кампанії Keto DE за країнами.»
«Створи 5 кампаній для оффера #4 — по одній на GEO: DE, AT, CH, FR, IT — на домені go.example.com.»
«Додай домен promo.example.com і постав кампанію 12 на його корінь.»
«Які креативи мали ROI нижче нуля цього тижня?»

Асистент викликає API трекера за вас: читає статистику, будує звіти, створює та редагує кампанії, оффери, домени, джерела трафіку і лендинги (41 інструмент загалом). Він бачить лише те, що дозволяє ваш API-ключ.

Ключ read чи ключ write?

Ключі створюються в ⚙ → Users → число в колонці API keys користувача → Read key або Write key.

Створення API-ключа
Створення API-ключа
КлючМоже
ReadТільки дивитися: метрики, списки, звіти, конверсії. Фізично не може нічого змінити — безпечно починати з нього
WriteУсе, що вміє Read, плюс створювати, редагувати та видаляти кампанії, оффери, домени, джерела, лендинги

Починайте з ключа Read. Якщо попросити асистента з ключем Read щось змінити, він відповість 403 API key is read-only — тоді створіть ключ Write.

Підключення — варіант A: посилання (найпростіше)

Працює в застосунках Claude (веб, десктоп, мобільний), нічого встановлювати не треба.

  1. Створіть ключ (дивіться вище) і натисніть іконку посилання поруч — скопіюється готовий URL типу https://track.example.com/mcp.php?k=YOUR_KEY.
  2. У Claude: Settings → Connectors → Add custom connector, вставте URL, дайте назву (Orbitra), Add.
  3. У новому чаті спитайте «Ping my Orbitra tracker» — асистент має відповісти версією вашого трекера.

🔑 Ключ — усередині посилання, тож ставтеся до нього як до пароля: не публікуйте його ніде. Щоб відібрати доступ, видаліть ключ — посилання перестане працювати миттєво.

Сторінка ⚙ → AI / MCP показує ті самі інструкції з уже вписаною адресою вашого трекера.

Сторінка AI / MCP
Сторінка AI / MCP

Підключення — варіант B: локальний сервер для Claude Desktop

Для тих, хто вважає за краще тримати сервер на власному комп'ютері. Потрібні Node.js і копія репозиторію Orbitra.

  1. У репозиторії: cd mcp && npm install.
  2. У Claude Desktop: Settings → Developer → Edit Config і додайте:
{
  "mcpServers": {
    "orbitra": {
      "command": "/usr/local/bin/node",
      "args": ["/absolute/path/to/Orbitra/mcp/src/index.js"],
      "env": {
        "ORBITRA_URL": "https://track.example.com",
        "ORBITRA_API_KEY": "your-api-key"
      }
    }
  }
}
  1. Повністю закрийте Claude Desktop (⌘Q на Mac) і запустіть знову.

Кнопка Copy config у вікні API-ключів дає вам цей блок з вашою адресою. Якщо сервер не з'явився: використайте абсолютний шлях до node (which node його покаже), перевірте, що npm install виконався, і перевірте ключ через ORBITRA_URL=… ORBITRA_API_KEY=… npm run smoke -- --ping.

Хороші промпти

Безпека

Довідка: MCP, REST API.

← Попередній
Гео-бази даних
Наступний →
Швидкий старт: ваша перша кампанія
Переглянути джерело на GitHub: github.com/fenjo26/Orbitra.link/wiki
Усі гайди
Довідка

Шпаргалка з метрик

Кожна колонка звітів в Orbitra з її формулою: CR, CPC, CPA, ROI, EPC та інші.

Читати гайд →
Довідка

Глосарій абревіатур

Терміни афілейт-маркетингу та абревіатури, пояснені простими словами.

Читати гайд →
Довідка

Гео-бази даних

Встановіть Sypex Geo, MaxMind та IP2Location і дізнайтеся, чому кращі гео-дані покращують клоакинг.

Читати гайд →
Довідка

ШІ-асистент (MCP)

Підключіть Claude або інший ШІ-асистент до трекера через MCP і керуйте ним звичайними словами.

Читати гайд →