Перейти к содержимому
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 для публичной точки доступа туннеля.Справочник по настройкам
Basic Auth?Требовать имя пользователя и пароль для доступа к этому туннелю.Контроль доступа
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.

«Чтобы пользоваться этой функцией, пополните баланс.»

Свой поддомен и Свой домен требуют положительного баланса. Используйте Случайный поддомен или пополните баланс. См. Тарифы и баланс.

Поддержка