メインコンテンツへスキップ

​
リモートアクセスとは

Linkly AI はあなたのローカルマシン上で動作していますが、ChatGPT・Claude.ai などのオンライン AI アプリはクラウド上で動作しており、ローカルのナレッジベース MCP サービスに直接アクセスすることができません。 リモートアクセス機能は、デスクトップアプリとクラウドの間に安全なトンネルを確立し、パブリックネットワーク経由での中継を実現します：
  1. デスクトップアプリは API Key 認証を使用して、mcp.linkly.ai への WebSocket トンネル接続を確立します
  2. オンライン AI アプリは OAuth 認証後、MCP リクエストを https://mcp.linkly.ai/mcp に送信します
  3. クラウドサービスがリクエストをトンネル経由でデスクトップアプリに転送し、デスクトップアプリが実行して結果を返します
あなたのドキュメントデータは常にローカルに保存されており、トンネルは MCP のリクエストとレスポンスのみを転送し、ドキュメントの内容は一切保存されません。
mcp.linkly.ai はクラウド上の MCP 中継サービスで、Linkly AI が公式に管理しています。データは匿名で送信され、Linkly AI は利用回数のみを表示目的で記録します。

​
設定手順

1

Linkly AI アカウントを登録

linkly.ai にアクセスしてアカウントを登録・ログインします。
2

API Key を生成

Dashboard の「API Key 管理」で「新規 API Key」をクリックし、lkai_ で始まる Key を生成します。
API Key は大切に保管し、他の人に漏洩しないようにしてください。漏洩した Key はあなたのローカルナレッジベースへのアクセスに悪用される可能性があります。
3

デスクトップアプリでトンネルに接続

Linkly AI Desktop を開き、設定 → MCP に移動して「リモートアクセス」エリアを見つけます：
  1. API Key 入力欄に先ほど生成した Key を貼り付けます
  2. 「パブリックトンネルに接続」ボタンをクリックします
  3. ステータスが ● 接続済み になるまで待ちます
4

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

ChatGPT・Claude.ai など MCP をサポートする AI アプリで、以下の MCP エンドポイントを追加します：
https://mcp.linkly.ai/mcp
初回追加時に OAuth 認証フローがトリガーされます。案内に従ってブラウザでログインし、認可を完了してください。各アプリの具体的な設定方法については、統合ドキュメントをご参照ください。

​
OAuth 認証について

ChatGPT・Claude.ai などのオンライン AI アプリがリモート MCP サービスに初めて接続する際、自動的に OAuth 2.1 認証フローがトリガーされます：
  1. AI アプリが MCP エンドポイントに認証が必要であることを検出します
  2. 自動的に linkly.ai のログインページにリダイレクトされます
  3. ログインして認証を確認すると、AI アプリがアクセストークンを取得します
  4. 以降のリクエストには自動的にトークンが含まれ、再認証は不要です
すでにブラウザで linkly.ai にログインしている場合、認証プロセスがより迅速に完了します。

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

  • API Key の保管：API Key はトンネルの認証情報に相当します。他の人と共有しないでください。漏洩が疑われる場合は、Dashboard で失効させて再生成できます
  • HTTPS 通信：リモートトンネルは全過程で HTTPS/WSS 暗号化通信を使用し、データのセキュリティを確保します
  • 随時失効可能：デスクトップアプリでいつでもトンネルを切断できます。Dashboard で API Key を失効させると新規接続や再接続を防止できますが、既に確立されているトンネルセッションは即座には切断されません
  • データはローカルに留まる：あなたのドキュメントデータは常にローカルコンピュータに保存されており、トンネルは MCP ツール呼び出しのリクエストとレスポンスのみを転送します

​
よくある質問

以下を確認してください：
  1. API Key が完全にペーストされているか（lkai_ で始まる必要があります）
  2. API Key が Dashboard で失効されていないか
  3. Dashboard で新しい API Key を再生成してみてください
リモート MCP サービスはデスクトップアプリが実行中でトンネルに接続されている必要があります。デスクトップアプリが終了しているか、トンネルが切断されている場合、リモート呼び出しは即座に 503 エラーを返します。以下を確認してください：
  • Linkly AI Desktop が起動していること
  • MCP サービスが実行中であること（設定に Running と表示）
  • トンネルのステータスが ● 接続済み であること
トンネルには自動再接続メカニズムがあります（最大 10 回リトライ、指数バックオフ戦略を採用）。頻繁に切断される場合は以下を確認してください：
  • ネットワーク接続が安定しているか
  • API Key がまだ有効か
継続的に切断される場合は、手動で切断してから再接続をお試しください。
ChatGPT または Claude.ai で MCP を追加した後に認証が失敗する場合：
  1. デスクトップアプリのトンネルが接続状態であることを確認します
  2. ブラウザで事前に linkly.ai にログインしてみてください
  3. AI アプリで MCP サーバーを再度追加してみてください
問題が続く場合は、追加済みの MCP サーバーを削除してから再度追加してください。