Skip to main content

​
リモートアクセスとは

Linkly AI はあなたのローカルマシン上で動作していますが、ChatGPT・Claude.ai などのオンライン AI アプリはクラウド上で動作しており、ローカルのナレッジベース MCP サービスに直接アクセスすることができません。 リモートアクセスは、デスクトップアプリとクラウドの間に安全なトンネルを確立し、パブリックネットワーク経由での中継を実現します：
  1. デスクトップアプリが mcp.linkly.ai への WebSocket トンネル接続を確立します
  2. オンライン AI アプリは OAuth 認可後、MCP リクエストを https://mcp.linkly.ai/mcp に送信します
  3. クラウドサービスがリクエストをトンネル経由でデスクトップアプリに転送し、デスクトップアプリが実行して結果を返します
あなたのドキュメントデータは常にローカルに保存されており、トンネルは MCP のリクエストとレスポンスのみを転送し、ドキュメントの内容は一切保存されません。
リモートアクセスは Pro 限定の機能です。無料アカウントでも「リモートアクセスを許可（インターネット）」のスイッチはオンにできますが、接続はサーバー側で拒否され、スイッチは自動的にオフに戻り、ステータスに「Pro が必要」と表示されます。クラウドの AI に読ませたいのが特定の一群の資料だけなら、アップグレードは不要です——クラウドライブラリは無料アカウントで使えて、しかもマシンの電源が入っている必要もありません。両者の違いは下のどちらを選ぶべきかをご覧ください。
mcp.linkly.ai はクラウド上の MCP 中継サービスで、Linkly AI が公式に管理しています。データは匿名で送信され、Linkly AI は利用回数のみを表示目的で記録します。

​
どちらを選ぶべきか

リモートアクセスもクラウドライブラリも、クラウド上の AI にあなたの資料を読ませるための機能ですが、解決している方向が違います： 両方を同時に使っても構いませんし、互いに干渉もしません。
見落とされがちな 3 つ目のケースもあります：AI クライアントが同じマシンにインストールされている場合（Claude Code、Cursor、Cherry Studio など）、そもそもトンネルは要りません——ローカルの http://127.0.0.1:60606/mcp に直接つなげば、無料でしかも高速です。MCP の使い方をご覧ください。

​
設定手順

1

Linkly AI アカウントにサインインし、Pro にアップグレードする

デスクトップアプリの 設定 → アカウント で「サインイン」をクリックすると、ブラウザで認可を終えたあと自動的にアプリへ戻ります。サインインすると API キーは自動的に取得されるので、ダッシュボードから手作業でコピー＆ペーストする必要はありません。リモートアクセスには Pro サブスクリプションが必要です。公式サイトの料金ページからアップグレードできます。
特別な事情がある場合（指定の Key を使いたいなど）は、設定 → アカウント の下部にある「任意：API キーを手動で設定してアカウントを接続」から手動で貼り付けることもできます。Key は lkai_ で始まり、ダッシュボードで生成できます。
2

デスクトップアプリでリモートアクセスをオンにする

  1. メインウィンドウ左サイドバー下部のエージェントアイコンをクリックし、「エージェントの利用」ページを開きます
  2. 「管理」セクションで「リモートアクセスを許可（インターネット）」をオンにします。「ローカルアクセスを許可」もオンのままにしておく必要があります。オフだとこのスイッチはオンにできません
  3. ステータスが ● 接続済み になるまで待ちます。「未サインイン」と表示されてスイッチが自動的にオフに戻った場合は、まだサインインしていないので、前の手順を先に済ませてください
  4. パブリックアドレスは「連携」セクションの「MCP 接続設定を表示」にあります：ダイアログの「リモート（インターネット）」セクションに、アドレスとそのままコピーできる設定が表示されます
3

AI アプリで MCP サービスを追加

ChatGPT・Claude.ai・Gemini CLI・Devin Desktop・n8n・Dify など MCP をサポートする AI アプリで、以下の MCP エンドポイントを追加します：
初回追加時に OAuth 認可フローがトリガーされます。案内に従ってブラウザでログインし、認可を完了してください。API Key をコピーする必要はありません。各アプリの具体的な設定方法については、統合の概要をご参照ください。
代わりに Linkly AI CLI から使う場合（サーバーやコンテナ上など）は、そのマシンで linkly auth login を実行してください。どのデバイスでも開けるリンクが表示され、認可すると新しい API Key が保存されます。あとは任意のコマンドに --remote を付けるだけです。既存のキーを貼り付けたい場合は、ご自身のターミナルで linkly auth set-key lkai_… を実行してください。AI アシスタントには実行させないでください。詳しくはCLI の使い方 → リモートモードをご覧ください。

​
接続ステータス一覧

「リモートアクセスを許可（インターネット）」の行にはトンネルの接続ステータスが表示され、接続設定ダイアログの「リモート（インターネット）」セクションに表示されるのも同じものです。このステータスを読み取れれば、どこに問題があるか判断できます：

​
OAuth 認可について

