> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Bases

> Profound MCP で利用できる Knowledge Base ツールについて説明します

Profound MCP は、Knowledge Bases の一覧表示、内容の検索、新しいドキュメントの追加を行うためのツールを AI アシスタントに提供します。MCP クライアントをホスト型サーバーに接続するには、[接続ガイド](/ja-jp/mcp/common-mcp-clients)を参照してください。

<Tip>
  Knowledge Bases の詳細については、[Profound ヘルプセンター](https://help.tryprofound.com/articles/5775538586-knowledge-bases-overview)をご覧ください。
</Tip>

## ツールの連携のしくみ

<Steps>
  <Step title="Knowledge Base を探す">
    どの Knowledge Bases があるかを尋ねます。アシスタントは [`list_knowledge_bases`](#list-knowledge-bases) でそれらを一覧表示し、それぞれの名前と説明を示します。
  </Step>

  <Step title="Knowledge Base を検索する">
    Knowledge Base で回答できる質問をします。アシスタントは [`search_knowledge_base`](#search-knowledge-base) で内容を検索し、最も一致する文章を返します。
  </Step>

  <Step title="ドキュメントを追加する">
    新しいコンテンツを Knowledge Base に保存するよう依頼します。アシスタントはドキュメントの下書きを作成し、[`add_knowledge_base_document`](#add-knowledge-base-document) でプランをプレビューして、確認後に追加します。
  </Step>
</Steps>

## 動作と安全性

### 動作

| 動作 | 意味 |
| - | - |
| 適用前のプレビュー | `add_knowledge_base_document` はデフォルトでプレビューモードになっており、アシスタントが `preview: false` でプランを適用するまで何も追加されません |
| 追加のみの書き込み | MCP ではドキュメントの追加のみが可能です。修正や削除を行うには、Profound プラットフォームを使用してください |
| 重複する名前は拒否 | 既に存在する名前でドキュメントを追加すると失敗し、レスポンスではバージョン付きの名前で再試行するよう提案されます |
| 再試行でコピーが作成される | 追加が適用されるたびに新しいドキュメントが作成されるため、名前が重複として拒否されない限り、再試行すると別のコピーが作成されます |
| ライブデータ | ツールは Profound API から読み取るため、結果は現在のアクセス権とデータを反映します |

## Knowledge Base ツール

<Note>
  MCP から Knowledge Base を作成することはできません。追加するには、[Profound プラットフォームを使用してください](https://help.tryprofound.com/articles/5090178560-add-and-manage-knowledge-bases)。
</Note>

| ツール | 用途 |
| - | - |
| `list_knowledge_bases` | アクセスできる Knowledge Bases を一覧表示します |
| `search_knowledge_base` | 1 つの Knowledge Base 内のコンテンツを検索します |
| `add_knowledge_base_document` | Knowledge Base に新しい Markdown ドキュメントを 1 件追加します |

<AccordionGroup>
  <Accordion title="list_knowledge_bases" id="list-knowledge-bases">
    利用可能な Knowledge Bases を一覧表示します。

    **プロンプトの例**:

    * 「どんな Knowledge Bases がありますか?」
    * 「ブランドガイドライン用の Knowledge Base はありますか?」

    **入力**

    | 入力 | 必須 | デフォルト | 説明 |
    | - | - | - | - |
    | `organization_id` | 複数の組織にアクセスできる場合は必須 | `null` | Knowledge Bases を一覧表示する組織。アシスタントは [`list_organizations`](/ja-jp/mcp/capabilities/discovery-tools#list-organizations) で解決します |
  </Accordion>

  <Accordion title="search_knowledge_base" id="search-knowledge-base">
    1 つの Knowledge Base 内でセマンティック検索を実行します。各結果は `id`、`score`、`content`、および `folder_path`、`source_filename`、`filetype` を含む `metadata` を返します。

    **プロンプトの例**:

    * 「製品ローンチ時のトーンについて、ブランドガイドラインには何と書かれていますか?」
    * 「製品の Knowledge Base から料金に関する FAQ を探して。」

    **入力**

    | 入力 | 必須 | デフォルト | 説明 |
    | - | - | - | - |
    | `knowledge_base` | はい | - | 検索する Knowledge Base(ID、名前、またはスラッグで指定) |
    | `query` | はい | - | 検索する内容(平易な言葉で記述) |
    | `top_k` | いいえ | `10` | 返す結果の最大数 |
    | `organization_id` | 複数の組織にアクセスできる場合は必須 | `null` | Knowledge Base が属する組織。アシスタントは [`list_organizations`](/ja-jp/mcp/capabilities/discovery-tools#list-organizations) で解決します |
  </Accordion>

  <Accordion title="add_knowledge_base_document" id="add-knowledge-base-document">
    Knowledge Base に新しいドキュメントを Markdown テキストとして 1 件追加します。

    **プロンプトの例**:

    * 「このキャンペーンブリーフをマーケティングの Knowledge Base に保存して。」
    * 「新しいポジショニング資料を、ブランドガイドラインの Knowledge Base の messaging フォルダーに追加して。」

    **入力**

    | 入力 | 必須 | デフォルト | 説明 |
    | - | - | - | - |
    | `knowledge_base` | はい | - | 追加先の Knowledge Base(ID、名前、またはスラッグで指定) |
    | `name` | はい | - | ドキュメント名。`brand-guidelines` のように、小文字でハイフン区切りの説明的な名前にします |
    | `text` | はい | - | 先頭に YAML フロントマターを含む、Markdown 形式のドキュメント全文 |
    | `folder` | いいえ | `null` | ドキュメントを保存するフォルダー。省略すると、Knowledge Base のルートフォルダーに保存されます |
    | `preview` | いいえ | `true` | `true` の場合はドキュメントを追加せずにプランを返し、`false` の場合は追加します |
    | `create_missing_parents` | いいえ | `false` | 深くネストされたパスについてツールが確認を求めた後、複数階層のネストされたフォルダーを一度に作成することを承認する場合にのみ `true` に設定します |
    | `organization_id` | 複数の組織にアクセスできる場合は必須 | `null` | Knowledge Base が属する組織。アシスタントは [`list_organizations`](/ja-jp/mcp/capabilities/discovery-tools#list-organizations) で解決します |

    **注意事項**:

    * このツールはテキストのみを受け付けます。ソースが URL の場合、アシスタントはまずページを読み取り、その内容を Markdown として送信します。
    * サイト全体のスクレイピング、Notion との接続、Google Drive のリンクには、[Profound プラットフォーム](https://help.tryprofound.com/articles/5090178560-add-and-manage-knowledge-bases)を使用してください。
    * 新しいフォルダー: 既存のフォルダー内に新しいフォルダーを 1 つ作成して保存する場合は自動的に処理され、レスポンスで `folder_created` が報告されます。存在しない複数階層のフォルダーに一度に保存しようとすると最初は失敗し、ネストが意図したものであることを確認した後、アシスタントが `create_missing_parents: true` で再試行します。
    * Knowledge Base のドキュメントは名前で識別されるため、既に存在する名前で 2 つ目のドキュメントを追加すると失敗します。
    * 新しく追加したコンテンツが検索結果に表示されるまで少し時間がかかる場合があります。そのドキュメントを使ってさらに操作を行う前に、ドキュメントが追加されたことをアシスタントに確認することをおすすめします。
  </Accordion>
</AccordionGroup>

## リソース

Profound MCP は、Knowledge Bases のリファレンス資料を読み取り専用の MCP リソースとして提供します。

| リソース URI | 用途 |
| - | - |
| `file:///profound/knowledge-base-guide` | 作成のプレイブック: ドキュメントの目的、最低限の品質基準、命名規則、フォルダーの配置 |
| `file:///profound/knowledge-base-guide/templates` | Markdown と YAML のドキュメントテンプレート集 |
| `file:///profound/glossary/knowledge-base` | Knowledge Base の定義 |