Довідник MCP-сервера #

Revolink підтримує Model Context Protocol (MCP): відкритий стандарт, що дає AI-асистентам (Claude, Cursor, Windsurf та іншим) змогу працювати із зовнішніми сервісами як з інструментами.

Після налаштування ваш AI-асистент зможе створювати посилання, змінювати правила маршрутизації й отримувати аналітику, а вам не доведеться виходити з чату.

Ендпоінт #

POST https://api.revolink.link/apiv1/mcp

Транспорт: Streamable HTTP (без стану, один запит на виклик інструмента).

Автентифікація #

MCP Revolink підтримує два способи підключення. Оберіть той, що вам підходить:

Спосіб 1 — API-ключ #

Згенеруйте ключ у Профіль → Інтеграції, увімкніть потрібні дозволи (scopes) MCP і передайте його в конфігурації клієнта. Інструкції для кожного клієнта дивіться нижче в розділі Налаштування.

Помилки:

Спосіб 2 — OAuth 2.0 #

Для клієнтів на кшталт claude.ai (веб), що підтримують OAuth: ключ не потрібен. Ви один раз підтверджуєте доступ, а клієнт робить усе решту автоматично.

Як підключитися (claude.ai у вебі):

1. Перейдіть у Settings → Integrations у claude.ai.
2. Натисніть Add MCP server.
3. Вставте: https://api.revolink.link/apiv1/mcp
4. Натисніть Connect: вас буде перенаправлено до Revolink, щоб підтвердити доступ.
5. Готово. Інструменти Revolink тепер доступні у вашому чаті.

Щоб будь-коли скасувати доступ: Профіль → Підключені застосунки → Скасувати.

Дозволи MCP #

Дозволи MCP відокремлені від звичайних дозволів API. Ключ може мати повний доступ до API, але нульовий доступ до MCP, або навпаки. Доступні дозволи (scopes):

Для автентифікації за API-ключем дозволи налаштовуються для кожного ключа в застосунку: Профіль → Інтеграції → MCP.

Для OAuth дозволи запитує клієнт, а користувач підтверджує їх під час процесу надання згоди.

Налаштування #

API-ключ: крок за кроком #

1. Перейдіть у Профіль → Інтеграції в застосунку Revolink.
2. Натисніть Створити API-ключ.
3. Дайте ключу назву (наприклад, Claude MCP).
4. У розділі MCP увімкніть дозволи, які хочете надати. Кожен дозвіл вмикається окремо.
5. Натисніть Створити й скопіюйте ключ: він показується лише один раз.

Ключ із увімкненим MCP, але без вибраних дозволів MCP, буде відхилено на ендпоінті MCP з помилкою 403.

Налаштування AI-клієнта (API-ключ) #

{
  "mcpServers": {
    "revolink": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.revolink.link/apiv1/mcp",
        "--header",
        "X-Api-Key:YOUR_API_KEY"
      ]
    }
  }
}

claude mcp add --transport http revolink https://api.revolink.link/apiv1/mcp \
  --header "X-Api-Key: YOUR_API_KEY"

{
  "mcpServers": {
    "revolink": {
      "type": "http",
      "url": "https://api.revolink.link/apiv1/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "revolink": {
      "url": "https://api.revolink.link/apiv1/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "servers": {
    "revolink": {
      "type": "http",
      "url": "https://api.revolink.link/apiv1/mcp",
      "headers": {
        "X-Api-Key": "${input:revolinkApiKey}"
      }
    }
  },
  "inputs": [
    {
      "id": "revolinkApiKey",
      "type": "promptString",
      "description": "Revolink API Key",
      "password": true
    }
  ]
}

{
  "context_servers": {
    "revolink": {
      "settings": {
        "url": "https://api.revolink.link/apiv1/mcp",
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

Налаштування AI-клієнта (OAuth) #

https://api.revolink.link/apiv1/mcp

Робочі простори: автоматичний вибір #

Вам ніколи не потрібно вказувати ID робочого простору вручну. Якщо ви надсилаєте запит без вибраного робочого простору, сервер повертає список ваших доступних робочих просторів. AI вибирає потрібний за контекстом, а потім автоматично продовжує операцію. Для вас це непомітно: просто опишіть звичайною мовою, що вам потрібно.

Доступні інструменти #

list_links #

Повертає список посилань робочого простору з розбиттям на сторінки.

Потрібний дозвіл: links:read

get_link #

Повертає повну інформацію про одне посилання, зокрема його правила маршрутизації.

Потрібний дозвіл: links:read

create_link #

Створює нове смарт-посилання з правилами маршрутизації.

Потрібний дозвіл: links:write

Приклад запиту:

«Створи посилання "Product Hunt Launch", яке відправляє відвідувачів із комп'ютерів на десктопну лендінг-сторінку, а відвідувачів із телефонів на мобільну.»

update_link #

Оновлює наявне посилання. Вказуйте лише ті поля, які хочете змінити.

Потрібний дозвіл: links:write

Ті самі параметри, що й у create_link, а також:

Коли передано rules, увесь масив правил замінюється. Вказуйте всі правила, які хочете залишити, а не лише змінені. AI внутрішньо отримує наявні ID правил перед оновленням.

delete_link #

Остаточно видаляє посилання.

Потрібний дозвіл: links:delete

bulk_create_links #

Створює кілька посилань одним запитом. Підпадає під квоту тарифу на посилання.

Потрібний дозвіл: links:bulk

Відповідь містить масиви created (успішні) і failed (невдалі, із причиною), тож можливий частковий успіх.

get_link_analytics #

Повертає аналітику кліків для одного посилання за країною, пристроєм, браузером, ОС, правилом маршрутизації та A/B-варіантом.

Потрібний дозвіл: analytics:read

get_workspace_analytics #

Повертає зведену аналітику кліків по всіх посиланнях робочого простору.

Потрібний дозвіл: analytics:read

Об'єкт правила #

Кожне посилання має мати щонайменше одне правило. Рівно одне правило має мати isDefault: true: це резервне правило, коли умови жодного іншого не збігаються. Правило за замовчуванням не може мати жодних умов.

Об'єкт A/B-тесту #

Коли abTest.enabled має значення true, кліки діляться між варіантами відповідно до їхніх ваг. Правила маршрутизації все одно застосовуються першими: A/B-поділ відбувається лише для відвідувачів, яких підібрало певне правило.

Варіант:

Обробка помилок #

MCP-сервер повертає стандартні помилки JSON-RPC. Помилки рівня інструмента використовують такі коди:

Помилки рівня HTTP (до виклику інструмента):

Приклади викликів інструментів #

Список ваших посилань:

«Покажи всі посилання в моєму робочому просторі з тегом summer-sale.»

Створення посилання з геотаргетингом:

«Створи посилання "App Download". iOS-користувачів відправ в App Store, користувачів Android у Google Play, а всіх інших на сайт.»

Зміна правил маршрутизації:

«Онови посилання 664a1b2c…: додай правило, що перенаправляє відвідувачів із Німеччини на https://de.example.com.»

Аналітика за минулий тиждень:

«Які країни були в топі для посилання 664a1b2c… минулого тижня?»