> ## 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.

# MCP を使って AI アシスタントに統合

> Linkly AI MCP を使用して、より高い柔軟性とよりギークな体験を得る方法をご紹介します。

## MCP の紹介

MCP（Model Context Protocol）は、AI アシスタントが外部ツールを呼び出してコンテキスト情報を取得できるようにするオープンプロトコルです。Linkly AI Desktop には MCP サービスが組み込まれており、インストール後に自動起動するため、追加の設定は不要です。

Linkly AI の MCP エンドポイントを AI アシスタントに追加するだけで、AI がローカルドキュメントを直接検索、閲覧、読み取りできるようになります。

## 3 つのアクセスモード

Linkly AI は異なるシナリオに対応した 3 つの MCP アクセスモードを提供しています：

<CardGroup cols={3}>
  <Card title="ローカルアクセス" icon="computer" iconType="duotone">
    ローカルマシンの AI ツールで直接使用できます。追加設定は不要です。Claude Code、Cursor などのローカルアプリに適しています。

    エンドポイント：`http://127.0.0.1:60606/mcp`
  </Card>

  <Card title="LAN アクセス" icon="wifi" iconType="duotone">
    同じネットワーク上の他のデバイスからも接続できます。LAN アクセスを有効にしてアクセストークンを使用する必要があります。

    エンドポイント：`http://{LAN IP}:60606/mcp`
  </Card>

  <Card title="リモートアクセス（パブリック）" icon="globe" iconType="duotone" href="/ja/use-in-remote">
    トンネルを通じてパブリックネットワークからリモートアクセスできます。ChatGPT、Claude.ai などのオンライン AI アプリに適しています。

    エンドポイント：`https://mcp.linkly.ai/mcp`
  </Card>
</CardGroup>

このページではローカルアクセスと LAN アクセスの設定方法を説明します。リモートアクセス（パブリック）については、[リモートアクセスガイド](/ja/use-in-remote)をご参照ください。

<CardGroup cols={2}>
  <Card title="HTTP MCP（推奨）" icon="globe" iconType="duotone">
    ほとんどの AI アシスタントは HTTP
    トランスポートプロトコルをサポートしており、Linkly AI の MCP
    エンドポイントに直接接続できます。CLI のインストールは不要です
  </Card>

  <Card title="Stdio MCP" icon="terminal" iconType="duotone">
    一部の AI アシスタントは stdio
    トランスポートプロトコルのみをサポートしており、Linkly AI CLI
    をブリッジとして使用する必要があります
  </Card>
</CardGroup>

<Tip>
  どちらを選ぶか迷った場合は、HTTP MCP を選んでください。AI アシスタントが HTTP
  トランスポートを明示的にサポートしていない場合のみ、Stdio
  方式を使用してください。
</Tip>

## 前提条件

