> ## 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.

# クイックスタート

> このガイドに従って、数分で Linkly AI のインストールと統合を完了しましょう

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

## はじめに

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

<CardGroup cols={2}>
  <Card title="Linkly AI Desktop" icon="desktop" iconType="duotone">
    デスクトップアプリケーション（略称 Linkly
    AI）。インストール後に自動的にドキュメントのインデックスを作成し、検索、アウトライン、読み取りなどのツールを提供します。
  </Card>

  <Card title="Linkly AI CLI" icon="terminal" iconType="duotone">
    コマンドラインツール。Bash で Linkly AI
    アプリに接続してツールを呼び出すことができ、AI Agent
    での利用に適しています。
  </Card>

  <Card title="MCP Server" icon="plug" iconType="duotone">
    Agent がコンテキストを取得するためのオープンプロトコル。Linkly AI
    のインストール後に MCP サービスが自動起動し、AI Agent
    からの呼び出しに対応します。
  </Card>

  <Card title="linkly-ai-skills" icon="wand-magic-sparkles" iconType="duotone">
    公式提供の Agent Skills。Agent が Linkly AI
    のツールサービスを接続・利用する方法をガイドします。インストールを強くお勧めします。
  </Card>
</CardGroup>

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

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

<Card title="Linkly AI をダウンロード" icon="download" href="https://linkly.ai/#download">
  お使いの OS に合ったバージョンを選択してください
</Card>

インストールパッケージをダブルクリックしてインストールします。各プラットフォームのインストール手順は以下の通りです：

<Tabs>
  <Tab title="macOS" icon="apple">
    <Steps>
      <Step title="インストールパッケージを開く">
        ダウンロードした `.dmg`
        ファイルをダブルクリックして、ディスクイメージをマウントします
      </Step>

      <Step title="アプリケーションフォルダにドラッグ">
        **LinklyAI** アイコンを **Applications** フォルダにドラッグします
      </Step>

      <Step title="アプリを起動">
        Launchpad または Finder の Applications フォルダで **LinklyAI**
        を見つけ、ダブルクリックして起動します
      </Step>
    </Steps>
  </Tab>

  <Tab title="Windows" icon="windows">
    <Steps>
      <Step title="インストーラーを実行">
        ダウンロードした `.exe` インストールファイルをダブルクリックします
      </Step>

      <Step title="インストールを完了">
        インストールウィザードの案内に従ってインストールを完了します。デフォルトではユーザーディレクトリにインストールされます
      </Step>

      <Step title="アプリを起動">
        スタートメニューまたはデスクトップのショートカットから **LinklyAI**
        を起動します
      </Step>
    </Steps>
  </Tab>

  <Tab title="Linux" icon="linux">
    <Steps>
      <Step title="AppImage 方式">
        `bash chmod +x LinklyAI-*.AppImage ./LinklyAI-*.AppImage `
      </Step>

      <Step title="または DEB パッケージ方式">
        `bash sudo dpkg -i linkly-ai-*.deb `
      </Step>
    </Steps>
  </Tab>
</Tabs>

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

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

<Steps>
  <Step title="インデックス対象のディレクトリを選択">
    Linkly AI にインデックスさせたいドキュメントディレクトリを選択します：

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

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

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

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

      <Prompt description="Agent Skill linkly-ai-skills をインストールして...">
        Agent Skill linkly-ai-skills をインストールして、LinklyAI のツールインテグレーションを完了してください。参考：[https://linkly.ai/docs/ja/use-skills](https://linkly.ai/docs/ja/use-skills)
      </Prompt>
    </Card>

    手動で MCP ツールを統合することもできますが、より良い体験のために [Skills のインストール](use-skills) をお勧めします：

    <Tabs>
      <Tab title="Claude Code">
        ターミナルで以下を実行：

        ```bash theme={null}
        claude mcp add --transport http linkly-ai http://127.0.0.1:60606/mcp
        ```
      </Tab>

      <Tab title="Cursor">
        1. Settings → MCP Servers → Add Server を開く
        2. Name: `linkly-ai`
        3. Type: `StreamableHTTP`
        4. URL: `http://127.0.0.1:60606/mcp`
      </Tab>

      <Tab title="Codex">
        ターミナルで以下を実行：

        ```bash theme={null}
        codex mcp add linkly-ai --url http://127.0.0.1:60606/mcp
        ```
      </Tab>

      <Tab title="Cherry Studio">
        1. Settings → MCP Servers → Add を開く
        2. Name: `linkly-ai`
        3. Type: `StreamableHTTP`
        4. URL: `http://127.0.0.1:60606/mcp`
      </Tab>
    </Tabs>

    <Tip>`60606` は Linkly AI の MCP サービスのデフォルトポート番号です。接続できない場合は、アプリの設定で実際のポート番号をご確認ください。</Tip>
  </Step>
</Steps>

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

アプリ起動後、Linkly AI はすぐにドキュメントのインデックス作成を開始し、継続的に監視します。数分から数十分で全インデックスが完了します（ドキュメント数やマシンの性能によります）。

<Note>
  初回起動時に約 100MB のモデルファイルをダウンロードする必要があり、数分から数十分かかる場合がありますが、キーワード検索機能の利用には影響しません。

  ダウンロードが完了し、すべてのインデックスが作成された後、自然言語検索機能をご利用いただけます。
</Note>

LinklyAI を使う方法は 2 つあります：

<Card title="ランチャーでドキュメントを検索" icon="keyboard">
  トレイのアプリアイコン（L ロゴ）をクリックするか、グローバルショートカット `CMD/Ctrl + Shift + L` を使って検索ランチャーウィンドウを開き、キーワードや説明的な言葉を入力して目的のドキュメントを探せます。

  さらにプレビュー、メタ情報の確認、ドキュメントを開く、リンクのコピーなどが可能です。詳しくは[全文検索ランチャーのドキュメント](use-launcher)をご覧ください。
</Card>

<Card title="AI Agent と一緒に使う" icon="robot">
  こちらがより推奨される方法です。これまでにない対話体験とリサーチ効率を実現できます。

  AI アシスタントとの統合または [Skills](use-skills) のインストールが完了したら、任意の Prompt の後に `use linkly-ai` を付けることで、Linkly AI の強力な検索機能を積極的に活用できます。
</Card>