Перейти до вмісту
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

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

ПараметрІнструменти
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 і групи токенів #

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

Підтримка