MCP-сервер Localtonet
На этой странице 9 разделов
- Что это такое и чем не является
- Параметры подключения
- Перед началом
- Подключение вашего MCP-клиента
- Добавьте сервер в клиент
- Проверьте подключение
- Создайте туннель
- Инструменты
- Туннели
- Конфигурация туннеля
- AuthToken и группы токенов
- Серверы и провайдеры SSO
- VPN-доступ для прокси-туннелей
- Устройства
- Лимиты
- Безопасность
- Устранение неполадок
- Связанные страницы
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-клиента #
-
Добавьте сервер в клиент #
Большинство MCP-клиентов принимают удалённый сервер в виде URL и заголовков. Обычно это выглядит так:
Конфигурация MCP-клиента{ "mcpServers": { "localtonet": { "type": "http", "url": "https://localtonet.com/mcp", "headers": { "Authorization": "Bearer <YOUR_API_KEY>" } } } }Имя файла и точные названия ключей у разных клиентов различаются. Посмотрите в документации вашего клиента, где настраиваются удалённые MCP-серверы, и используйте URL и заголовок, указанные выше.
-
Проверьте подключение #
Перезагрузите клиент. Инструменты Localtonet должны появиться в его списке инструментов. Сначала спросите что-нибудь безобидное, например:
ЗапросList my Localtonet tunnels and tell me which ones are running. -
Создайте туннель #
Опишите, что вам нужно. Например:
Запрос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 |
Конфигурация туннеля #
| Параметр | Инструменты |
|---|---|
| Ограничения по IP | GetIpRestrictions, 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 и группы токенов #
| Назначение | Инструменты |
|---|---|
| AuthToken | GetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken |
| Режим полёта и смена IP | GetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink |
| Группы токенов | GetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup |
Серверы и провайдеры SSO #
| Назначение | Инструменты |
|---|---|
| Серверы | GetAvailableServers |
| Провайдеры SSO | GetSsoProviders, 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 в настройках клиента.