leadli.meby solo lemon.
Увійти

MCP · Streamable HTTP

MCP-сервер: довідник інструментів

Оновлено 11 листопада 20266 хв

Керуйте каналами, ботами, атрибуцією та лендингами через AI-асистента. Нижче наведені точні імена інструментів, їхні задачі та типи вхідних параметрів.

У цьому гайді
  1. Підключення й авторизація
  2. Приклади запитів
  3. Як читати довідник
  4. Контекст, канали й аналітика
  5. Репорти й модерація
  6. Telegram-канали й боти
  7. Підключення Meta й TikTok
  8. Лендинги й browser SDK
  9. Telegram-сповіщення
  10. Приклад виклику й відповіді
  11. Дані, обмеження та підтримка
  12. Короткі відповіді
  13. Першоджерела

Підключення й авторизація

Транспорт: Streamable HTTP. Заголовок: Authorization: Bearer YOUR_LEADLI_ME_ACCESS_KEY. Створіть ключ у Organization settings → Access keys та зберігайте його в конфігурації MCP-клієнта. Він не потрібен у HTML лендингу.

Приклади запитів

Ці приклади читають дані. Якщо каналів або подій немає, асистент має сказати про це, а не вигадувати результат.

  1. 1

    Перевірити підключення

    Запит: "Покажи мої канали leadli.me та поясни доступні дозволи. Нічого не змінюй." Інструменти: leadli_get_context, leadli_list_channels. Очікувано: організація ключа, дозволи й доступні канали.

  2. 2

    Переглянути аналітику

    Запит: "Для вибраного каналу покажи кліки, підтверджені вступи та доставлені конверсії за останні 7 днів у UTC." Інструменти: leadli_get_context, leadli_list_channels, leadli_get_analytics. Очікувано: агрегати за погоджений інтервал із поясненням click-time cohorts.

  3. 3

    Перевірити налаштування

    Запит: "Перевір, чи готовий вибраний канал до активації, і переліч відсутні кроки. Нічого не змінюй." Інструменти: leadli_get_context, leadli_list_channels, leadli_get_setup_status. Очікувано: поточні перевірки ready та незавершені налаштування.

Як читати довідник

Розгорніть інструмент, щоб побачити всі параметри та їхні типи. Обов'язкові поля позначені окремо. Імена та типи перевірено за поточним MCP-сервером 11 листопада 2026.

  • targetId є внутрішнім ID каналу або бота з leadli_list_channels; leadId є ID спостережуваного підписника. Не підставляйте Telegram username замість ID.
  • from і to задають час у UTC. Для списку вступів інтервал включає from і не включає to. Пагінація page починається з 1; типові page/limit: 1/20, максимум limit: 100.
  • Перед зміною налаштувань або модерацією підтвердьте з користувачем канал, людину та наслідок. Не показуйте інтеграційні токени й botKey у відповідях. Секрети, передані асистенту для налаштування, потрапляють у контекст його провайдера.

Контекст, канали й аналітика

#
leadli_get_contextПовертає організацію ключа, фактичні дозволи, доступні інструменти та доступ за планом.

Вхідні параметри

Без параметрів. Передайте порожній об'єкт {}.

#
leadli_list_channelsПовертає сторінку списку каналів, доступних автору ключа.

Вхідні параметри

limitнеобов'язково
number
pageнеобов'язково
number
#
leadli_get_channelПовертає деталі каналу й безпечні метадані налаштування Telegram.

Вхідні параметри

targetIdобов'язково
string
#
leadli_get_analyticsПовертає агрегати атрибуції. Кліки, підтверджені вступи та доставлені конверсії згруповані за часом кліку; membershipFlow рахується за часом спостережуваних подій. Межі hour/day/week: 31/90/365 днів; розрізи доступні для 7/31/90 днів.

Вхідні параметри

