MCPゲートウェイトンネルでMCPツールを公開する
デスクトップ v7.8以降 モバイル v10.1以降
このページの内容 8セクション
MCPゲートウェイトンネルは、MCPクライアントやAIアシスタントを、公開ゲートウェイを通じて、お使いのデバイス上で動くツールに接続します。ゲートウェイはLocaltonetクライアントが実行し、トンネルがそのゲートウェイに公開HTTPSアドレスを割り当てます。
内容 #
Model Context Protocol(MCP)を使うと、AIアシスタントがツールを呼び出せます。MCPゲートウェイは、ご自身が動かしているMCPサーバーの手前に置かれ、それらのすべてのツールを1つのエンドポイントで提供します。
MCPゲートウェイトンネルを開始すると、Localtonetクライアントがデバイス上でゲートウェイを起動し、Localtonetがそれをトンネルのアドレスで公開します。ローカルIPやポートを入力する必要はありません。ゲートウェイには次のものがあります。
https://<ADDRESS>/dashboardにあるWebダッシュボード。MCPサーバーの登録やクライアントトークンの作成を行います。https://<ADDRESS>/mcpにあるMCPエンドポイント。MCPクライアントが接続する先です。
LocaltonetのMCPサーバーとは別のものです。このページは、ご自身のツールを公開する方法について説明しています。AIアシスタントにLocaltonetアカウント(トンネルやトークンなど)を管理させたい場合は、MCPサーバーをご覧ください。
始める前に #
- デバイス上でLocaltonetクライアントが動作しており、AuthTokenで接続されていること。クイックスタートをご覧ください。
- クライアントのバージョンが十分に新しいこと。この機能を使うために必要なLocaltonetアプリの最小バージョンは、
Desktop v7.8、Mobile v10.1です。
ゲートウェイを作成する #
-
MCPゲートウェイのページを開く #
マイトンネル › MCPゲートウェイを開き、MCPゲートウェイトンネルを作成を展開します。
-
フォームに入力する #
項目 入力する内容 URLの種類 ランダムサブドメイン、カスタムサブドメイン、またはカスタムドメイン。下の表をご覧ください。 デバイストークン ツールを実行するデバイスのトークンです。 サーバーリージョン MCPクライアントが接続するサーバーです。 サブドメイン カスタムサブドメインの場合に表示されます。希望する名前を入力します。 ドメイン アドレスのドメインです。 トンネルを作成を選択します。
-
トンネルを開始する #
ゲートウェイはあなたのトンネルに表示されます。開始を選択します。URL列に公開アドレスが表示されます。
URLの種類 #
| URLの種類 | 取得できるアドレス | 備考 |
|---|---|---|
| ランダムサブドメイン | 選択したドメインの下に、自動生成された名前が付きます。 | 最初のテストに適しています。 |
| カスタムサブドメイン | 選択したドメインの下に、入力したサブドメインが付きます。 | 残高が必要です。 |
| カスタムドメイン | ご自身のドメインのいずれか。 | 残高が必要です。ドメインの一覧にはご自身のドメインが表示されます。空の場合は、先にDNSマネージャーでドメインを作成してください。カスタムドメインをご覧ください。 |
ゲートウェイトークン #
MCPゲートウェイトンネルには、作成時にそれぞれ専用のゲートウェイトークンが発行されます。これはゲートウェイの管理者トークンで、ゲートウェイのダッシュボードと管理APIは、このトークンがある場合にだけ変更を受け付けます。
- トンネルの設定アイコンを選択します。
- ゲートウェイトークンの横にある管理を選択します。ゲートウェイトークンウィンドウに、中央部分が隠されたトークンが表示されます。
- トークンの横にあるコピーボタンを選択します。常にトークン全体がコピーされます。その横の表示ボタンを選択すると、トークンが画面に表示されます。
ゲートウェイトークンは非公開にしてください。ゲートウェイのサーバー、ツール、クライアントトークンをすべて操作できます。MCPクライアントには入力しないでください。クライアントは、それぞれ専用のトークンを使います。
MCPクライアントを接続する #
-
ゲートウェイのダッシュボードを開く #
トンネルを開始した状態で、ブラウザーで
https://<ADDRESS>/dashboardを開きます。サイドメニューの下部にあるAdmin token欄に、ゲートウェイトークンを貼り付けます。 -
MCPサーバーを登録する #
Serversを開き、Add Serverを選択します。サーバーには、URLで到達できるMCPサーバー(Streamable HTTPまたはSSE)、ローカルコマンド(stdio)、OpenAPIサービスを指定できます。Catalogには、インストールできる既成のMCPサーバーが一覧表示され、Toolsには、ゲートウェイがすべてのサーバーから集めたツールが表示されます。
-
クライアントトークンを作成する #
Clientsを開き、New Clientを選択します。Nameを入力してCreate Clientを選択します。ゲートウェイはClient Tokenを一度だけ表示します。今すぐコピーしてください。再度表示されることはありません。クライアント一覧のAllowed ServersとAllowed Groupsには、クライアントが使えるサーバーとツールグループが表示されます。
-
MCPクライアントをゲートウェイに向ける #
お使いのMCPクライアントやAIアシスタントで、次の2つの値を使ってリモートMCPサーバーを追加します。
MCPクライアントの設定URL: https://<ADDRESS>/mcp Header: Authorization: Bearer <CLIENT_TOKEN>どこに入力するかはクライアントによって異なります。リモート(HTTP)のMCPサーバーについては、各クライアントのドキュメントに従ってください。
ダッシュボードのAudit Logには最近のゲートウェイへのリクエストが表示され、Settingsにはバックアップと復元を含むゲートウェイの設定があります。
ゲートウェイは、サーバー、グループ、クライアント、監査ログを、デバイス上のLocaltonetクライアントの作業ディレクトリにあるmcp-data-<TUNNEL_ID>という名前のフォルダーに保存します(Androidではアプリ自身のストレージ内)。<TUNNEL_ID>はID列の番号なので、MCPゲートウェイトンネルごとに専用のフォルダーができます。
設定 #
トンネルの設定アイコンを選択すると、トンネル設定が開きます。
| 設定項目 | 動作 | 詳細 |
|---|---|---|
| 負荷分散 | 複数のデバイスにトラフィックを分散したり、ターゲットが利用できない場合にバックアップを使ったりします。 | 負荷分散 |
| HTTPSのみ | 公開トンネルのエンドポイントでHTTPSだけを使います。 | 設定リファレンス |
| Basic認証 | このトンネルへのアクセスに、ユーザー名とパスワードを必須にします。 | アクセス制御 |
| HTTP/3を有効化 | クライアントがHTTP/3で公開エンドポイントに接続できるようにします。 | 設定リファレンス |
| レガシー接続 | 通常の接続方法でトンネルが接続できない場合に試してください。 | 設定リファレンス |
| ゲートウェイトークン | このMCPゲートウェイのアクセストークンを管理します。 | 上記をご覧ください |
| HTTPタイムアウト | ローカルアプリケーションからの応答をサーバーが待ち、リクエストを中止するまでの時間で、1〜600秒です。空にすると、サーバーのデフォルトが使われます。 | 設定リファレンス |
| トンネルメモ | このトンネルを識別したり記録したりするための、非公開のメモを保存します。 | 設定リファレンス |
| IP制限 | このトンネルにアクセスできるクライアントIPアドレスを制御します。 | アクセス制御 |
| 有効期限、速度制限、帯域幅制限、帯域幅使用量 | 有効期限、アップロードとダウンロードの速度制限、データ転送量の上限、そして記録された使用量をリセットするクリア。 | 制限と有効期限 |
| アウトバウンドポート | Localtonetアプリがサーバーに接続するときの、固定のアウトバウンドポートを選びます。 | ポート |
| 帯域幅トラフィック、リクエストログ、アクティビティログ、トンネルのヘルス | 時間ごとのトラフィック、記録されたリクエスト、開始、停止、設定の変更、そして最近のヘルスチェックの結果です。 | ログと検査 |
トンネル一覧のWebhook列にはリクエストとレスポンスのログを表示ボタンがあり、開始済みのトンネルのリクエストインスペクターを開きます。ログと検査をご覧ください。
トラブルシューティング #
ゲートウェイが起動しない、またはアドレスが応答しない
デバイスのLocaltonetアプリのバージョンを確認してください。MCPゲートウェイには、少なくともDesktop v7.8またはMobile v10.1が必要です。次に、トンネルが開始されていて、接続列でデバイスが接続済みと表示されていることを確認してください。
ゲートウェイのダッシュボードがデータを読み込まない
ダッシュボードの管理リクエストには、管理者トークンが必要です。Admin token欄が空か、値が正しくありません。トンネルの設定からゲートウェイトークンをもう一度コピーして、その欄に貼り付けてください。
MCPクライアントが拒否される
MCPエンドポイントでは、Authorization: Bearerヘッダーにクライアントトークンが必要です。ゲートウェイのダッシュボードのClientsで作成したトークンを使ってください。ゲートウェイトークンではありません。
「先にトンネルを開始してください。」
リクエストインスペクターは、トンネルが開始されている間だけ利用できます。
「DNSマネージャーでドメインを作成する必要があります!」または「警告:ドメインがありません!」
カスタムドメインには、ご自身のドメインが必要です。DNSマネージャーで追加するか、別のURLの種類を選んでください。
「この機能を利用するには残高の購入が必要です。」
カスタムサブドメインとカスタムドメインには残高が必要です。ランダムサブドメインを使うか、残高を追加してください。プランと残高をご覧ください。