Перейти до вмісту
Localtonet Localtonet Панель керування

Публікація інструментів MCP через тунель MCP-шлюзу

Desktop v7.8+ Mobile v10.1+

Допомога зі сторінкою
На цій сторінці 8 розділів
  1. Що це
  2. Перш ніж почати
  3. Створення шлюзу
  4. Відкрийте сторінку MCP-шлюзу
  5. Заповніть форму
  6. Запустіть тунель
  7. Типи URL
  8. Токен шлюзу
  9. Підключення MCP-клієнта
  10. Відкрийте вебпанель шлюзу
  11. Зареєструйте свої MCP-сервери
  12. Створіть токен клієнта
  13. Спрямуйте MCP-клієнт на шлюз
  14. Налаштування
  15. Усунення несправностей
  16. Пов’язані сторінки

Тунель MCP-шлюзу з’єднує клієнти MCP та ШІ-асистентів з інструментами, що працюють на вашому пристрої, через публічний шлюз. Шлюз запускає для вас клієнт Localtonet, а тунель надає йому публічну HTTPS-адресу.

Що це #

Model Context Protocol (MCP) дозволяє ШІ-асистенту викликати інструменти. MCP-шлюз стоїть перед MCP-серверами, які ви запускаєте, і надає всі їхні інструменти через одну кінцеву точку.

Коли ви запускаєте тунель MCP-шлюзу, клієнт Localtonet запускає шлюз на вашому пристрої, а Localtonet публікує його за адресою тунелю. Локальні IP-адресу чи порт вводити не потрібно. Шлюз має:

  • вебпанель за адресою https://<ADDRESS>/dashboard, де ви реєструєте MCP-сервери й створюєте токени клієнтів;
  • кінцеву точку MCP за адресою https://<ADDRESS>/mcp, до якої підключаються ваші MCP-клієнти.

Це не те саме, що MCP-сервер Localtonet. Ця сторінка про публікацію ваших власних інструментів. Щоб ШІ-асистент міг керувати вашим обліковим записом Localtonet (тунелями, токенами тощо), див. MCP-сервер.

Перш ніж почати #

  • Клієнт Localtonet запущено на пристрої й підключено з AuthToken. Див. Швидкий старт.
  • Клієнт має бути достатньо новим. Мінімальні версії застосунку Localtonet, потрібні для цієї функції: Desktop v7.8, Mobile v10.1.

Створення шлюзу #

  1. Відкрийте сторінку MCP-шлюзу #

    Відкрийте Мої тунелі › MCP-шлюз і розгорніть Створити тунель MCP-шлюзу.

  2. Заповніть форму #

    ПолеЩо вводити
    Тип URLВипадковий піддомен, Власний піддомен або Власний домен. Див. таблицю нижче.
    Токен пристроюТокен пристрою, на якому працюють ваші інструменти.
    Регіон сервераСервер, до якого підключаються ваші MCP-клієнти.
    ПіддоменВідображається для Власного піддомену: потрібне вам ім’я.
    ДоменДомен адреси.

    Виберіть Створити тунель.

  3. Запустіть тунель #

    Шлюз з’явиться в розділі Ваші тунелі. Виберіть Запустити. Стовпець URL показує публічну адресу.

Типи URL #

Тип URLЯку адресу ви отримаєтеПримітки
Випадковий піддоменЗгенероване ім’я у вибраному домені.Підходить для першого тесту.
Власний піддоменПіддомен, який ви вводите, у вибраному Домені.Потрібен баланс.
Власний доменОдин із ваших власних доменів.Потрібен баланс. У списку Домен показано ваші домени; якщо він порожній, спершу створіть домен у Менеджері DNS. Див. Власні домени.

Токен шлюзу #

Кожен тунель MCP-шлюзу отримує власний токен шлюзу під час створення. Це адміністративний токен шлюзу: вебпанель шлюзу та його API керування приймають зміни лише з ним.

  1. Виберіть значок Налаштування тунелю.
  2. Поруч із Токен шлюзу виберіть Керувати. У вікні Токен шлюзу токен показано з прихованою серединою.
  3. Виберіть кнопку копіювання поруч із токеном. Вона завжди копіює токен повністю. Кнопка показу поруч відображає токен на екрані.

Зберігайте токен шлюзу в таємниці. Він дає повний контроль над шлюзом: його серверами, інструментами й токенами клієнтів. Не вставляйте його в MCP-клієнт; клієнти використовують власний токен.

