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

MCP-сервер Localtonet

Помощь по этой странице
На этой странице 9 разделов
  1. Что это такое и чем не является
  2. Параметры подключения
  3. Перед началом
  4. Подключение вашего MCP-клиента
  5. Добавьте сервер в клиент
  6. Проверьте подключение
  7. Создайте туннель
  8. Инструменты
  9. Туннели
  10. Конфигурация туннеля
  11. AuthToken и группы токенов
  12. Серверы и провайдеры SSO
  13. VPN-доступ для прокси-туннелей
  14. Устройства
  15. Лимиты
  16. Безопасность
  17. Устранение неполадок
  18. Связанные страницы

MCP-сервер Localtonet позволяет ИИ-ассистенту с поддержкой Model Context Protocol, например Claude или Cursor, управлять вашим аккаунтом на естественном языке: просматривать, создавать, запускать, останавливать и настраивать туннели, а также управлять AuthToken, группами токенов, серверами и провайдерами SSO.

Что это такое и чем не является #

  • MCP-сервер на этой странице работает на стороне Localtonet по адресу https://localtonet.com/mcp. Его инструменты действуют на ваш аккаунт Localtonet так же, как REST API.
  • MCP-шлюз — это тип туннеля. Он даёт публичный адрес MCP-серверу, который работает на вашем собственном устройстве. Используйте его, чтобы опубликовать собственные инструменты, а не для управления Localtonet.

Параметры подключения #

ПараметрЗначение
Конечная точкаhttps://localtonet.com/mcp
ТранспортStreamable HTTP
АутентификацияВаш ключ API в качестве Bearer-токена: Authorization: Bearer <YOUR_API_KEY>
Информация о сервереlocaltonet.com/mcp-info (JSON) и карточка сервера по адресу https://localtonet.com/.well-known/mcp-server-card

Перед началом #

  • MCP-клиент, который умеет подключаться к удалённому серверу по Streamable HTTP и отправлять собственный заголовок Authorization.
  • Ваш ключ API. Откройте Панель управления и нажмите Копировать в карточке Ключ API. См. Аккаунт и безопасность.
  • Для работы с туннелями: устройство с подключённым клиентом Localtonet, чтобы у ассистента был AuthToken, на котором создавать туннели.

Подключение вашего MCP-клиента #

  1. Добавьте сервер в клиент #

    Большинство MCP-клиентов принимают удалённый сервер в виде URL и заголовков. Обычно это выглядит так:

    Конфигурация MCP-клиента
    {
      "mcpServers": {
        "localtonet": {
          "type": "http",
          "url": "https://localtonet.com/mcp",
          "headers": {
            "Authorization": "Bearer <YOUR_API_KEY>"
          }
        }
      }
    }

    Имя файла и точные названия ключей у разных клиентов различаются. Посмотрите в документации вашего клиента, где настраиваются удалённые MCP-серверы, и используйте URL и заголовок, указанные выше.

  2. Проверьте подключение #

    Перезагрузите клиент. Инструменты Localtonet должны появиться в его списке инструментов. Сначала спросите что-нибудь безобидное, например:

    Запрос
    List my Localtonet tunnels and tell me which ones are running.
  3. Создайте туннель #

    Опишите, что вам нужно. Например:

    Запрос
    Create an HTTP tunnel with a random subdomain for port 3000 on my device "laptop", then start it and give me the URL.

    Ассистент следует рабочему процессу, который предписывает сервер: он находит AuthToken устройства, выбирает сервер, вызывает подходящий инструмент создания и запускает туннель, потому что только что созданный туннель не запущен.

Инструменты #

Ниже приведены названия инструментов в том виде, в каком их показывает ваш клиент. Инструмент, завершившийся ошибкой, возвращает сообщение, которое начинается с Error:.

Туннели #

НазначениеИнструменты
ПросмотрGetTunnels, GetTunnel, GetTunnelRequestLogs
СозданиеCreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel
ЗапускStartTunnel, StopTunnel, DeleteTunnel
ИзменениеUpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType
Массовые операцииBulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType

Конфигурация туннеля #

ПараметрИнструменты
Ограничения по IPGetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions
Правила доступаGetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls
Заголовки и аутентификацияGetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication
Срок действия и лимитыGetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage
Сервер и портGetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer
Аргументы и заметкаGetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote
Клиенты ротационного прокси и группы токеновGetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups
Расширенные настройкиGetAdvancedTunnelSettings, GetTunnelIpv4Only, SetTunnelIpv4Only, GetTunnelWifiSplit, SetTunnelWifiSplit, SetTunnelSslStream, GetTunnelProxyProtocol, SetTunnelProxyProtocol, GetTunnelPassThrough, SetTunnelPassThrough, GetTunnelHttpsOnly, SetTunnelHttpsOnly, GetTunnelHttp3, SetTunnelHttp3, GetTunnelFilePath, SetTunnelFilePath, GetTunnelHostHeader, SetTunnelHostHeader, GetTunnelPathRewrite, SetTunnelPathRewrite, GetTunnelUpstreamProxy, SetTunnelUpstreamProxy, GetTunnelVless, SetTunnelVless

