Localtonet MCPサーバー
このページの内容 9セクション
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クライアントを接続する #
-
クライアントにサーバーを追加する #
ほとんどの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 | 1台のデバイスの最新の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のツールを、クライアントの設定で有効にしてください。