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

# WorkBuddy で Linkly AI を使う

> Linkly AI のローカルナレッジベースを WorkBuddy に統合して、AI ワークアシスタントがあなたのプライベートドキュメントを検索・閲覧できるようにします

## 何ができるか

<AccordionGroup>
  <Accordion title="タスク作成時にローカルドキュメントを参照">
    WorkBuddy でタスクを作成する際、AI に Linkly AI
    を通じて関連するローカル資料を先に検索させてから、レポート作成や企画立案などのタスクを完了させることで、出力内容が実際のデータに基づいたものになります。
  </Accordion>

  <Accordion title="Tencent エコシステムのコネクタと連携">
    ローカルナレッジベースを Tencent Docs や Tencent Lexiang
    などの組み込みコネクタと組み合わせることで、WorkBuddy
    がクラウド共同作業コンテンツとローカルのプライベートドキュメントを同時に検索できるようになります。
  </Accordion>

  <Accordion title="AI アシスタントの永続的な知識ソースとして">
    WorkBuddy の Assistant 機能を使えば、AI が会話中にいつでも Linkly AI
    を呼び出してメモ、参考資料、過去のドキュメントを検索できるため、毎回手動で添付ファイルをアップロードする必要がありません。
  </Accordion>
</AccordionGroup>

## 前提条件

* [WorkBuddy](https://www.codebuddy.cn/docs/workbuddy/Quickstart) がインストール済みであること
* Linkly AI Desktop が起動しており、MCP サービスが実行中であること

## 設定手順

<Tabs>
  <Tab title="ローカル MCP HTTP（推奨）" icon="globe">
    <Steps>
      <Step title="Connectors を開く">
        左ナビゲーションの **Experts·Skills·Connectors** をクリックし、上部の
        **Connectors** タブに切り替えてから、右上の **Custom connectors** をクリックします。

        <img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/workbuddy-connectors.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=3f23b5db3c1cd20338ddfbd045aff64d" alt="WorkBuddy Connectors 入口と Custom connectors ボタン" width="2472" height="1646" data-path="images/workbuddy-connectors.webp" />
      </Step>

      <Step title="MCP 設定エディタを開く">
        表示された **MCP Server Management** ダイアログで、右上の **Configure
        MCP** をクリックして JSON 設定エディタを開きます。

        <img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/workbuddy-mcp-configure.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=61471d03ca64fcb0be7cad0d08158e61" alt="Configure MCP をクリックして JSON エディタを開く" width="2472" height="1646" data-path="images/workbuddy-mcp-configure.webp" />
      </Step>

      <Step title="設定を入力して保存">
        エディタに以下の設定を入力し、**Save** をクリックします：

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "url": "http://127.0.0.1:60606/mcp"
            }
          }
        }
        ```

        <img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/workbuddy-mcp-http.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=961091fc3ac04d0bcbd0eb49d95ca5ee" alt="ローカル MCP HTTP 設定を入力" width="2472" height="1646" data-path="images/workbuddy-mcp-http.webp" />
      </Step>

      <Step title="サーバーを信頼する">
        保存後、MCP リストに戻り **linkly-ai** のエントリを見つけて **Trust**
        をクリックし、初回の認証を完了します。

        <img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/workbuddy-mcp-trust.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=1d08f7ee79deb61e794f453455dbe487" alt="Trust をクリックして MCP サーバーを認証" width="2472" height="1646" data-path="images/workbuddy-mcp-trust.webp" />
      </Step>
    </Steps>
  </Tab>

  <Tab title="リモート MCP" icon="cloud">
    先に[リモートアクセス設定](/ja/use-in-remote)を完了し、デスクトップトンネルが
    <Badge stroke color="green">● 接続済み</Badge> と表示されていることを確認してください。

    <Steps>
      <Step title="Connectors を開く">
        上記と同様に、**Connectors → Custom connectors → Configure MCP**
        に進みます。
      </Step>

      <Step title="リモート設定を入力して保存">
        エディタに以下の設定を入力し、**Save** をクリックします：

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "url": "https://mcp.linkly.ai/mcp"
            }
          }
        }
        ```

        保存後、MCP リストで **Trust** をクリックして認証を完了します。
      </Step>
    </Steps>
  </Tab>

  <Tab title="CLI Stdio（代替手段）" icon="terminal">
    先に [Linkly AI CLI をインストール](/ja/use-cli)してください。

    <Steps>
      <Step title="Connectors を開く">
        上記と同様に、**Connectors → Custom connectors → Configure MCP**
        に進みます。
      </Step>

      <Step title="CLI 設定を入力して保存">
        エディタに以下の設定を入力し、**Save** をクリックします：

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "command": "linkly",
              "args": ["mcp"]
            }
          }
        }
        ```

        保存後、MCP リストで **Trust** をクリックして認証を完了します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 使い始める

設定完了後、WorkBuddy で新しいタスクを作成する際にニーズを説明するだけで、AI
が自動的に Linkly AI を呼び出してローカルドキュメントを検索・閲覧します。

<img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/workbuddy-in-use.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=7c3b96949ab478332754757087ec57dc" alt="WorkBuddy が Linkly AI ツールを呼び出している" width="2472" height="1646" data-path="images/workbuddy-in-use.webp" />

例：

* 「ローカル資料を検索して、XX に関する分析レポートをまとめてください」
* 「ドキュメントにプロジェクト要件に関する内容はありますか？」

## よくある質問

<AccordionGroup>
  <Accordion title="MCP リストで linkly-ai が黄色の点で表示される">
    黄色は接続中を意味します。少し待つと通常は緑色に変わります。黄色のままの場合は、Linkly
    AI Desktop が起動しており MCP サービスが Running
    と表示されているか確認してください。
  </Accordion>

  <Accordion title="保存後に Trust ボタンが見当たらない">
    **Back to MCP List** をクリックしてリストに戻り、linkly-ai
    のエントリを展開すると Trust ボタンが表示されます。
  </Accordion>

  <Accordion title="MCP 設定ファイルはどこにありますか">
    WorkBuddy のユーザーレベル MCP 設定は `~/.workbuddy/mcp.json`
    に保存されています。Configure MCP エディタの上部にある Configuration File
    Path フィールドで完全なパスを確認できます。
  </Accordion>
</AccordionGroup>