メインコンテンツへスキップ
このクイックスタートガイドでは、数分で Linkly AI を使って初めての AI 対応ローカルナレッジベースを構築し、基本的な使い方を学びます。

​
はじめに

Linkly AI には以下のコアアプリケーションと機能が含まれています：

Linkly AI Desktop

デスクトップアプリケーション（略称 Linkly AI）。インストール後に自動的にドキュメントのインデックスを作成し、検索、アウトライン、読み取りなどのツールを提供します。

Linkly AI CLI

コマンドラインツール。Bash で Linkly AI アプリに接続してツールを呼び出すことができ、AI Agent での利用に適しています。

MCP Server

Agent がコンテキストを取得するためのオープンプロトコル。Linkly AI のインストール後に MCP サービスが自動起動し、AI Agent からの呼び出しに対応します。

linkly-ai-skills

公式提供の Agent Skills。Agent が Linkly AI のツールサービスを接続・利用する方法をガイドします。インストールを強くお勧めします。

​
ステップ 1：Linkly AI をインストール

公式サイトのダウンロードページにアクセスし、お使いの OS に合ったバージョンを選択してください：

Linkly AI をダウンロード

お使いの OS に合ったバージョンを選択してください
 インストールパッケージをダブルクリックしてインストールします。各プラットフォームのインストール手順は以下の通りです：
1

インストールパッケージを開く

ダウンロードした .dmg ファイルをダブルクリックして、ディスクイメージをマウントします
2

アプリケーションフォルダにドラッグ

LinklyAI アイコンを Applications フォルダにドラッグします
3

アプリを起動

Launchpad または Finder の Applications フォルダで LinklyAI を見つけ、ダブルクリックして起動します

​
ステップ 2：Linkly AI を初期化

Linkly AI を初めて起動すると、ガイドウィザードが表示され、3 ステップの初期設定を完了できます：
1

インデックス対象のディレクトリを選択

Linkly AI にインデックスさせたいドキュメントディレクトリを選択します：
  • マイドキュメント：~/Documents または「マイドキュメント」ディレクトリ配下のすべてのドキュメントのみをインデックス
  • コンピュータ全体：アクセス可能なすべてのドキュメントをスキャン。最も広い範囲をカバーしますが、権限の付与が必要です
  • カスタムフォルダ：手動で特定のフォルダを選択
2

アクセス権限を確認

システムが選択したフォルダのアクセス権限を自動的に確認します。権限が不足している場合（macOS でよく見られます）、システム設定 → プライバシーとセキュリティ → フルディスクアクセス で Linkly AI を追加し、アプリを再起動してください。
3

AI ツールに接続

Linkly AI の MCP サービスを普段お使いの AI ツールに追加し、スマートなドキュメント検索を実現します。

Skills を使った統合をお勧めします。これが最もシンプルな方法です。以下の Prompt を AI アシスタントにコピーし、案内に従って操作するだけで、ツールと Skills の統合を同時に完了できます：

Agent Skill linkly-ai-skills をインストールして...

手動で MCP ツールを統合することもできますが、より良い体験のために Skills のインストール をお勧めします：
ターミナルで以下を実行：
claude mcp add --transport http linkly-ai http://127.0.0.1:606060/mcp
606060 は Linkly AI の MCP サービスのデフォルトポート番号です。接続できない場合は、アプリの設定で実際のポート番号をご確認ください。

​
ステップ 3：初めて使う

アプリ起動後、Linkly AI はすぐにドキュメントのインデックス作成を開始し、継続的に監視します。数分から数十分で全インデックスが完了します（ドキュメント数やマシンの性能によります）。
初回起動時に約 100MB のモデルファイルをダウンロードする必要があり、数分から数十分かかる場合がありますが、キーワード検索機能の利用には影響しません。ダウンロードが完了し、すべてのインデックスが作成された後、自然言語検索機能をご利用いただけます。
LinklyAI を使う方法は 2 つあります：

ランチャーでドキュメントを検索

トレイのアプリアイコン（L ロゴ）をクリックするか、グローバルショートカット CMD/Ctrl + Shift + L を使って検索ランチャーウィンドウを開き、キーワードや説明的な言葉を入力して目的のドキュメントを探せます。さらにプレビュー、メタ情報の確認、ドキュメントを開く、リンクのコピーなどが可能です。詳しくは全文検索ランチャーのドキュメントをご覧ください。

AI Agent と一緒に使う

こちらがより推奨される方法です。これまでにない対話体験とリサーチ効率を実現できます。AI アシスタントとの統合または Skills のインストールが完了したら、任意の Prompt の後に use linkly-ai を付けることで、Linkly AI の強力な検索機能を積極的に活用できます。