fromобов'язково
string
granularityнеобов'язково
"hour" | "day" | "week"
targetIdобов'язково
string
toобов'язково
string
#
leadli_list_joinsПовертає спостережувані вступи та повторні вступи в UTC-інтервалі [from,to), до 365 днів. Фільтри застосовуються до пагінації. Відсутність рекламної атрибуції не доводить органічний трафік. Membership відображає поточний спостережуваний стан. landingId дорівнює точному ключу landingPageUrl з аналітики.

Вхідні параметри

adIdнеобов'язково
string
adSetIdнеобов'язково
string
campaignIdнеобов'язково
string
cursorнеобов'язково
string
fromобов'язково
string
landingIdнеобов'язково
string
limitнеобов'язково
number
sourceнеобов'язково
"all" | "ad" | "invite_link" | "none"
targetIdобов'язково
string
toобов'язково
string
#
leadli_list_subscribersПовертає лише спостережуваних підписників, а не повний склад Telegram-каналу. Membership відображає поточний спостережуваний стан.

Вхідні параметри

limitнеобов'язково
number
pageнеобов'язково
number
statusнеобов'язково
"active" | "former" | "all"
targetIdобов'язково
string

Репорти й модерація

#
leadli_get_report_statusПовертає власний репорт і анонімний сигнал кількох репортів для щонайбільше 100 ID спостережуваних підписників.

Вхідні параметри

leadIdsобов'язково
Array<string>
targetIdобов'язково
string
#
leadli_save_reportЗберігає або замінює репорт організації про одного спостережуваного підписника. Репорт не блокує підписника.

Вхідні параметри

categoryобов'язково
"spam" | "fake" | "scam"
descriptionнеобов'язково
string
leadIdобов'язково
string
targetIdобов'язково
string
#
leadli_withdraw_reportВідкликає репорт організації про одного спостережуваного підписника.

Вхідні параметри

leadIdобов'язково
string
targetIdобов'язково
string
#
leadli_list_organization_reportsПовертає сторінку репортів поточної організації.

Вхідні параметри

limitнеобов'язково
number
pageнеобов'язково
number
statusнеобов'язково
"active" | "withdrawn"
#
leadli_withdraw_organization_reportВідкликає один репорт поточної організації.

Вхідні параметри

reportIdобов'язково
string
#
leadli_ban_subscriberБлокує одну спостережувану людину в поточному Telegram-каналі. Ботів блокувати не можна.

Вхідні параметри

leadIdобов'язково
string
targetIdобов'язково
string
#
leadli_unban_subscriberЗнімає блокування однієї спостережуваної людини в поточному Telegram-каналі. Автоматично до каналу її не повертає.

Вхідні параметри

leadIdобов'язково
string
targetIdобов'язково
string

Telegram-канали й боти

#
leadli_create_channelСтворює чернетку Telegram-каналу. Ліміт плану перевіряється під час активації. Для бота використовуйте leadli_create_bot.

Вхідні параметри

chatReferenceобов'язково
string
#
leadli_create_botСтворює чернетку Telegram-бота за @username або t.me-посиланням. Далі підключіть рекламну платформу й лендинг, встановіть код із leadli_get_bot_code та викличте leadli_activate_channel.

Вхідні параметри

botReferenceобов'язково
string
#
leadli_get_bot_codeПовертає інструкції для власного сервера бота: пересилайте приватні /start і my_chat_member без змін на updatesPath, успішні платежі на eventsPath, потім попросіть користувача відкрити verifyStartUrl. Обидва шляхи відносні до origin MCP-сервера. botKey зберігайте лише в конфігурації сервера бота та не показуйте у відповідях. Лише для ботів; для каналів повертає BOT_ONLY_OPERATION.

Вхідні параметри

targetIdобов'язково
string
#
leadli_connect_bot_tokenЗа бажанням зберігає BotFather token того самого бота, щоб показати його ім'я та фото. Токен не повертається; webhook та updates бота не змінюються. Лише для ботів; для каналів повертає BOT_ONLY_OPERATION.

Вхідні параметри

