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

# QwenPaw で Linkly AI を使う

> Linkly AI のローカルナレッジベースを QwenPaw エージェントに接続して、AI があなたのプライベートドキュメントを検索・閲覧できるようにします

## 何ができるか

<AccordionGroup>
  <Accordion title="タスク実行中にローカルドキュメントを随時検索">
    QwenPaw は MCP を通じてツール機能を拡張できます。Linkly AI
    を接続すると、エージェントがタスクを計画・実行する際にいつでもローカルドキュメントを検索し、ローカルの知識とオンライン情報を組み合わせて出力品質を向上できます。
  </Accordion>

  <Accordion title="プランモードでローカル資料を活用">
    QwenPaw のプランモードで、エージェントにまず Linkly AI
    で関連ドキュメントを検索させてから詳細な実行計画を立てさせることで、計画があなたの実際のプライベート資料に基づいたものになります。
  </Accordion>

  <Accordion title="複数エージェントで同じナレッジベースを共有">
    QwenPaw は複数の独立したエージェントの設定に対応しています。Linkly AI
    を接続すると、各エージェントが同じローカルドキュメントにアクセスできるため、エージェントごとに知識ソースを個別設定する必要がありません。
  </Accordion>
</AccordionGroup>

## 前提条件

* [QwenPaw](https://qwenpaw.agentscope.io/downloads) がインストール済みであること
* Linkly AI Desktop が起動しており、MCP サービスが実行中であること

## 設定手順

<Tabs>
  <Tab title="ローカル MCP HTTP（推奨）" icon="globe">
    <Steps>
      <Step title="MCP 設定を開く">
        QwenPaw コンソールを開き、**エージェント → MCP** に移動して **+ 作成**
        をクリックします。
      </Step>

      <Step title="設定を貼り付けて作成">
        ダイアログに以下の JSON を貼り付け、**作成** をクリックします：

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "transport": "streamable_http",
              "url": "http://127.0.0.1:60606/mcp"
            }
          }
        }
        ```
      </Step>
    </Steps>
  </Tab>

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

    <Steps>
      <Step title="MCP 設定を開く">
        QwenPaw コンソールを開き、**エージェント → MCP** に移動して **+ 作成**
        をクリックします。
      </Step>

      <Step title="リモート設定を貼り付けて作成">
        ダイアログに以下の JSON を貼り付け、**作成** をクリックします：

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "transport": "streamable_http",
              "url": "https://mcp.linkly.ai/mcp"
            }
          }
        }
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="CLI Stdio（代替手段）" icon="terminal">
    先に [Linkly AI CLI をインストール](/ja/use-cli)し、ローカルに Node.js 18+
    がインストールされていることを確認してください。

    <Steps>
      <Step title="MCP 設定を開く">
        QwenPaw コンソールを開き、**エージェント → MCP** に移動して **+ 作成**
        をクリックします。
      </Step>

      <Step title="CLI 設定を貼り付けて作成">
        ダイアログに以下の JSON を貼り付け、**作成** をクリックします：

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "command": "linkly",
              "args": ["mcp"]
            }
          }
        }
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 使い始める

設定完了後、QwenPaw の会話で直接質問するだけで、エージェントが自動的に Linkly AI
のツールを呼び出してローカルドキュメントを検索・閲覧します。

例：

* 「XX に関するドキュメントを検索してください」
* 「ローカルメモに YY の記録があるか確認して要約してください」

## よくある質問

<AccordionGroup>
  <Accordion title="作成後にツールが機能しない">
    **エージェント → MCP** ページで linkly-ai
    クライアントの有効化トグルがオンになっているか確認してください。また、Linkly
    AI Desktop が起動しており MCP サービスが Running
    と表示されているか確認してください。
  </Accordion>

  <Accordion title="CLI モードで command not found エラーが出る">
    Linkly AI CLI が正しくインストールされているか確認してください（`linkly     --version` で確認）。また Node.js バージョンが 18
    以上であることも確認してください（`node --version`）。
  </Accordion>

  <Accordion title="複数の MCP 設定を一度にインポートできますか">
    はい。QwenPaw は 1 つの JSON の `mcpServers` オブジェクト内に複数の MCP
    クライアントを設定でき、一度のクリックで一括インポートできます。
  </Accordion>
</AccordionGroup>