Что делают эти настройки, описано в Справочнике по настройкам туннеля.

AuthToken и группы токенов #

НазначениеИнструменты
AuthTokenGetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken
Режим полёта и смена IPGetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink
Группы токеновGetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup

Серверы и провайдеры SSO #

НазначениеИнструменты
СерверыGetAvailableServers
Провайдеры SSOGetSsoProviders, GetSsoProviderDefaultEndpoints, SaveSsoProvider, DeleteSsoProvider, GetSsoProvidersForTunnel, SetSsoProvidersForTunnel

VPN-доступ для прокси-туннелей #

GetVpnAccessDevices, CreateVpnAccessDevice, GetVpnAccessDeviceConfig, GetVpnAccessDeviceCredentials, RegenerateVpnAccessDevice, DeleteVpnAccessDevice. Эти инструменты управляют устройствами WireGuard и OpenVPN на прокси-туннеле. У каждого устройства своя конфигурация, и весь его трафик выходит через прокси.

Устройства #

ИнструментЧто делает
ListDevicesПеречисляет компьютеры, связанные с вашим аккаунтом в разделе «Мои устройства», с указанием, в сети ли каждый из них, и его загрузки CPU, памяти и диска.
GetDeviceMetricsВозвращает последние значения загрузки CPU, памяти, диска и времени работы одного устройства.
RunDeviceCommandВыполняет на устройстве одну команду оболочки и возвращает её вывод и код завершения. Ожидает не дольше заданного вами тайм-аута, от 1 до 120 секунд, по умолчанию 30.

Для RunDeviceCommand одного ключа API недостаточно: нужен ключ доступа устройства (он начинается с ltd_), который вы создаёте для этого устройства в разделе «Мои устройства». См. Терминал устройств. Запуск отображается в истории подключений устройства со временем и IP-адресом; сама команда не сохраняется.

Лимиты #

  • Запросы к MCP-серверу ограничены по частоте вместе с запросами к API с вашим ключом API. Ответ 429 означает: подождите и повторите попытку.
  • Инструменты для массовых операций принимают список до 100 элементов.

Безопасность #

Ассистент действует с вашим ключом API. Его инструменты могут создавать, останавливать и удалять туннели, удалять AuthToken и группы токенов и менять правила доступа без шага подтверждения на стороне Localtonet.

  • Включите в вашем MCP-клиенте подтверждение вызовов инструментов, как минимум для инструментов, названия которых начинаются с Delete, BulkDelete, Stop и Set.
  • Передавайте ключ доступа устройства для RunDeviceCommand только тому ассистенту, которому вы доверили бы и терминал на этом компьютере. Команду выполняет оболочка устройства по умолчанию.
  • Относитесь к файлу конфигурации клиента как к секрету: в нём находится ваш ключ API. Не добавляйте его в репозиторий.
  • Если ключ мог утечь, нажмите Сменить в карточке Ключ API панели управления. Это создаст новый ключ и сделает старый недействительным; затем обновите ваш MCP-клиент.
  • Если ключ API скопирован в панели команды, ассистент видит только ваши AuthToken и туннели в этой команде. См. Управление командой.

Устранение неполадок #

Клиент сообщает 401 или «API key is required. Provide Authorization: Bearer <apikey>»

В запросе нет действительного заголовка Authorization. Убедитесь, что клиент отправляет для этого сервера собственные заголовки, что значение состоит из Bearer, пробела и ключа и что ключ не был изменён в панели управления после того, как вы его скопировали.

Ассистент говорит, что инструмент вернул «Error: …»

Это ответ Localtonet, а не проблема с подключением. Текст после Error: объясняет, что было отклонено, например отсутствующий AuthToken или лимит тарифа. Устраните эту причину, а не заставляйте ассистента повторять попытки.

Туннель создан, но не отвечает

Попросите ассистента запустить его. Новый туннель остановлен, пока не вызван StartTunnel, и клиент Localtonet на устройстве должен быть подключён.

В моём клиенте не хватает инструментов

Некоторые клиенты ограничивают число инструментов или просят включать их по одному. Включите нужные инструменты Localtonet в настройках клиента.

Поддержка