Підключення MCP-клієнта #

  1. Відкрийте вебпанель шлюзу #

    Коли тунель запущено, відкрийте в браузері https://<ADDRESS>/dashboard. Вставте токен шлюзу в поле Admin token унизу бічного меню.

  2. Зареєструйте свої MCP-сервери #

    Відкрийте Servers і виберіть Add Server. Сервером може бути MCP-сервер, доступний за URL (Streamable HTTP або SSE), локальна команда (stdio) або сервіс OpenAPI. Catalog перелічує готові MCP-сервери, які можна встановити, а Tools показує інструменти, які шлюз зібрав з усіх серверів.

  3. Створіть токен клієнта #

    Відкрийте Clients і виберіть New Client. Введіть Name і виберіть Create Client. Шлюз показує Client Token один раз: скопіюйте його зараз, пізніше його не буде показано. У списку клієнтів Allowed Servers і Allowed Groups показують, які сервери й групи інструментів може використовувати клієнт.

  4. Спрямуйте MCP-клієнт на шлюз #

    У своєму MCP-клієнті або ШІ-асистенті додайте віддалений MCP-сервер із такими двома значеннями:

    Налаштування MCP-клієнта
    URL:     https://<ADDRESS>/mcp
    Header:  Authorization: Bearer <CLIENT_TOKEN>

    Де їх вводити, залежить від клієнта; дотримуйтеся його власної документації щодо віддалених (HTTP) MCP-серверів.

Audit Log у вебпанелі показує нещодавні запити до шлюзу, а Settings містить конфігурацію шлюзу з резервним копіюванням і відновленням.

Шлюз зберігає свої сервери, групи, клієнти та журнал аудиту на вашому пристрої, у теці з назвою mcp-data-<TUNNEL_ID> у робочому каталозі клієнта Localtonet (в Android — усередині власного сховища застосунку). <TUNNEL_ID> — це число зі стовпця ID, тож кожен тунель MCP-шлюзу має власну теку.

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

Виберіть значок Налаштування тунелю, щоб відкрити Налаштування тунелю.

ПараметрЩо робитьДокладніше
Балансування навантаженняРозподіляє трафік між пристроями або використовує резервну ціль, коли основна недоступна.Балансування навантаження
Лише HTTPS?Використовувати лише HTTPS для публічної кінцевої точки тунелю.Довідник налаштувань
Базова автентифікація?Вимагати ім’я користувача й пароль для доступу до цього тунелю.Контроль доступу
HTTP/3 активний?Дозволити клієнтам підключатися до публічної кінцевої точки через HTTP/3.Довідник налаштувань
Застаріле підключення?Спробуйте це, якщо тунель не може підключитися звичайним способом.Довідник налаштувань
Токен шлюзуКеруйте токеном доступу до цього MCP-шлюзу.Див. вище
HTTP-таймаутСкільки сервер чекає відповіді від вашого локального застосунку, перш ніж перервати запит, від 1 до 600 секунд. Залиште поле порожнім, щоб використовувати значення сервера за замовчуванням.Довідник налаштувань
Нотатка тунелюЗбережіть приватну нотатку, яка допоможе вам упізнати або описати цей тунель.Довідник налаштувань
IP-обмеженняКеруйте тим, які IP-адреси клієнтів можуть звертатися до цього тунелю.Контроль доступу
Термін дії, Обмеження швидкості, Ліміт трафіку, Використання трафікуДата завершення, обмеження швидкості вивантаження й завантаження, ліміт передачі даних і Очистити, щоб скинути записане використання.Ліміти та термін дії
Вихідний портВиберіть фіксований вихідний порт для підключення застосунку Localtonet до сервера.Порти
Трафік тунелю, Журнал запитів, Журнал активності, Стан тунелюТрафік у часі, записані запити, запуски, зупинки та зміни налаштувань, а також нещодавні результати перевірок стану.Журнали та перевірка

У списку тунелів стовпець Вебхуки має кнопку Переглянути журнали запитів і відповідей, яка відкриває інспектор запитів для запущеного тунелю. Див. Журнали та перевірка.

Усунення несправностей #

Шлюз не запускається або адреса не відповідає

Перевірте версію застосунку Localtonet на пристрої: для MCP-шлюзу потрібна принаймні Desktop v7.8 або Mobile v10.1. Потім перевірте, що тунель запущено і стовпець Підключення показує пристрій як підключений.

Вебпанель шлюзу не завантажує свої дані

Запити керування з вебпанелі потребують адміністративного токена. Поле Admin token порожнє або містить помилку. Знову скопіюйте токен шлюзу з Налаштувань тунелю й вставте його в це поле.

MCP-клієнт відхиляється

Кінцева точка MCP потребує токена клієнта в заголовку Authorization: Bearer. Створіть його в розділі Clients вебпанелі шлюзу й використовуйте тут саме його, а не токен шлюзу.

«Спершу запустіть тунель.»

Інспектор запитів доступний, лише поки тунель запущено.

«Спершу створіть домен у Менеджері DNS!» або «УВАГА! У вас немає жодного домену!»

Для Власного домену потрібен один із ваших власних доменів. Додайте його в Менеджері DNS або виберіть інший тип URL.

«Щоб користуватися цією функцією, поповніть баланс.»

Власний піддомен і Власний домен потребують балансу. Використовуйте Випадковий піддомен або поповніть баланс. Див. Тарифи та баланс.

Підтримка