Skip to main content
このクイックスタートガイドでは、数分で Linkly AI を使って初めての AI 対応ローカルナレッジベースを構築し、基本的な使い方を学びます。
**手間を省きたいですか？AI に代わりにインストールしてもらいましょう。**Claude Code、Codex、Cursor のようにコマンドを実行できる AI アシスタントをすでにお使いなら、次の一文を送ってください。アシスタントがAgent 向けインストールガイドを読み、インストール・設定・検証を一歩ずつ案内してくれます —— あなた自身が手を動かす必要のあるステップについても、はっきり説明してくれます。
もちろん、このまま読み進めていただいてもまったく問題ありません。本ページはそれ自体が完全な手動インストールガイドです。

​
はじめに

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 を初めて起動すると、ガイドウィンドウがセットアップを案内します。そのあとに、ご自身のドキュメントを追加します：
1

初回起動ウィザードを完了する

ウィザードは 4 つの画面で構成されています —— カバー → 資料を取り込む → エージェントと接続 → 準備完了（右下の「1 / 2」「2 / 2」は中間の 2 画面のみをカウントします）。どの画面でも、上部の表示エリア右下にある 2 つの小さなボタンで、言語と外観をいつでも切り替えられます。
  • カバー：以下を読み、同意します: プライバシーポリシー ↗ にチェックを入れます。これは次に進むための必須項目です。テレメトリーのスイッチ Linkly AI の改善に協力する（匿名） はデフォルトでオンになっており、オフにすることもできます。チェックを入れたら 次へ をクリックします。
  • 資料を取り込む：サンプル資料 は必須項目で、ウィザードが開いた時点でバックグラウンドで展開とインデックス作成が始まります。その下にはシステムの「書類」「デスクトップ」「ダウンロード」の 3 つのフォルダが並んでおり、デフォルトではチェックが外れています。チェックを入れるとインデックス作成が始まります。macOS でこれらのフォルダを初めて読み取るときはシステムの許可ダイアログが表示され、拒否するとその行に「未許可」と表示されます。
  • エージェントと接続：「インストール」をクリックすると、バックグラウンドで Linkly CLI と Skills がインストールされます。クリックしなければインストールされません。「CLI と Skills を常に最新に」はデフォルトでオンです。この画面には、エージェントにそのまま送れるセットアップ用の指示文も表示されます。
  • 準備完了：始める をクリックするとウィザードが終了し、メインウィンドウのホームに移ります。ホーム上部のチェックリストが、フォルダの追加やエージェントとの接続などを引き続き案内します。
ウィザードにサインインのステップはありません。ローカルのインデックス作成、ローカル検索、MCP サービスは、サインインしなくてもすべて利用できます。公式 AI モデルを使いたいときは 設定 → アカウント からサインインしてください。サインインもほかのモデルの設定もしていない場合は、「質問」ページにサインインを促す案内が表示されます。
2

自分のドキュメントを追加する

ウィザードでフォルダを 1 つも選ばなかった場合、インデックスされているのはサンプル資料だけです。ご自身のファイルはまだインデックスされていません。 このステップを飛ばすと、検索しても実際のコンテンツは見つかりません。
どちらの方法でも構いません：
  • メインウィンドウのサイドバーで ライブラリ を開き、左の列にある「フォルダを追加」から、インデックスさせたいディレクトリを選びます —— 書類、ダウンロード、プロジェクトのディレクトリなど；
  • または ~/LinklyAI フォルダにファイルを入れます。このフォルダはデフォルトで監視されているため、置いたものは自動的にインデックスされます。
権限が不足しているとシステムに表示された場合（macOS でよく見られます）、システム設定 → プライバシーとセキュリティ → フルディスクアクセス で Linkly AI を追加し、アプリを再起動してください。
3

AI ツールに接続

Linkly AI の MCP サービスを普段お使いの AI ツールに追加し、スマートなドキュメント検索を実現します。
Skills を使った統合をお勧めします。これが最もシンプルな方法です。以下の Prompt を AI アシスタントにコピーし、案内に従って操作するだけで、ツールと Skills の統合を同時に完了できます：

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

手動で MCP ツールを統合することもできますが、より良い体験のために Skills のインストール をお勧めします：
ターミナルで以下を実行：
60606 は Linkly AI の MCP サービスのデフォルトポート番号です。接続できない場合は、トレイメニューの「MCP サーバー: 稼働中 (ポート …)」の行で実際のポート番号を確認できます。メインウィンドウの「エージェントの利用」ページで「MCP 接続設定を表示」をクリックしても確認できます。

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

アプリ起動後、Linkly AI はすぐにドキュメントのインデックス作成を開始し、継続的に監視します。数分から数十分で全インデックスが完了します（ドキュメント数やマシンの性能によります）。
初回起動後、Linkly AI はバックグラウンドで約 890MB のモデルファイルをダウンロードします —— セマンティック検索用が約 639MB、OCR 用が約 249MB です。回線状況によっては、数分から 1 時間以上かかる場合があります。キーワード検索はすぐに利用でき、影響を受けません。自然言語（セマンティック）検索は、ダウンロードとインデックス作成の両方が完了した後にご利用いただけます。
会議の録音、ポッドキャスト、講義の動画も検索したいですか？音声と動画の文字起こしはデフォルトで無効です——これらのファイルもインデックスされてファイル名では検索できますが、中で何が話されているかは検索できません。インデックス管理 ページを開き（メインウィンドウ左サイドバー下部のインデックスアイコンをクリックするか、トレイアイコンを右クリックして「インデックスを表示」を選択）、「抽出の強化」で「音声の文字起こし」と「動画の文字起こし」をオンにすれば、アプリが既存のファイルを自動的に処理します。各インデックススイッチの詳細はインデックスの設定をご覧ください。
LinklyAI を使う方法は 2 つあります：

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

グローバルショートカット ⌘ + L（Windows / Linux では Ctrl + L）で検索ランチャーウィンドウを開き、キーワードや説明的な言葉を入力して目的のドキュメントを探せます。トレイの L アイコンを右クリックし、メニューの「検索」を選んでも開けます（左クリックで開くのはメインウィンドウです）。旧バージョンからアップグレードした場合は以前のショートカットが引き継がれます。設定 → ショートカット で確認できます。さらにプレビュー、メタ情報の確認、ドキュメントを開く、リンクのコピーなどが可能です。詳しくは全文検索ランチャーのドキュメントをご覧ください。

AI Agent と一緒に使う

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