> ## 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.
# クラウドライブラリの使い方
> ローカルライブラリをクラウドにプッシュすれば、24 時間オンラインになり、パソコンから切り離してどの AI アシスタントからでも検索でき、他の人と共有することもできます。
## クラウドライブラリとは
[ライブラリ](/docs/ja/use-libraries)はデフォルトではあなたのパソコンの中にしか存在しません。アプリが起動していなかったり、パソコンがネットワークに繋がっていなければ検索できません。**クラウドライブラリ**は、あるローカルライブラリの内容を Linkly AI のサーバーにプッシュした複製です。24 時間オンラインで、あなたのパソコンに依存せず、MCP に対応した AI ツールならそのまま検索でき、他の人と共有することもできます。
パソコンの電源が落ちていても、アプリを起動していなくても、AI
アシスタントはコンテンツを検索できます
一般に公開したり、メールで特定の相手を招待して使ってもらえます
### 「リモートアクセス」との違い
この 2 つは名前が似ていますが、解決する問題の向きはむしろ逆で、混同しやすいところです：
| 機能 | 解決する問題 | パソコンへの依存 | 共有 | プラン |
| --------------------------------------- | ------------------------------------------------------ | ----------- | -- | ------ |
| [リモートアクセス](/docs/ja/use-in-remote)（MCP トンネル） | クラウドの AI アプリを**あなたのローカルマシンまで通して**ドキュメントを読ませる | 起動かつ接続済みが必須 | 不可 | Pro |
| **クラウドライブラリ** | 選んだコンテンツを**パソコンから切り離して**オンラインにし、より多くの Agent から使えるようにする | 依存しない | 可 | 無料で利用可 |
簡単な判断方法：ChatGPT にパソコン上の**すべての**ドキュメントを読ませたい → リモートアクセス。ある資料一式を**常時オンライン**にして、他の人にも使ってもらいたい → クラウドライブラリ。両方を同時に使うこともできます。
### 向いている場面
* **24 時間使える必要がある**：スマートフォンから、出張中、パソコンの電源が落ちているときでも自分の資料に質問したい
* **チームや顧客に資料を提供する**：製品ドキュメント、規約、事例集を 1 つのライブラリにまとめて共有する
* **ナレッジを一般公開する**：整理済みのテーマ別資料集を、誰でも自分の AI アシスタントから検索できるようにする
* **複数のデバイスで共用する**：一箇所からプッシュして各所から検索。パソコンごとに重複してインデックスを作る必要はありません
***
## 作成してプッシュする（ライブラリ所有者の視点）
クラウドライブラリは、まずウェブ上で「器」を作り、そのうえでデスクトップアプリからローカルの内容をプッシュします。
[linkly.ai](https://linkly.ai) にログインし、**Dashboard → マイライブラリ**に移動して「**新規**」をクリックします（直リンクは `https://linkly.ai/libraries/new`）。
初回作成時は先に**ユーザー名**の設定が必要です。クラウドライブラリのアドレスは `linkly.ai//` という形なので、アカウントに一意のユーザー名が必要になります。
入力する項目：
* **ライブラリタイトル**：表示用の名前。日本語でも構いません
* **Slug**：アドレスに入る部分。6〜60 文字、小文字の英字・数字・ハイフンのみ
* **説明（任意）**：このライブラリが誰向けで、何が入っているのかを一言で
* **カテゴリー**：見つけてもらいやすくするためのもので、いつでも変更できます
* **可視性**：下の[他の人と共有する](#他の人と共有する)をご覧ください
作成が完了すると「**Linkly Desktop でバインド**」ボタンが表示され、クリックするとデスクトップアプリが起動します。
起動しない場合は、ページの「**ライブラリ URL をコピー**」を使い、デスクトップアプリで手動で紐付けます：**設定 → ライブラリ**を開き、プッシュしたいローカルライブラリを選択して、「**クラウドライブラリ**」パネルの「**すでに作成済みですか？ライブラリの URL を貼り付け**」をクリックし、貼り付けてから「**紐付け**」を押します。
紐付けは**ローカルライブラリ ↔ クラウドライブラリ**の 1 対 1 の関係です。クラウドライブラリはローカルライブラリの複製であり、内容はローカルが正となります。
紐付けが済むと、「**クラウドライブラリ**」パネルにプッシュ待ちのドキュメント数が表示されます。「**クラウドへプッシュ**」をクリックするとアップロードが始まり、途中で一時停止・再開したり、処理の詳細を確認したりできます。中断したあとにもう一度クリックすると、続きから再開します。
プッシュが完了すると、カードに「**クラウドに同期済み**」とドキュメント数が表示されます。ローカルで追加や変更があるとカードの表示が「ローカルに更新あり」に変わるので、もう一度プッシュすれば反映されます。
「**クラウドライブラリ**」パネルで「**自動同期**」をオンにすると、アプリが 5
分ごとに変更を確認して自動的にプッシュするようになり、手動で押す必要がなくなります。
### 紐付けの解除
ライブラリの「**クラウドライブラリ**」パネルのメニューで「このクラウドライブラリの紐付けを解除」を選ぶと、ローカルからクラウドへのプッシュが止まります。**クラウド側にすでにあるコンテンツは保持され**、いつでも再度紐付けられます。
クラウド側の複製を完全に削除したい場合は、ウェブのライブラリ設定ページ →「**危険な操作**」→ ライブラリの削除、と進みます。削除すると、ファイル・招待・お気に入り・すべてのユーザーとのリンク関係がまとめて消去され、復元はできません。
***
## ライブラリをリンクする（利用者の視点）
AI アシスタントがあるクラウドライブラリを検索できるようにするには、まずそれを自分のアカウントに**リンク**します。そのライブラリのウェブアドレスを開き、右上の「**リンク**」ボタン（英語表示では **Link**）をクリックしてください。ボタンが「**リンク済み**」に変われば成功です。
\*\*自分で作成したライブラリでも、必ず一度「リンク」をクリックする必要があります。\*\*MCP
の検索対象は「所有権」ではなく「リンク関係」で決まります —
リンクしていないライブラリは、たとえ自分のものでも AI
アシスタントからは見えません。
リンクは**あなたのアカウント**と**そのライブラリ**の関係であり、ライブラリの所有者とは無関係です：
* 所有者は、自分のライブラリを誰がリンクしているかを確認できます（ライブラリ設定 → **ユーザー**）
* あなたはいつでももう一度クリックしてリンクを解除できます。ライブラリ自体には影響しません
* 1 つのリンクにつき\*\*リンク枠（Slot）\*\*を 1 つ消費します。無料アカウントは 1 枠、Pro は 99 枠です
***
## AI アシスタントで使う
クラウドライブラリは、Linkly AI のクラウド MCP ゲートウェイを通じて検索機能を提供します。エンドポイントは固定です：
```
https://mcp.linkly.ai/mcp
```
AI クライアントに追加するときは、**サーバー名に `linkly-ai-cloud` を使ってください**。この名前は、ローカルのデスクトップアプリの `linkly-ai` と区別するためのものです。両方を同時に設定でき、互いに影響しません。同じ名前を使うと互いに上書きしてしまいます。
### 3 つの接続方法
| 使っているツール | 接続方法 |
| -------------------------------------- | ----------------------------------------------- |
| Claude Code、Codex、Cursor、Gemini CLI など | HTTP MCP + API キー（リクエストヘッダーに `Bearer` を付与） |
| ChatGPT、Claude.ai などのオンラインアプリ | URL を入力して OAuth 認可。API キーは不要 |
| Linkly AI CLI | `linkly auth set-key` のあとに `--remote` パラメータを付ける |
Claude Code を例にすると：
```bash theme={null}
claude mcp add --transport http linkly-ai-cloud https://mcp.linkly.ai/mcp \
--header "Authorization: Bearer lkai_あなたのキー"
```
API キーは[ダッシュボード](https://linkly.ai/dashboard/integrations)の「**APIキー**」エリアで作成でき、`lkai_` で始まります。クライアントごとの具体的な設定形式は[各 AI クライアント統合ガイド](/docs/ja/integration)をご覧ください。
手動での設定が面倒ですか？任意のクラウドライブラリのページで「**AI
で使う**」をクリックし、ダイアログに表示される一文をコピーして AI
アシスタントに送ってください。[接続ガイド](/docs/ja/library-setup)を読んで、最後まで案内してくれます。
### ライブラリの指定方法
クラウドライブラリの識別子は `cloud:///` という形で、ウェブアドレスのあの 2 つのセグメントそのものです：
```
ウェブアドレス https://linkly.ai/blueeon/linkly-init-example
ライブラリ識別子 cloud://blueeon/linkly-init-example
```
`list_libraries` を使うと、リンク済みのすべてのライブラリと、その正確な識別子を一覧できます。
**検索のたびにライブラリを明示的に指定してください。**ライブラリのパラメータを省略すると、リクエストはデフォルトであなたのローカルマシンにルーティングされます（リモートトンネル経由）。トンネルは
Pro
機能なので、無料アカウントはその時点でエラーになります。クラウドライブラリが暗黙的に含まれることは**決してありません**。調べたいライブラリは毎回指定してください。2
つのライブラリを調べるなら 2 回呼び出します。
AI アシスタントに対しては、こうした構文を覚える必要はありません。ライブラリ名をはっきり伝えるだけで十分です：
「blueeon/linkly-init-example というクラウドライブラリで RAG
関連の資料を探して」
「リンクしているライブラリの一覧を見せて」
***
## デスクトップアプリで使う
Linkly AI デスクトップアプリをインストールしていれば、MCP を何も設定しなくてもクラウドライブラリを使えます：
* **設定 → ライブラリ**を開くと、「**接続済みクラウドライブラリ**」エリアにリンク済みのライブラリがすべて表示され、ライブラリごとに Chat で使えるかどうかを切り替えられます
* アプリ内の Chat で `@` を使ってクラウドライブラリに言及すれば、ローカルライブラリと同じように検索できます
このエリアは読み取り専用です。リンクと解除はどちらもウェブ上で操作します。一覧が空の場合は、まずウェブでライブラリをリンクしてください。
***
## 他の人と共有する
クラウドライブラリには 3 つの可視性があり、ライブラリ設定ページでいつでも切り替えられます：
| 可視性 | 詳細とファイル一覧を見られる人 | リンクして検索できる人 | 探索ページや検索エンジンに掲載されるか |
| ------------ | --------------- | ------------ | ------------------- |
| **Public** | 全員 | ログイン済みの全ユーザー | される |
| **Showcase** | 全員 | 招待されたメンバーのみ | される |
| **Private** | 所有者と招待された人のみ | 所有者と招待された人のみ | されない |
**他の人を招待する**：ライブラリ設定ページ → **共有管理**で、相手のメールアドレスを入力して招待を送ります。相手が承諾すると閲覧者になり、自分のアカウントでこのライブラリをリンクして検索できるようになります。
可視性を**狭める**方向に切り替える場合（例：Public →
Private）、閲覧者以外のリンクとお気に入りの関係が即座に削除され、取り消しはできません。\*\*招待を承諾済みの閲覧者は常に保持されます。\*\*操作の前に、削除される件数がページ上にはっきり表示されます。
***
## 上限とプラン
| | 無料 | Pro |
| ----------------------- | ---------- | --------------------------- |
| 作成できるクラウドライブラリ | 1 個 | 30 個 |
| 1 ライブラリあたりのドキュメント上限 | 500 件 | 2000 件 |
| リンクできるライブラリ | 1 個 | 99 個 |
| 選択できる可視性 | Private のみ | Public / Showcase / Private |
| クラウド検索 | 利用可 | 利用可 |
| リモートトンネル（ローカルマシンへのアクセス） | 利用不可 | 利用可 |
**無料アカウントが作成できるライブラリは Private のみ**です。つまり自分と、招待した人だけが使えます。一般に公開したり、ショーケース型のライブラリにしたい場合は [Pro](https://linkly.ai/pricing) へのアップグレードが必要です。
上限を超えても既存のコンテンツには影響しません。すでに作成したライブラリやプッシュ済みのドキュメントはそのままで、新しく作れなくなるだけです。
***
## よくある質問
アップロードされるのは、あなたが自分でプッシュしたライブラリだけです。ドキュメント本文・ベクトル・メタデータは暗号化して転送・保存され、可視性はあなた自身が管理します。デフォルトは Private です。クラウドに置いておきたくなくなったら、クラウドライブラリを削除すれば内容もまとめて消去されます。
リアルタイム同期はされません。デフォルトでは手動で「**クラウドへプッシュ**」を押す必要があります。「**自動同期**」をオンにすると、アプリが
5
分ごとに変更を確認して自動的にプッシュします。クラウドはローカルの複製であり、方向は一方向です。クラウド側で内容を編集することはできません。
最も多い原因は「**リンク**」をクリックしていないことです。検索対象は所有権ではなくリンク関係で決まるため、自分のライブラリでもライブラリページで一度「リンク」をクリックする必要があります。
接続しているのが**ローカル** MCP（`127.0.0.1:60606`、サーバー名
`linkly-ai`）である可能性が高いです。この経路ではクラウドライブラリに到達できません。クラウドゲートウェイの接続を別途追加してください：URL
は `https://mcp.linkly.ai/mcp`、サーバー名は `linkly-ai-cloud`
です。両方を共存させられます。
消えません。紐付けの解除はプッシュを止めるだけで、クラウドのコンテンツは残り、いつでも再度紐付けられます。クラウド側の複製を削除するには、ウェブのライブラリ設定ページ
→「**危険な操作**」から明示的に削除する必要があります。
消費しません。作成数とリンク数は別々の上限です。他の人のライブラリはあなたの**リンク枠**を使うだけで、作成できるライブラリ数には数えられません。
***
## 関連ドキュメント
* [Agent 向けクラウドライブラリ接続ガイド](/docs/ja/library-setup) — 接続作業を AI アシスタントに任せて自動で終わらせる
* [ライブラリの使い方](/docs/ja/use-libraries) — ローカルライブラリの作成とライブラリ単位の検索
* [リモートアクセス](/docs/ja/use-in-remote) — クラウドの AI からローカルのドキュメントへ通してアクセスさせる
* [ツール紹介](/docs/ja/tools-intro) — 検索ツールの全パラメータの説明