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 | Показує комп’ютери, пов’язані з вашим обліковим записом у розділі «Мої пристрої», з інформацією про те, чи кожен з них онлайн, а також про використання процесора, пам’яті й диска. |
GetDeviceMetrics | Повертає останні показники процесора, пам’яті, диска та часу роботи одного пристрою. |
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 у налаштуваннях клієнта.