> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Linkly AI へのリモートアクセス

> パブリックトンネル + Auth 認証を使用して、ChatGPT・Claude.ai などのオンライン AI アプリケーションからローカルナレッジベースに安全にリモートアクセスします

## リモートアクセスとは

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 のリクエストとレスポンスのみを転送し、ドキュメントの内容は一切保存されません。

<Note>
  `mcp.linkly.ai` はクラウド上の MCP 中継サービスで、Linkly AI
  が公式に管理しています。データは匿名で送信され、Linkly AI
  は利用回数のみを表示目的で記録します。
</Note>

## 設定手順

<Steps>
  <Step title="Linkly AI アカウントを登録">
    [linkly.ai](https://linkly.ai) にアクセスしてアカウントを登録・ログインします。
  </Step>

  <Step title="API Key を生成">
    Dashboard の「API Key 管理」で「新規 API Key」をクリックし、`lkai_` で始まる Key を生成します。

    <Warning>
      API Key は大切に保管し、他の人に漏洩しないようにしてください。漏洩した Key はあなたのローカルナレッジベースへのアクセスに悪用される可能性があります。
    </Warning>
  </Step>

  <Step title="デスクトップアプリでトンネルに接続">
    Linkly AI Desktop を開き、**設定 → MCP** に移動して「リモートアクセス」エリアを見つけます：

    1. API Key 入力欄に先ほど生成した Key を貼り付けます
    2. 「パブリックトンネルに接続」ボタンをクリックします
    3. ステータスが <Badge stroke color="green">● 接続済み</Badge> になるまで待ちます
  </Step>

  <Step title="AI アプリで MCP サービスを追加">
    ChatGPT・Claude.ai など MCP をサポートする AI アプリで、以下の MCP エンドポイントを追加します：

    ```
    https://mcp.linkly.ai/mcp
    ```

    初回追加時に OAuth 認証フローがトリガーされます。案内に従ってブラウザでログインし、認可を完了してください。

    各アプリの具体的な設定方法については、[統合ドキュメント](/docs/ja/integration/use-in-claude)をご参照ください。
  </Step>
</Steps>

## OAuth 認証について

ChatGPT・Claude.ai などのオンライン AI アプリがリモート MCP サービスに初めて接続する際、自動的に OAuth 2.1 認証フローがトリガーされます：

1. AI アプリが MCP エンドポイントに認証が必要であることを検出します
2. 自動的に linkly.ai のログインページにリダイレクトされます
3. ログインして認証を確認すると、AI アプリがアクセストークンを取得します
4. 以降のリクエストには自動的にトークンが含まれ、再認証は不要です

<Tip>
  すでにブラウザで linkly.ai
  にログインしている場合、認証プロセスがより迅速に完了します。
</Tip>

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

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

## よくある質問

<AccordionGroup>
  <Accordion title="「API Key が無効です」と表示される">
    以下を確認してください：

    1. API Key が完全にペーストされているか（`lkai_` で始まる必要があります）
    2. API Key が Dashboard で失効されていないか
    3. Dashboard で新しい API Key を再生成してみてください
  </Accordion>

  <Accordion title="デスクトップアプリがオフラインの場合、リモート呼び出しがエラーを返す">
    リモート MCP サービスはデスクトップアプリが実行中でトンネルに接続されている必要があります。デスクトップアプリが終了しているか、トンネルが切断されている場合、リモート呼び出しは即座に 503 エラーを返します。

    以下を確認してください：

    * Linkly AI Desktop が起動していること
    * MCP サービスが実行中であること（設定に Running と表示）
    * トンネルのステータスが <Badge stroke color="green">● 接続済み</Badge> であること
  </Accordion>

  <Accordion title="トンネル接続が切断される">
    トンネルには自動再接続メカニズムがあります（最大 10 回リトライ、指数バックオフ戦略を採用）。頻繁に切断される場合は以下を確認してください：

    * ネットワーク接続が安定しているか
    * API Key がまだ有効か

    継続的に切断される場合は、手動で切断してから再接続をお試しください。
  </Accordion>

  <Accordion title="OAuth 認証に失敗する">
    ChatGPT または Claude.ai で MCP を追加した後に認証が失敗する場合：

    1. デスクトップアプリのトンネルが接続状態であることを確認します
    2. ブラウザで事前に linkly.ai にログインしてみてください
    3. AI アプリで MCP サーバーを再度追加してみてください

    問題が続く場合は、追加済みの MCP サーバーを削除してから再度追加してください。
  </Accordion>
</AccordionGroup>