<Steps>
  <Step title="Linkly AI Desktop をインストールして起動">
    [linkly.ai](https://linkly.ai/#download) からデスクトップアプリをダウンロードしてインストールします。初回起動後に初期化ウィザードを完了すると、アプリが自動的にドキュメントのインデックス作成を開始します。
  </Step>

  <Step title="MCP サービスの起動を確認">
    Linkly AI Desktop を起動すると、MCP サービスが自動的に実行されます。アプリの設定で MCP サービスのステータスとポート番号を確認できます。

    デフォルト MCP エンドポイント：`http://127.0.0.1:60606/mcp`
  </Step>
</Steps>

<Note>
  Stdio MCP 方式を選択する場合は、追加で [Linkly AI CLI
  のインストール](./use-cli) が必要です。
</Note>

## 使い方

### HTTP MCP（推奨）

HTTP/StreamableHTTP トランスポートプロトコルをサポートする AI アシスタントに適用されます。CLI のインストールは不要で、直接接続できます。

<Tabs>
  <Tab title="Claude Code" icon="terminal">
    ターミナルで以下を実行：

    ```bash theme={null}
    claude mcp add --transport http linkly-ai http://127.0.0.1:60606/mcp
    ```
  </Tab>

  <Tab title="Cursor" icon="code">
    1. Settings → MCP Servers → Add Server を開く
    2. Name: `linkly-ai`
    3. Type: `StreamableHTTP`
    4. URL: `http://127.0.0.1:60606/mcp`
  </Tab>

  <Tab title="Codex" icon="robot">
    ターミナルで以下を実行：

    ```bash theme={null}
    codex mcp add linkly-ai --url http://127.0.0.1:60606/mcp
    ```
  </Tab>

  <Tab title="Cherry Studio" icon="star">
    1. Settings → MCP Servers → Add を開く
    2. Name: `linkly-ai`
    3. Type: `StreamableHTTP`
    4. URL: `http://127.0.0.1:60606/mcp`
  </Tab>
</Tabs>

<Tip>
  `60606` は Linkly AI の MCP
  サービスのデフォルトポート番号です。接続できない場合は、アプリの設定で実際のポート番号をご確認ください。
</Tip>

### Stdio MCP

stdio トランスポートプロトコルをサポートする AI アシスタントに適用されます。まず [Linkly AI CLI をインストール](./use-cli#インストール) し、`linkly mcp` を stdio ブリッジコマンドとして AI アシスタントに設定します。

<Tabs>
  <Tab title="Claude Code" icon="terminal">
    ターミナルで以下を実行：

    ```bash theme={null}
    claude mcp add linkly-ai -- linkly mcp
    ```
  </Tab>

  <Tab title="Codex" icon="robot">
    ターミナルで以下を実行：

    ```bash theme={null}
    codex mcp add linkly-ai -- linkly mcp
    ```
  </Tab>

  <Tab title="Cherry Studio" icon="star">
    1. Settings → MCP Servers → Add を開く
    2. Name: `linkly-ai`
    3. Type: `stdio`
    4. Command: `linkly`
    5. Args: `mcp`
  </Tab>

  <Tab title="その他の AI アシスタント" icon="puzzle-piece">
    その他の stdio MCP をサポートする AI アシスタントの場合、以下のコマンドを MCP サーバーとして設定してください：

    * コマンド: `linkly`
    * 引数: `mcp`

    CLI はローカルで実行中の Linkly AI Desktop を自動的に検出して接続を確立します。
  </Tab>
</Tabs>

### LAN アクセス

同じネットワーク上の他のデバイス（別のパソコン、NAS 上の n8n など）から Linkly AI にアクセスする必要がある場合は、LAN アクセスモードを有効にできます。

<Steps>
  <Step title="LAN アクセスを有効化">
    Linkly AI Desktop で **設定 → MCP** に移動し、「LAN アクセス」エリアを見つけてスイッチをオンにします。
  </Step>

  <Step title="LAN URL とアクセストークンを取得">
    有効化すると、以下の情報が表示されます：

    * **LAN URL**：`http://192.168.x.x:60606/mcp` のような形式
    * **アクセストークン**：ランダムな文字列

    これらの情報を接続するデバイスにコピーしてください。
  </Step>

  <Step title="他のデバイスで設定">
    他のデバイスの AI ツールで MCP サーバーを追加する際、LAN URL をエンドポイントとして使用し、リクエストヘッダーにアクセストークンを含めてください：

    ```
    Authorization: Bearer <あなたのアクセストークン>
    ```

    Linkly AI CLI を使用する場合は、以下のように接続できます：

    ```bash theme={null}
    linkly search "キーワード" --endpoint http://192.168.x.x:60606/mcp --token <あなたのアクセストークン>
    ```
  </Step>
</Steps>

<Warning>
  LAN アクセスは HTTP
  平文通信を使用しています。家庭など信頼できるネットワーク内でのみ使用することをお勧めします。公共の
  WiFi や信頼できないネットワーク環境では、この機能を有効にしないでください。
</Warning>

### 統合の検証

設定完了後、AI アシスタントで以下のプロンプトを送信して検証できます：

<Prompt description="ドキュメントの中から XX に関する内容を検索して">
  ドキュメントの中からプロジェクト管理に関する内容を検索して
</Prompt>

統合が成功していれば、AI アシスタントが Linkly AI の `search` ツールを呼び出し、ローカルドキュメントの関連結果を返します。

### Skills との併用

MCP の設定と同時に [Linkly AI Skills のインストール](./use-skills) を強くお勧めします。Skills は AI アシスタントに Linkly AI のツールを効率的に使う方法を教えます。いつ検索し、いつアウトラインを閲覧し、いつ全文を読むべきか、また長いドキュメントのページ分割読み取りの処理方法なども含まれます。

<Prompt description="Agent Skill linkly-ai-skills をインストールして、LinklyAI のツールインテグレーションを完了してください...">
  Agent Skill linkly-ai-skills をインストールして、LinklyAI
  のツールインテグレーションを完了してください。参考：[https://linkly.ai/docs/ja/use-skills](https://linkly.ai/docs/ja/use-skills)
</Prompt>

## パラメータ説明

MCP サービスは 7 つのツールを公開しており、段階的なドキュメントアクセスワークフローを構成します：

* `search` — ハイブリッド検索（BM25 + ベクトル）、メインエントリーポイント
* `outline` — ドキュメントアウトライン
* `grep` — 単一ドキュメント内の正規表現マッチング
* `read` — 行ベースのドキュメント読み取り
* `list_libraries` — 利用可能なナレッジライブラリの一覧
* `explore` — ドキュメントコレクションの俯瞰
* `find_paths` — キーワードでフォルダパスを特定し、`search` の `path_glob` に渡す

成功した各応答には UTC タイムスタンプが付加されます：Markdown 出力では末尾に `[meta] now=...` 行、JSON 出力ではトップレベルの `_meta.now` フィールドとして付き、「先月」のような相対日付の計算に利用できます。エラー応答にはこのメタデータは付加されません。

完全なパラメータ表、返却フィールド、レスポンスメタデータ形式、使用例については、[Linkly AI MCP ツールの紹介](./tools-intro) を参照してください。