Skip to main content

​
MCP の紹介

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

​
3 つのアクセスモード

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

ローカルアクセス

ローカルマシンの AI ツールで直接使用できます。追加設定は不要です。Claude Code、Cursor などのローカルアプリに適しています。エンドポイント：http://127.0.0.1:60606/mcp

LAN アクセス

同じネットワーク上の他のデバイスからも接続できます。LAN アクセスを有効にしてアクセストークンを使用する必要があります。エンドポイント：http://{LAN IP}:60606/mcp

リモートアクセス（パブリック）

トンネルを通じてパブリックネットワークからリモートアクセスできます。ChatGPT、Claude.ai などのオンライン AI アプリに適しています。Pro 限定。エンドポイント：https://mcp.linkly.ai/mcp
このページではローカルアクセスと LAN アクセスの設定方法を説明します。どちらも無料の機能です。リモートアクセス（パブリック）については、リモートアクセスガイドをご参照ください——こちらは Pro 限定の機能です。クラウドの AI に読ませたいのが特定の一群の資料だけであれば、無料のクラウドライブラリの方が適していることが多く、各経路の使い分けは統合の概要をご覧ください。

HTTP MCP（推奨）

ほとんどの AI アシスタントは HTTP トランスポートプロトコルをサポートしており、Linkly AI の MCP エンドポイントに直接接続できます。CLI のインストールは不要です

Stdio MCP

一部の AI アシスタントは stdio トランスポートプロトコルのみをサポートしており、Linkly AI CLI をブリッジとして使用する必要があります
どちらを選ぶか迷った場合は、HTTP MCP を選んでください。AI アシスタントが HTTP トランスポートを明示的にサポートしていない場合のみ、Stdio 方式を使用してください。

​
前提条件

1

Linkly AI Desktop をインストールして起動

linkly.ai からデスクトップアプリをダウンロードしてインストールします。初回起動後に初期化ウィザードを完了すると、アプリが自動的にドキュメントのインデックス作成を開始します。
2

MCP サービスの起動を確認

Linkly AI Desktop を起動すると、MCP サービスが自動的に実行されます。アプリの設定で MCP サービスのステータスとポート番号を確認できます。デフォルト MCP エンドポイント：http://127.0.0.1:60606/mcp
Stdio MCP 方式を選択する場合は、追加で Linkly AI CLI のインストール が必要です。

​
使い方

​
HTTP MCP（推奨）

HTTP/StreamableHTTP トランスポートプロトコルをサポートする AI アシスタントに適用されます。CLI のインストールは不要で、直接接続できます。
ターミナルで以下を実行：
60606 は Linkly AI の MCP サービスのデフォルトポート番号です。接続できない場合は、アプリの設定で実際のポート番号をご確認ください。

​
Stdio MCP

stdio トランスポートプロトコルをサポートする AI アシスタントに適用されます。まず Linkly AI CLI をインストール し、linkly mcp を stdio ブリッジコマンドとして AI アシスタントに設定します。
ターミナルで以下を実行：

​
LAN アクセス

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

LAN アクセスを有効化

Linkly AI Desktop で 設定 → MCP に移動し、「LAN アクセス」エリアを見つけてスイッチをオンにします。
2

LAN URL とアクセストークンを取得

有効化すると、以下の情報が表示されます：
  • LAN URL：http://192.168.x.x:60606/mcp のような形式
  • アクセストークン：ランダムな文字列
これらの情報を接続するデバイスにコピーしてください。
3

他のデバイスで設定

他のデバイスの AI ツールで MCP サーバーを追加する際、LAN URL をエンドポイントとして使用し、リクエストヘッダーにアクセストークンを含めてください：
Linkly AI CLI を使用する場合は、以下のように接続できます：
LAN アクセスは HTTP 平文通信を使用しています。家庭など信頼できるネットワーク内でのみ使用することをお勧めします。公共の WiFi や信頼できないネットワーク環境では、この機能を有効にしないでください。

​
設定した後は再読み込みが必要です

MCP の設定を書き込んでも、新しいツールは今開いている会話にはすぐには現れません — 大半の AI クライアントは、セッションが始まったその瞬間にツール一覧を一度だけ読み込みます。これはクライアント側の読み込みの仕組みであって、設定ミスではありません。 方法は 2 つ。まず 1 つ目を試してください：
  1. 新しい会話を始める（コマンドラインツールの場合は、いったん終了して新しいセッションを開く）。すでに進行中の会話は開始時点のツール一覧を使い続けるため、新しく始めれば最新のものが読み込まれます。
  2. クライアントを完全に終了してから、開き直す。 1 つ目で解決しないときはこちらを使います — ウィンドウを閉じることは終了ではない点に注意してください：macOS では Cmd + Q を押すかメニューバーから「終了」を選び、Windows ではタスクトレイからも終了しているか確認します。
再読み込みが済んだら、下の検証手順に戻ってください。ツールが 1 つも欠けておらず、特定のツールだけが使えない場合は、この下の《新しく追加されたツールが表示されない場合》をご覧ください。

​
統合の検証

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

ドキュメントの中から XX に関する内容を検索して

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

​
新しく追加されたツールが表示されない場合

Linkly AI では MCP ツールを随時追加しています。多くの AI クライアントはセッションが始まったその瞬間にツール一覧を一度だけ取得し、その後は自動的に更新しません。そのため、新しく追加されたツールはクライアントが一覧を取得し直すまで表示されません。 このドキュメントに記載されているツールがクライアント側に見当たらない場合：
  1. クライアントで接続を更新します。ChatGPT の場合は 設定 → コネクタ → 該当のコネクタ → 更新（Refresh）。
  2. それでも表示されない場合は、接続を削除してから追加し直してください。
  3. 新しい会話を開始してください。進行中の会話は、開始時点のツール一覧を使い続けます。

​
Skills との併用

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

Agent Skill linkly-ai-skills をインストールして、LinklyAI のツールインテグレーションを完了してください...

​
パラメータ説明

MCP サービスは 9 つのツールを公開しており、段階的なドキュメントアクセスワークフローを構成します：
  • search — ハイブリッド検索（BM25 + ベクトル）、メインエントリーポイント
  • outline — ドキュメントアウトライン
  • grep — 単一ドキュメント内の正規表現マッチング
  • read — 行ベースのドキュメント読み取り
  • list_libraries — 利用可能なナレッジライブラリの一覧
  • explore — ドキュメントコレクションの俯瞰
  • find_paths — キーワードでフォルダパスを特定し、search の path_glob に渡す
  • list — コンテナ内の項目を列挙する：ディスクのディレクトリ（folder）、ライブラリ（library）、ノート（notes）
  • note_save — ノートを作成または編集する。唯一の書き込みツール
note_save 以外はすべて読み取り専用で、あなたのドキュメントを一切変更しません。 成功した各応答には UTC タイムスタンプが付加されます：Markdown 出力では末尾に [meta] now=... 行、JSON 出力ではトップレベルの _meta.now フィールドとして付き、「先月」のような相対日付の計算に利用できます。エラー応答にはこのメタデータは付加されません。 完全なパラメータ表、返却フィールド、レスポンスメタデータ形式、使用例については、Linkly AI MCP ツールの紹介 を参照してください。