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

# Raycast で Linkly AI を使う

> Linkly AI のローカルナレッジベースを Raycast AI に統合して、macOS 効率化ツールがあなたのプライベートドキュメントを検索・閲覧できるようにします

## 前提条件

* [Raycast](https://raycast.com) がインストール済みであること（AI 機能の使用には Raycast Pro サブスクリプションが必要）
* [Linkly AI CLI がインストール済み](/docs/ja/use-cli)であること（Raycast は Stdio トランスポートのみサポートしており、CLI 経由が必須）
* Linkly AI Desktop が起動しており、MCP サービスが実行中であること

## 設定手順

<Steps>
  <Step title="MCP 拡張機能を開く">
    Raycast で **Install Server** を検索するか、**Raycast Store** に移動して MCP
    拡張機能をインストールします（未インストールの場合）。
  </Step>

  <Step title="Linkly AI を追加">
    **Install Server** コマンドを実行し、以下を入力します： -
    **Name**：`linkly-ai` - **Type**：`stdio` - **Command**：`linkly` -
    **Arguments**：`mcp`
  </Step>

  <Step title="Raycast を再起動">
    保存後、Raycast を完全に終了して再起動し、設定を反映させます。
  </Step>
</Steps>

<Note>
  Raycast は現在 **Stdio トランスポートのみサポート**しており、HTTP URL
  方式はサポートされていません。そのため、先に Linkly AI CLI
  をインストールし、CLI
  がデスクトップアプリとの通信ブリッジとして機能する必要があります。
</Note>

## 使い始める

設定完了後、Raycast AI Chat で `@linkly-ai` を入力してツールを呼び出すか、直接質問するだけで Raycast が自動的に Linkly AI のツールを呼び出します。例えば：

* 「ドキュメントの中からプロダクトデザインに関する内容を検索して」
* "@linkly-ai read my project readme"

## よくある質問

<AccordionGroup>
  <Accordion title="linkly コマンドが見つからないと表示される">
    Raycast は独立した PATH 環境を使用しています。`linkly`
    コマンドが標準パス（`/usr/local/bin` や `/opt/homebrew/bin`
    など）にインストールされていることを確認してください。ターミナルで `which
            linkly` を実行してパスを確認し、そのパスが Raycast の PATH
    に含まれていることを確認してください。PATH を変更した後は Raycast
    を完全に再起動する必要があります。
  </Accordion>

  <Accordion title="ツールリストが空になっている">
    Linkly AI Desktop が起動しており MCP
    サービスが実行中であることを確認してください。Raycast は呼び出すたびに CLI
    に接続するため、デスクトップアプリが実行中である必要があります。
  </Accordion>
</AccordionGroup>