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

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 の紹介

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 アプリに適しています。エンドポイント：https://mcp.linkly.ai/mcp
このページではローカルアクセスと LAN アクセスの設定方法を説明します。リモートアクセス（パブリック）については、リモートアクセスガイドをご参照ください。

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 のインストールは不要で、直接接続できます。
ターミナルで以下を実行：
claude mcp add --transport http linkly-ai http://127.0.0.1:60606/mcp
60606 は Linkly AI の MCP サービスのデフォルトポート番号です。接続できない場合は、アプリの設定で実際のポート番号をご確認ください。

​
Stdio MCP

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

​
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 をエンドポイントとして使用し、リクエストヘッダーにアクセストークンを含めてください：
Authorization: Bearer <あなたのアクセストークン>
Linkly AI CLI を使用する場合は、以下のように接続できます：
linkly search "キーワード" --endpoint http://192.168.x.x:60606/mcp --token <あなたのアクセストークン>
LAN アクセスは HTTP 平文通信を使用しています。家庭など信頼できるネットワーク内でのみ使用することをお勧めします。公共の WiFi や信頼できないネットワーク環境では、この機能を有効にしないでください。

​
統合の検証

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

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

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

​
Skills との併用

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

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

​
パラメータ説明

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 ツールの紹介 を参照してください。