> ## 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. # Profound Docs > Profound MCP を通じて利用できる Profound Docs ツールについて理解します Profound MCP は、Profound Docs のドキュメントを検索、閲覧、作成、管理するためのツールを AI アシスタントに提供します。Profound Docs は、メモやブリーフなど、Profound プラットフォーム内の共同編集ドキュメントです。MCP クライアントをホスト型サーバーに接続するには、[接続ガイド](/ja-jp/mcp/common-mcp-clients)を参照してください。 Profound Docs のドキュメントは Knowledge Base のドキュメントではありません。AI アシスタントや Agents が検索・取得するコンテンツを追加するには、代わりに `add_knowledge_base_document` ツールを使用してください。[Knowledge Base](/ja-jp/mcp/capabilities/knowledge-base-capabilities) を参照してください。 ## ツールの連携方法 ドキュメントが存在するかどうか、または最近変更されたドキュメントはどれかを尋ねます。アシスタントは `list_docs` でドキュメント名を検索し、各結果へのリンクを提示します。 要約または全文を依頼します。アシスタントは `get_doc` でドキュメントを読み込みます。デフォルトでは冒頭部分のみを確認し、タスクに必要な場合は本文全体を読み込みます。 新しいドキュメントを依頼すると、アシスタントが下書きを作成し、`create_doc` で保存します。既存のドキュメントの変更を依頼すると、`replace_doc_content` でドキュメントを書き換えます。 ドキュメントの名前変更や閲覧できるユーザーの変更(`update_doc`)、またはアシスタントが以前に作成したドキュメントの削除(`delete_doc`)を依頼します。 ## 動作と安全性 書き込みツールはデフォルトでプレビューモードになっています。アシスタントはまず変更の計画を受け取り、その計画を適用するまでは何も変更されません。例外は `delete_doc` で、プレビューがなく、最初の呼び出しで削除が実行されます。 ### 動作 | 動作 | 意味 | | - | - | | 適用前のプレビュー | `create_doc`、`replace_doc_content`、`update_doc` は最初に計画を返し、変更が適用された場合にのみ `applied: true` を報告します | | ドキュメント全体の書き込み | `replace_doc_content` は、本文全体の書き換えか部分的な書き換えかにかかわらず、呼び出しのたびに本文全体を上書きし、コメントとタブを消去します | | 最後の書き込みが優先 | 置換ツールはバージョンを確認しません。2 人の書き込み者が同じドキュメントを置換した場合、後の書き込みが前の書き込みを上書きし、ロールバックはできません | | 名前変更と共有範囲変更の制限 | `update_doc` は、MCP を通じて作成されたドキュメント、または Profound プラットフォームで自分自身が作成したドキュメントにのみ使用できます。ドキュメントの公開範囲を変更できるのは作成者のみです | | 削除の制限 | `delete_doc` は、MCP を通じて作成されたドキュメントにのみ使用できます。Profound プラットフォームで作成したドキュメントの削除を依頼すると、`deleted: false` が返されます | | ライブデータ | ツールは Profound API から読み込むため、結果には現在のアクセス権とデータが反映されます | ### MCP ヒント 書き込みツールには、次の MCP ヒントが設定されています。 | ツール | ヒント | 意味 | | - | - | - | | `create_doc` | `destructiveHint: false`、`idempotentHint: true` | 同じ `name` で 2 回作成すると、2 つ目のコピーではなく既存のドキュメントが返されます。作成によって既存のドキュメントが上書きされることはありません | | `replace_doc_content` | `destructiveHint: true`、`idempotentHint: true` | 呼び出しにより本文全体が上書きされ、コメントとタブが消去されます | | `update_doc` | `destructiveHint: true`、`idempotentHint: true` | 名前を変更すると、タイトルが最初の見出しに追従しなくなり、これは元に戻せません。また、`visibility: organization` を再送信すると、既存の編集アクセス権が閲覧のみに格下げされます | | `delete_doc` | `destructiveHint: true`、`idempotentHint: true` | 削除されたドキュメントはどの API からも復元できず、繰り返し呼び出すと `deleted: false` が報告されます | すべての書き込みツールには `openWorldHint: true` も設定されています。これは書き込みがライブの共有環境に反映されることを MCP クライアントに伝えるもので、クライアントは実行前に確認を求める場合があります。 ## Profound Docs ツール | ツール | 用途 | | - | - | | `list_docs` | 名前でドキュメントを検索し、その詳細を読み込みます | | `get_doc` | 1 つのドキュメントをプレビューまたは全文で読み込みます | | `create_doc` | 下書きしたコンテンツから新しいドキュメントを作成します | | `replace_doc_content` | ドキュメントの本文全体を置換し、コメントとタブを消去します | | `update_doc` | ドキュメントの名前変更、閲覧できるユーザーの変更、またはその両方を行います | | `delete_doc` | このインテグレーションで作成したドキュメントを削除します | ドキュメントと、その名前、オーナー、公開範囲、リンク(`url`)などの詳細を検索します。結果は最終更新日時の新しい順に並べられ、ドキュメントの本文は含まれません。 **プロンプトの例**: * 「AEO 戦略に関するドキュメントはすでにありますか?」 * 「最近変更された Profound ドキュメントはどれですか?」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `q` | いいえ | `null` | ドキュメント名に対するあいまい一致。ドキュメントの本文は検索しません | | `sort` | いいえ | `null` | 指定できる値は `recency` のみで、デフォルトの並び順と同じです。その他の値を指定するとエラーが返されます | | `organization_id` | いいえ | `null` | ドキュメントを一覧表示する組織。デフォルトはセッションの組織です(解決されている場合)。アカウントが複数の組織にアクセスできる場合は必須です | | `limit` | いいえ | `20` | 結果の 1 ページあたりに返されるドキュメント数(1〜50)。範囲外の値を指定するとエラーが返されます | | `cursor` | いいえ | `null` | 前回の呼び出しで返された `next_cursor`。次のページを取得するために使用します。発行から 1 時間で失効します | **制限事項**: * このツールは、ドキュメントの作成者やオーナーで絞り込むことはできません。特定のユーザーのドキュメントを探す場合、アシスタントはすべてのドキュメントを一覧表示して各行のオーナーを確認するため、時間がかかることがあります。 * このツールは、ドキュメントの総数を返しません。 1 つのドキュメントを読み込みます。デフォルトのプレビューでは、本文の冒頭部分のみが返されます。タスクで全文やドキュメント上のディスカッションが必要な場合、アシスタントは本文全体またはコメントを読み込みます。 **プロンプトの例**: * 「AEO 戦略メモを要約してください。」 * 「Q3 の振り返りを、寄せられたコメントも含めて全文読んでください。」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `doc_id` | はい | - | ドキュメントの ID。`list_docs` またはドキュメントの URL から取得します | | `organization_id` | はい | - | ドキュメントを所有する組織 | | `preview` | いいえ | `true` | `true` の場合は本文の冒頭部分を返し、`false` の場合は本文全体を返します | | `include_comments` | いいえ | `false` | `true` の場合はコメントも返します。各コメントには、コメントのテキストとコメントが付けられた箇所が含まれます | アシスタントが下書きしたコンテンツから新しいドキュメントを作成します。このツールは 1 回の呼び出しで本文全体を受け取ります。 **プロンプトの例**: * 「今四半期の可視性データに基づいて Q3 の AEO 振り返りを作成し、Profound ドキュメントとして保存してください。」 * 「競合ブリーフの下書きを作成し、後で共有できるように Profound に保存してください。」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `name` | はい | - | ドキュメントのタイトル(最大 256 バイト)。組織内でのドキュメントの識別子にもなります | | `content_markdown` | はい | - | Markdown 形式の本文全体(最大 1,000,000 バイト) | | `organization_id` | いいえ | `null` | ドキュメントを作成する組織。デフォルトはセッションの組織です | | `preview` | いいえ | `true` | `true` の場合はドキュメントを作成せずに計画を返し、`false` の場合は作成します | **注意事項**: * ドキュメントのタイトルは組織内で一意です。既存のタイトルでドキュメントを作成すると、既存のドキュメントが返され、新しい本文は破棄されます。 * 新しいドキュメントは作成者のみが閲覧できます。 * ドキュメントの作成から本文の保存までの間に呼び出しが失敗した場合、ドキュメントは空の状態で存在し、レスポンスで `content_written: false` が報告されます。再試行すると、本文が書き込まれるのではなく、同じ空のドキュメントが返されます。 注意して使用してください。このツールはドキュメントの本文全体を置換し、メインタブ以外のすべてのタブとすべてのコメントを消去します。 ドキュメントのコンテンツを新しいテキストに置換します。チェックボックスへのチェックからセクションの書き換えまで、既存のドキュメントへのあらゆる変更はこのツールを通じて行われます。 **プロンプトの例**: * 「AEO 戦略メモにショッピングプロンプトに関するセクションを追加してください。」 * 「Q3 の振り返りの誤字を修正してください。」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `doc_id` | はい | - | 置換するドキュメント。`list_docs` またはその URL から取得します | | `content` | はい | - | Markdown 形式の新しい本文全体。空の値を指定するとドキュメントが消去されます | | `organization_id` | いいえ | `null` | デフォルトはセッションの組織です | | `skip_title_sync` | いいえ | `false` | `true` の場合は現在のタイトルを維持します。デフォルトでは、タイトルは新しいコンテンツの最初の見出しに追従します | | `preview` | いいえ | `true` | `true` の場合は上書きによる変更内容を報告し、`false` の場合は書き込みます | **注意事項**: * ドキュメントのコンテンツが置換されると、`skip_title_sync` が `true` でない限り、タイトルは新しいコンテンツの最初の見出しに合わせて更新されます。 ドキュメントの名前変更、閲覧できるユーザーの変更、またはその両方を 1 回の呼び出しで行います。 **プロンプトの例**: * 「戦略メモの名前を 'AEO strategy H2' に変更してください。」 * 「Q3 の振り返りを組織全体に公開してください。」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `doc_id` | はい | - | 名前変更または共有範囲を変更するドキュメント | | `name` | いいえ | `null` | 新しいタイトル(最大 256 バイト)。タイトルを変更しない場合は省略します | | `visibility` | いいえ | `null` | `invited_only` または `organization`(閲覧のみ)。共有設定を変更しない場合は省略します | | `organization_id` | いいえ | `null` | デフォルトはセッションの組織です | | `preview` | いいえ | `true` | `true` の場合は何も変更せずに計画を返し、`false` の場合は適用します | **注意事項**: * `name` と `visibility` のうち少なくとも 1 つが必要です。どちらも指定しない呼び出しはエラーを返します。 * ドキュメントの名前を変更しても、ドキュメントの最初の見出しは変更されず、以降タイトルは見出しに追従しなくなります。たとえば、"AEO strategy" を "AEO strategy H2" に名前変更しても、ドキュメントの最初の見出しは "AEO strategy" のままです。 * `update_doc` で組織内の全員に付与できるアクセスレベルは閲覧のみです。組織内の全員がすでに編集アクセス権を持っている場合、MCP を通じて `visibility` を `organization` に設定すると、そのアクセス権は閲覧のみに格下げされます。 * このツールは、MCP を通じて作成されたドキュメント、または Profound プラットフォームで自分自身が作成したドキュメントにのみ使用できます。自分と共有されたドキュメントは、編集アクセス権があっても名前変更や共有範囲の変更はできず、公開範囲を変更できるのは作成者のみです。 アシスタントが以前に MCP 接続を通じて作成したドキュメント(誤っていた下書きや重複など)を削除します。プレビューモードがない唯一の書き込みツールです。 **プロンプトの例**: * 「先ほど作成した下書きを削除してください。最終版を残します。」 * 「そのブリーフは重複していたので削除してください。」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `doc_id` | はい | - | 削除するドキュメント。`list_docs` またはその URL から取得します | | `organization_id` | いいえ | `null` | デフォルトはセッションの組織です | **注意事項**: * 削除できるのは MCP を通じて作成されたドキュメントのみで、削除できるのはその作成者のみです。 * 削除は確定的で、元に戻すことはできません。 ## リソース | リソース URI | 説明 | | - | - | | `file:///profound/docs-guide` | 作成ガイド。ドキュメントと Knowledge Base ドキュメントの違い、作成すべき場合と置換すべき場合、ドキュメント全体を安全に上書きする方法、新しいドキュメントを閲覧できるユーザーについて説明します | | `file:///profound/glossary/doc` | Profound Doc の定義 |