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

MCP の紹介

MCP(Model Context Protocol)は、AI アシスタントが外部ツールを呼び出してコンテキスト情報を取得できるようにするオープンプロトコルです。Linkly AI Desktop には MCP サービスが組み込まれており、インストール後に自動起動するため、追加の設定は不要です。 Linkly AI の MCP エンドポイントを AI アシスタントに追加するだけで、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:606060/mcp
Stdio MCP 方式を選択する場合は、追加で Linkly AI CLI のインストール が必要です。

使い方

HTTP MCP(推奨)

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

Stdio MCP

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

統合の検証

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

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

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

Skills との併用

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

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

パラメータ説明

MCP サービスは 3 つのツールを公開しています:search(検索)、outline(アウトライン)、read(読み取り)。これらは段階的なドキュメントアクセスワークフローを構成します。 ツールの説明ドキュメントをご参照ください:Linkly AI MCP ツールの紹介