コンテンツへスキップ
Localtonet Localtonet ダッシュボード

Localtonet MCPサーバー

このページのヘルプ
このページの内容 9セクション
  1. これは何か、何ではないか
  2. 接続情報
  3. 始める前に
  4. MCPクライアントを接続する
  5. クライアントにサーバーを追加する
  6. 接続を確認する
  7. トンネルを作成する
  8. ツール
  9. トンネル
  10. トンネルの構成
  11. AuthTokenとトークングループ
  12. サーバーとSSOプロバイダー
  13. プロキシトンネルのVPNアクセス
  14. デバイス
  15. 制限
  16. 安全のために
  17. トラブルシューティング
  18. 関連ページ

Localtonet MCPサーバーを使うと、ClaudeやCursorなどModel Context Protocolに対応したAIアシスタントが、自然言語であなたのアカウントを管理できます。トンネルの一覧表示、作成、開始、停止、設定のほか、AuthToken、トークングループ、サーバー、SSOプロバイダーの管理も行えます。

これは何か、何ではないか #

  • このページのMCPサーバーはLocaltonetがhttps://localtonet.com/mcpで運用しています。そのツールは、REST APIと同様に、あなたのLocaltonetアカウントに対して動作します。
  • 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

始める前に #

  • Streamable HTTPでリモートサーバーに接続でき、カスタムのAuthorizationヘッダーを送信できるMCPクライアント。
  • APIキー。ダッシュボードを開き、APIキーカードのコピーを使います。アカウントとセキュリティを参照してください。
  • トンネルを操作する場合:アシスタントがトンネルを作成できるAuthTokenを持てるよう、Localtonetクライアントが接続されたデバイス。

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
機内モードと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、メモリ、ディスクの使用状況とともに一覧表示します。
GetDeviceMetrics1台のデバイスの最新のCPU、メモリ、ディスク、稼働時間の値を返します。
RunDeviceCommandデバイス上でシェルコマンドを1つ実行し、その出力と終了コードを返します。指定したタイムアウト(1~120秒、デフォルトは30秒)まで待機します。

RunDeviceCommandにはAPIキー以外のものが必要です。マイデバイスでそのデバイス用に作成した、ltd_で始まるデバイスアクセスキーが必要になります。デバイスターミナルを参照してください。実行すると、デバイスの接続履歴に時刻とIPアドレスが記録されます。コマンド自体は保存されません。

制限 #

  • MCPサーバーへのリクエストは、お使いのAPIキーによるAPIリクエストと合わせてレート制限されます。429が返った場合は、待ってからやり直してください。
  • 一括ツールは、最大100件のリストを受け付けます。

安全のために #

アシスタントはあなたのAPIキーで動作します。そのツールは、Localtonet側での確認手順なしに、トンネルの作成、停止、削除、AuthTokenやトークングループの削除、アクセスルールの変更を行えます。

  • 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クライアントが接続されている必要があります。

クライアントにツールが表示されない

クライアントによっては、ツールの数を制限したり、1つずつ有効にするよう求めたりします。必要なLocaltonetのツールを、クライアントの設定で有効にしてください。

サポート