リモートアクセスとは
Linkly AI はあなたのローカルマシン上で動作していますが、ChatGPT・Claude.ai などのオンライン AI アプリはクラウド上で動作しており、ローカルのナレッジベース MCP サービスに直接アクセスすることができません。 リモートアクセスは、デスクトップアプリとクラウドの間に安全なトンネルを確立し、パブリックネットワーク経由での中継を実現します：- デスクトップアプリが
mcp.linkly.aiへの WebSocket トンネル接続を確立します - オンライン AI アプリは OAuth 認可後、MCP リクエストを
https://mcp.linkly.ai/mcpに送信します - クラウドサービスがリクエストをトンネル経由でデスクトップアプリに転送し、デスクトップアプリが実行して結果を返します
mcp.linkly.ai はクラウド上の MCP 中継サービスで、Linkly AI が公式に管理しています。データは匿名で送信され、Linkly AI は利用回数のみを表示目的で記録します。どちらを選ぶべきか
リモートアクセスもクラウドライブラリも、クラウド上の AI にあなたの資料を読ませるための機能ですが、解決している方向が違います：
両方を同時に使っても構いませんし、互いに干渉もしません。
設定手順
1
Linkly AI アカウントにサインインし、Pro にアップグレードする
デスクトップアプリの 設定 → アカウント で「サインイン」をクリックすると、ブラウザで認可を終えたあと自動的にアプリへ戻ります。サインインすると API キーは自動的に取得されるので、ダッシュボードから手作業でコピー＆ペーストする必要はありません。リモートアクセスには Pro サブスクリプションが必要です。公式サイトの料金ページからアップグレードできます。
2
デスクトップアプリでトンネルに接続
設定 → MCP に移動し、「リモートアクセス」エリアを見つけて、右側のスイッチを入れて展開します：
- まだサインインしていない場合は「リモートアクセスを有効にするには、まずアカウントにサインインしてください。」と表示されます。「アカウント設定を開く」から前の手順を先に済ませてください
- 「トンネルを接続」ボタンをクリックします
- ステータスが ● 接続済み になるまで待ちます。下に「パブリック MCP エンドポイント」が現れます
3
AI アプリで MCP サービスを追加
ChatGPT・Claude.ai など MCP をサポートする AI アプリで、以下の MCP エンドポイントを追加します：初回追加時に OAuth 認可フローがトリガーされます。案内に従ってブラウザでログインし、認可を完了してください。各アプリの具体的な設定方法については、統合の概要をご参照ください。
接続ステータス一覧
「リモートアクセス」エリアのステータスラベルには次の値があります。読み取れれば、どこに問題があるか判断できます：OAuth 認可について
ChatGPT・Claude.ai などのオンライン AI アプリがリモート MCP サービスに初めて接続する際、自動的に OAuth 2.1 認可フローがトリガーされます：- AI アプリが MCP エンドポイントに認可が必要であることを検出します
- 自動的に linkly.ai のログインページにリダイレクトされます
- ログインして認可を確認すると、AI アプリがアクセストークンを取得します
- 以降のリクエストには自動的にトークンが含まれ、再認可は不要です
セキュリティに関する注意事項
- 資格情報の保管：トンネルの資格情報は、あなたのローカルナレッジベースにアクセスするための鍵に相当します。他の人と共有しないでください。漏洩が疑われる場合は、ダッシュボードで API キーを失効させて再生成できます
- HTTPS 通信：リモートトンネルは全過程で HTTPS/WSS 暗号化通信を使用します
- 随時失効可能：デスクトップアプリでいつでもトンネルを切断できます。ダッシュボードで API キーを失効させると新規接続や再接続を防止できますが、すでに確立されているトンネルセッションは即座には切断されません
- データはクラウドに上がらない：あなたのドキュメントデータは常にローカルコンピュータに保存されており、トンネルは MCP ツール呼び出しのリクエストとレスポンスのみを転送します
よくある質問
ステータスが「アップグレードが必要」と表示される
ステータスが「アップグレードが必要」と表示される
現在のアカウントが Pro ではないということです——トンネルの確立はサーバー側で直接拒否されます（HTTP 402）。取れる道は 2 つです：
- Pro にアップグレードする：ステータスの下にある「Pro へアップグレード →」をクリックするか、直接料金ページへ
- クラウドライブラリに切り替える：リモートから読ませたい資料をクラウドにプッシュします。無料アカウントで使えて、マシンの電源が落ちていても検索できます
踏みやすい落とし穴が 1 つあります：クラウドライブラリを使う場合でも、検索時にはライブラリを明示的に指定する必要があります（
library="cloud://owner/slug"）。ライブラリのパラメータを省くと、リクエストは既定であなたのマシンへルーティングされます——つまりトンネル経由になり、無料アカウントはこの経路で Pro の案内を受け取ることになります。ステータスが「認証エラー」と表示される
ステータスが「認証エラー」と表示される
次の順に確認してください：
- 設定 → アカウント に「Linkly AI Cloud に接続済み」と表示されているか確認します。サインインしていない場合、リモートアクセスのエリアには「リモートアクセスを有効にするには、まずアカウントにサインインしてください。」と直接表示されます
- API キーを手動で入力した場合は、完全に貼り付けられているか（
lkai_で始まる）、ダッシュボードで失効させていないかを確認します - ダッシュボードで新しい API キーを再生成するか、いったんサインアウトして再度サインインし、自動取得させます
デスクトップアプリがオフラインの場合、リモート呼び出しがエラーを返す
デスクトップアプリがオフラインの場合、リモート呼び出しがエラーを返す
リモート MCP サービスはデスクトップアプリが実行中でトンネルに接続されている必要があります。デスクトップアプリが終了しているか、トンネルが切断されている場合、リモート呼び出しは即座に 503 エラーを返します。以下を確認してください：
- Linkly AI Desktop が起動していること
- MCP サービスが実行中であること（設定 → MCP の上部に「実行中」と表示）
- トンネルのステータスが ● 接続済み であること
トンネルが頻繁に切断される
トンネルが頻繁に切断される
トンネルには自動再接続メカニズムがあります（最大 10 回リトライ、指数バックオフ戦略）。その間、ステータスは「再接続中（試行 N 回目）」と表示されます。頻繁に切断される場合は以下を確認してください：
- ネットワーク接続が安定しているか
- 資格情報がまだ有効か
OAuth 認可に失敗する
OAuth 認可に失敗する
ChatGPT または Claude.ai で MCP を追加した後に認可が失敗する場合：
- デスクトップアプリのトンネルが接続状態であることを確認します
- ブラウザで事前に linkly.ai にログインしてみてください
- AI アプリで MCP サーバーを再度追加してみてください
関連ページ
- 統合の概要 —— 4 つの接続経路の違いと選び方
- クラウドライブラリの使い方 —— 無料で、マシンの起動に依存しない経路
- MCP の使い方 —— ローカルと LAN の 2 つのモード
- Linkly AI アカウント —— サインイン、Pro、API キー