AI アプリがリモート MCP サービスに初めて接続する際、自動的に OAuth 2.1 認可フローがトリガーされます：
  1. AI アプリが MCP エンドポイントに認可が必要であることを検出します
  2. 自動的に linkly.ai のログインページにリダイレクトされます。新しいアカウントで初めてログインすると、先に「プロフィールを設定」ページで表示名とユーザー名を設定します
  3. 認可ページには許可後にどのドメインへ移動するかが表示されます。今使っている AI アプリであることを確認してから 許可 をクリックします：オンラインアプリなら自身のドメイン（claude.ai、chatgpt.com など）、コンピューター上のコマンドラインツール（Gemini CLI、Kimi Code など）ならローカルアドレス（localhost または 127.0.0.1）、セルフホストの n8n や Dify ならあなた自身のサーバーアドレスが表示されます
  4. AI アプリがアクセストークンを取得し、以降のリクエストには自動的に含まれるため、再認可は不要です
使わなくなったアプリは、ダッシュボードの「連携」ページの「許可済みのアプリ」で取り消せます。取り消し後も最大 1 時間はアクセスでき、その後は再度の許可が必要です。
すでにブラウザで linkly.ai にログインしている場合、認可プロセスがより迅速に完了します。

​
セキュリティに関する注意事項

  • 資格情報の保管：トンネルの資格情報は、あなたのローカルナレッジベースにアクセスするための鍵に相当します。他の人と共有せず、どの AI との会話（ChatGPT、Claude、Cursor、Codex、Doubao、Kimi など）にも貼り付けないでください。会話の内容はモデルの提供元に送られ、会話履歴に残ります。オンラインの AI アプリは OAuth 認可で、CLI を使う AI アシスタントは linkly auth login で接続できるため、キーをコピーする必要はありません。キーが会話に出てしまった場合や漏洩が疑われる場合は、ダッシュボードで API キーを失効させて再生成できます
  • HTTPS 通信：リモートトンネルは全過程で HTTPS/WSS 暗号化通信を使用します
  • 随時失効可能：デスクトップアプリでいつでもトンネルを切断できます。ダッシュボードで API キーを失効させると新規接続や再接続を防止できますが、すでに確立されているトンネルセッションは即座には切断されません。OAuth で接続した AI アプリは、「連携」ページの「許可済みのアプリ」で取り消します
  • 機密情報の自動マスキング：リモート MCP 経由で返される内容は、API Key、パスワード、秘密鍵、銀行カード番号、身分証番号など 200 種類以上の機密情報を [REDACTED:種類] マーカーに置き換えてから AI アプリに渡されます。ノートは、AI がノートを編集するときに原文を上書きしてしまわないよう、今のところマスキングしません。これは漏洩のリスクを下げるものですが、万全ではありません。特に重要な資料は、除外ルールでインデックスの外に置くことをお勧めします。ローカルと LAN の接続はクラウドを経由しないため、置き換えは行いません
  • データはクラウドに上がらない：あなたのドキュメントデータは常にローカルコンピュータに保存されており、トンネルは MCP ツール呼び出しのリクエストとレスポンスのみを転送します

​
よくある質問

現在のアカウントが Pro ではないということです——トンネルの確立はサーバー側で直接拒否されます（HTTP 402）。取れる道は 2 つです：
  • Pro にアップグレードする：料金ページでアップグレードしてから、「リモートアクセスを許可（インターネット）」のスイッチをもう一度オンにします
  • クラウドライブラリに切り替える：リモートから読ませたい資料をクラウドにプッシュします。無料アカウントで使えて、マシンの電源が落ちていても検索できます
踏みやすい落とし穴が 1 つあります：クラウドライブラリを使う場合でも、検索時にはライブラリを明示的に指定する必要があります（library="cloud://owner/slug"）。ライブラリのパラメータを省くと、リクエストは既定であなたのマシンへルーティングされます——つまりトンネル経由になり、無料アカウントはこの経路で Pro の案内を受け取ることになります。
次の順に確認してください：
  1. 設定 → アカウント に「Linkly AI Cloud に接続済み」と表示されているか確認します。表示されていなければ、先にサインインしてください
  2. API キーを手動で入力した場合は、完全に貼り付けられているか（lkai_ で始まる）、ダッシュボードで失効させていないかを確認します
  3. ダッシュボードで新しい API キーを再生成するか、いったんサインアウトして再度サインインし、自動取得させます
リモート MCP サービスはデスクトップアプリが実行中でトンネルに接続されている必要があります。デスクトップアプリが終了しているか、トンネルが切断されている場合、リモート呼び出しは即座に 503 エラーを返します。以下を確認してください：
  • Linkly AI Desktop が起動していること
  • MCP サービスが実行中であること（「エージェントの利用」ページの「管理」セクションで、「ローカルアクセスを許可」の行に「実行中」と表示）
  • トンネルのステータスが ● 接続済み であること
「マシンの電源が落ちていても検索したい」のであれば、必要なのはトンネルではなくクラウドライブラリです。
トンネルは切断されると自動的に再接続します。回数の上限はなく、再試行の間隔は 1 秒から始まって毎回倍になり、最長 120 秒です。再接続中、ステータスは「接続中」と表示されます。頻繁に切断される場合は以下を確認してください：
  • ネットワーク接続が安定しているか
  • 資格情報がまだ有効か
継続的に切断される場合は、「リモートアクセスを許可（インターネット）」のスイッチをいったんオフにしてから、もう一度オンにしてみてください。
ChatGPT または Claude.ai で MCP を追加した後に認可が失敗する場合：
  1. デスクトップアプリのトンネルが接続状態であることを確認します
  2. ブラウザで事前に linkly.ai にログインしてみてください
  3. AI アプリで MCP サーバーを再度追加してみてください
問題が続く場合は、追加済みの MCP サーバーを削除してから再度追加してください。

​
関連ページ