targetIdобов'язково
string
tokenобов'язково
string
#
leadli_update_channelЗмінює ім'я каналу.

Вхідні параметри

nameобов'язково
string
targetIdобов'язково
string
#
leadli_connect_telegram_botПідключає та перевіряє службового Telegram-бота. Секретний токен не повертається. Лише для каналів; для ботів повертає CHANNEL_ONLY_OPERATION.

Вхідні параметри

targetIdобов'язково
string
tokenобов'язково
string
#
leadli_set_telegram_destinationЗадає адресу Telegram-каналу й скидає його перевірку. Лише для каналів; для ботів повертає CHANNEL_ONLY_OPERATION.

Вхідні параметри

chatReferenceобов'язково
string
targetIdобов'язково
string
#
leadli_verify_telegram_destinationПеревіряє права бота в налаштованому Telegram-каналі. Лише для каналів; для ботів повертає CHANNEL_ONLY_OPERATION.

Вхідні параметри

targetIdобов'язково
string
#
leadli_get_setup_statusПовертає перевірки готовності каналу. Орієнтуйтесь на ready: достатньо metaVerified або tiktokVerified, тому інша перевірка може залишатися false.

Вхідні параметри

targetIdобов'язково
string
#
leadli_activate_channelАктивує канал, якщо налаштування готові та план має вільне місце.

Вхідні параметри

targetIdобов'язково
string
#
leadli_disable_channelВимикає атрибуцію каналу та звільняє його активне місце в плані.

Вхідні параметри

targetIdобов'язково
string

Підключення Meta й TikTok

#
leadli_set_meta_connectionПеревіряє та зберігає підключення Meta dataset з обов'язковим test event code. Access token не повертається.

Вхідні параметри

accessTokenобов'язково
string
datasetIdобов'язково
string
targetIdобов'язково
string
testEventCodeобов'язково
string
#
leadli_remove_meta_connectionВідключає канал від Meta.

Вхідні параметри

targetIdобов'язково
string
#
leadli_set_tiktok_connectionПеревіряє та зберігає підключення TikTok pixel до Events API з обов'язковим test event code. Access token не повертається.

Вхідні параметри

accessTokenобов'язково
string
pixelCodeобов'язково
string
targetIdобов'язково
string
testEventCodeобов'язково
string
#
leadli_remove_tiktok_connectionВідключає канал від TikTok.

Вхідні параметри

targetIdобов'язково
string

Лендинги й browser SDK

#
leadli_set_landing_urlЗадає HTTP(S) URL лендингу без облікових даних, query-параметрів і fragment.

Вхідні параметри

landingUrlобов'язково
string
targetIdобов'язково
string
#
leadli_create_ready_made_landingСтворює та публікує готовий Telegram-лендинг із поточними перевірками налаштувань.

Вхідні параметри

targetIdобов'язково
string
#
leadli_refresh_ready_made_landingОновлює та публікує вміст готового лендингу з поточного Telegram-каналу.

Вхідні параметри

targetIdобов'язково
string
#
leadli_get_ready_made_landingПовертає метадані опублікованого готового лендингу.

Вхідні параметри

targetIdобов'язково
string
#
leadli_ensure_landing_installationГотує встановлення SDK та повертає інструкції й тимчасовий installation token.

Вхідні параметри

targetIdобов'язково
string
#
leadli_get_landing_installation_statusПовертає стан встановлення SDK лендингу.

Вхідні параметри

targetIdобов'язково
string
#
leadli_restart_landing_installationПерезапускає незавершене встановлення SDK, замінюючи попередню спробу й тимчасовий токен.

Вхідні параметри

targetIdобов'язково
string
#
leadli_confirm_landing_installationПідтверджує готове встановлення SDK для точного HTTP(S) origin.

Вхідні параметри

installationIdобов'язково
string
landingUrlнеобов'язково
string
originобов'язково
string
targetIdобов'язково
string
#
leadli_list_landingsПовертає власні та готові сторінки каналу, їхній стан і використання лімітів плану.

