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

MCPゲートウェイトンネルでMCPツールを公開する

デスクトップ v7.8以降 モバイル v10.1以降

このページのヘルプ
このページの内容 8セクション
  1. 内容
  2. 始める前に
  3. ゲートウェイを作成する
  4. MCPゲートウェイのページを開く
  5. フォームに入力する
  6. トンネルを開始する
  7. URLの種類
  8. ゲートウェイトークン
  9. MCPクライアントを接続する
  10. ゲートウェイのダッシュボードを開く
  11. MCPサーバーを登録する
  12. クライアントトークンを作成する
  13. MCPクライアントをゲートウェイに向ける
  14. 設定
  15. トラブルシューティング
  16. 関連ページ

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です。

ゲートウェイを作成する #

  1. MCPゲートウェイのページを開く #

    マイトンネル › MCPゲートウェイを開き、MCPゲートウェイトンネルを作成を展開します。

  2. フォームに入力する #

    項目入力する内容
    URLの種類ランダムサブドメイン、カスタムサブドメイン、またはカスタムドメイン。下の表をご覧ください。
    デバイストークンツールを実行するデバイスのトークンです。
    サーバーリージョンMCPクライアントが接続するサーバーです。
    サブドメインカスタムサブドメインの場合に表示されます。希望する名前を入力します。
    ドメインアドレスのドメインです。

    トンネルを作成を選択します。

  3. トンネルを開始する #

    ゲートウェイはあなたのトンネルに表示されます。開始を選択します。URL列に公開アドレスが表示されます。

URLの種類 #

URLの種類取得できるアドレス備考
ランダムサブドメイン選択したドメインの下に、自動生成された名前が付きます。最初のテストに適しています。
カスタムサブドメイン選択したドメインの下に、入力したサブドメインが付きます。残高が必要です。
カスタムドメインご自身のドメインのいずれか。残高が必要です。ドメインの一覧にはご自身のドメインが表示されます。空の場合は、先にDNSマネージャーでドメインを作成してください。カスタムドメインをご覧ください。

ゲートウェイトークン #

MCPゲートウェイトンネルには、作成時にそれぞれ専用のゲートウェイトークンが発行されます。これはゲートウェイの管理者トークンで、ゲートウェイのダッシュボードと管理APIは、このトークンがある場合にだけ変更を受け付けます。

  1. トンネルの設定アイコンを選択します。
  2. ゲートウェイトークンの横にある管理を選択します。ゲートウェイトークンウィンドウに、中央部分が隠されたトークンが表示されます。
  3. トークンの横にあるコピーボタンを選択します。常にトークン全体がコピーされます。その横の表示ボタンを選択すると、トークンが画面に表示されます。

ゲートウェイトークンは非公開にしてください。ゲートウェイのサーバー、ツール、クライアントトークンをすべて操作できます。MCPクライアントには入力しないでください。クライアントは、それぞれ専用のトークンを使います。

MCPクライアントを接続する #

  1. ゲートウェイのダッシュボードを開く #

    トンネルを開始した状態で、ブラウザーでhttps://<ADDRESS>/dashboardを開きます。サイドメニューの下部にあるAdmin token欄に、ゲートウェイトークンを貼り付けます。

  2. MCPサーバーを登録する #

    Serversを開き、Add Serverを選択します。サーバーには、URLで到達できるMCPサーバー(Streamable HTTPまたはSSE)、ローカルコマンド(stdio)、OpenAPIサービスを指定できます。Catalogには、インストールできる既成のMCPサーバーが一覧表示され、Toolsには、ゲートウェイがすべてのサーバーから集めたツールが表示されます。

  3. クライアントトークンを作成する #

    Clientsを開き、New Clientを選択します。Nameを入力してCreate Clientを選択します。ゲートウェイはClient Tokenを一度だけ表示します。今すぐコピーしてください。再度表示されることはありません。クライアント一覧のAllowed ServersとAllowed Groupsには、クライアントが使えるサーバーとツールグループが表示されます。

  4. 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の種類を選んでください。

「この機能を利用するには残高の購入が必要です。」

カスタムサブドメインとカスタムドメインには残高が必要です。ランダムサブドメインを使うか、残高を追加してください。プランと残高をご覧ください。

サポート