Вхідні параметри

targetIdобов'язково
string
#
leadli_add_landingДодає HTTP(S)-сторінку до каналу, що вже має підтверджену сторінку. Query і fragment ігноруються. Повертає сторінку та тимчасовий installation token.

Вхідні параметри

targetIdобов'язково
string
urlобов'язково
string
#
leadli_get_landing_installationПовертає стан встановлення SDK на окремій сторінці каналу.

Вхідні параметри

landingIdобов'язково
string
targetIdобов'язково
string
#
leadli_restart_landingВидає новий installation token для власної сторінки в стані очікування або відключення, замінюючи попередній.

Вхідні параметри

landingIdобов'язково
string
targetIdобов'язково
string
#
leadli_confirm_landingПідтверджує сторінку після спостереження SDK і кнопки підписки на її origin та дозволяє цей origin.

Вхідні параметри

landingIdобов'язково
string
targetIdобов'язково
string
#
leadli_disconnect_landingВідключає власну сторінку каналу, зберігає її історію та звільняє місце. Останню підтверджену сторінку відключити не можна.

Вхідні параметри

landingIdобов'язково
string
targetIdобов'язково
string
#
leadli_get_sdk_instructionsПовертає публічний URL скрипта SDK, атрибут кнопки підписки та route key.

Вхідні параметри

targetIdобов'язково
string

Telegram-сповіщення

#
leadli_list_notification_receiversПовертає отримувачів сповіщень каналу. Потрібен дозвіл на налаштування. Лише для каналів; для ботів повертає CHANNEL_ONLY_OPERATION.

Вхідні параметри

targetIdобов'язково
string
#
#
leadli_update_notification_receiverВмикає або вимикає наявного отримувача сповіщень. Лише для каналів; для ботів повертає CHANNEL_ONLY_OPERATION.

Вхідні параметри

enabledобов'язково
boolean
targetIdобов'язково
string
telegramUserIdобов'язково
string
#
leadli_remove_notification_receiverВидаляє отримувача сповіщень каналу. Лише для каналів; для ботів повертає CHANNEL_ONLY_OPERATION.

Вхідні параметри

targetIdобов'язково
string
telegramUserIdобов'язково
string

Приклад виклику й відповіді

Після ініціалізації MCP-клієнта викличте leadli_get_context з порожніми аргументами. Далі використовуйте тільки доступні інструменти. Приклад нижче показує JSON-RPC повідомлення, яке надсилає клієнт.

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "leadli_get_context",
    "arguments": {}
  }
}

  • MCP повертає результат у content; якщо є isError: true, покажіть помилку та не вважайте дію виконаною.
  • Помилка авторизації: перевірте Bearer-заголовок і чи ключ не відкликано. Для відмови в доступі перевірте контекст, дозволи й план.
  • CHANNEL_ONLY_OPERATION означає інструмент для Telegram-каналу; BOT_ONLY_OPERATION означає інструмент для Telegram-бота.

Дані, обмеження та підтримка

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

Поточне підключення використовує статичний Bearer-ключ. Потрібен клієнт із підтримкою власного Authorization header. OAuth-підключення через каталоги Claude або OpenAI поки не підтримується.

Короткі відповіді

Чи є доступ до всіх інструментів із будь-яким ключем?

Ні. Перевірте effective permissions і available tools у leadli_get_context. Для дій із даними потрібен активний trial або платний план. Контекст залишається доступним для перевірки доступу за планом.

Чи репорт блокує підписника?

Репорт лише зберігає сигнал організації. Блокування виконується окремим інструментом і діє тільки на вибраний Telegram-канал.

Першоджерела

Почніть з одного каналу безкоштовно.

Підписники, вступи й виходи видно без плану й без картки. Рекламу з Meta і TikTok підключите, коли будете готові.

Почати безкоштовноЗапланувати дзвінок
MCP-сервер: довідник інструментів | leadli.me