> ## 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.
# Projects
> Profound MCP を通じて利用できる Projects ツールについて理解します
Profound MCP は、Projects とそのタスクを閲覧、生成、管理するためのツールを AI アシスタントに提供します。MCP クライアントをホスト型サーバーに接続するには、[接続ガイド](/ja-jp/mcp/common-mcp-clients)を参照してください。
Profound MCP は、旧バージョンの Projects に対応しています。Profound プラットフォームで作成した Projects は、まだ MCP からは利用できません。Projects の詳細については、[Profound Help Center](https://help.tryprofound.com/articles/8581387448-about-projects) を参照してください。
## ツールの連携方法
Projects はカテゴリー単位で管理されるため、Projects を操作する前に、アシスタントは [`list_categories`](/ja-jp/mcp/capabilities/discovery-tools#list-categories) でカテゴリーを特定します。
カテゴリー内にどのような作業があるかを尋ねます。アシスタントは [`list_projects`](#list-projects) でその Projects を一覧表示し、依頼に応じて進行中またはアーカイブ済みの作業に絞り込みます。
1 つの Project について尋ねます。アシスタントは [`get_project`](#get-project) で、目標、特定されたアイデンティティ、タスクの一覧全体を読み込みます。
新しい Project を依頼します。アシスタントは [`new_project`](#new-project) で生成計画をプレビューし、確認後に生成を開始して、[`get_project_status`](#get-project-status) で進捗を確認します。生成には約 10 分かかります。
タスクの追加、編集、進行を依頼します。アシスタントは [`create_project_task`](#create-project-task)、[`update_project_task`](#update-project-task)、[`set_project_task_status`](#set-project-task-status) を使用します。Project が完了した場合や不要になった場合は、アーカイブを依頼します。[`archive_project`](#archive-project) は Project を削除せずに保管します。
## 動作と安全性
### 動作
`delete_project_task` を除くすべての書き込みツールは、デフォルトでプレビューモードになっています。アシスタントはまず変更の計画を受け取ってユーザーに提示し、ユーザーが確認した後にのみ変更を適用します。
| 動作 | 意味 |
| - | - |
| 適用前のプレビュー | 書き込みツールは変更の計画を返し、アシスタントが適用するまで何も変更しません |
| 削除ではなくアーカイブ | `archive_project` は Project を `retired` としてマークし、その履歴を保持します |
| ブリーフの全置換 | `update_project_task` に渡された `brief` は、既存のブリーフにマージされるのではなく、既存のブリーフを置き換えます |
| 破壊的な削除 | `delete_project_task` はタスクを完全に削除します。プレビューはなく、元に戻すこともできません |
| わかりやすいテキストでの書き込み | テキストを受け取るツールは生の指標値を拒否するため、アシスタントはそれを人が読みやすい値に置き換えます。たとえば、Visibility Score の場合は `0.33` ではなく `33%` とします。保存されるタスクの文言は、入力したテキストと異なる場合があります |
| ライブデータ | ツールは Profound API から読み込むため、結果には現在のアクセス権とデータが反映されます |
### MCP ヒント
読み取りツール(`list_projects`、`get_project`、`get_project_status`)には `readOnlyHint: true` と `idempotentHint: true` が設定されています。これらはデータを読み取るだけなので、安全に再試行できます。書き込みツールには、次の MCP ヒントが設定されています。
| ツール | ヒント | 意味 |
| - | - | - |
| `new_project` | `destructiveHint: false`、`idempotentHint: false` | 2 回適用すると 2 回の生成が開始され、2 つの Projects が作成されます |
| `archive_project` | `destructiveHint: false`、`idempotentHint: true` | すでに retired の Project をアーカイブしても何も変わりません |
| `create_project_task` | `destructiveHint: false`、`idempotentHint: false` | 2 回適用するとタスクが 2 回追加されます |
| `update_project_task` | `destructiveHint: false`、`idempotentHint: true` | 同じ変更を再度適用しても、タスクはそのままです |
| `set_project_task_status` | `destructiveHint: false`、`idempotentHint: true` | 同じステータスを再度設定しても何も変わりません |
| `delete_project_task` | `destructiveHint: true`、`idempotentHint: true` | 削除は完全に行われ、繰り返し呼び出しても削除するものは残っていません |
すべての書き込みツールには `openWorldHint: true` も設定されています。これは書き込みがライブの共有環境に反映されることを MCP クライアントに伝えるもので、クライアントは実行前に確認を求める場合があります。
## Projects ツール
| ツール | 用途 |
| - | - |
| `list_projects` | カテゴリーの Projects を一覧表示します |
| `get_project` | 1 つの Project を、その目標とタスクの一覧全体とともに読み込みます |
| `get_project_status` | Project のライフサイクルとリアルタイムの生成ステータスを確認します |
| `new_project` | カテゴリー内に新しい Project を生成します |
| `archive_project` | Project を削除せずに retired にします |
| `create_project_task` | Project にタスクを追加します |
| `update_project_task` | 既存のタスクのフィールドを更新します |
| `set_project_task_status` | タスクのステータスを変更します |
| `delete_project_task` | タスクを完全に削除します |
カテゴリーの Projects と、そのタイトル、タスク数、最終更新日などの詳細を一覧表示します。
**プロンプトの例**:
* 「Banking カテゴリーにはどのようなプロジェクトがありますか?」
* 「現在トラッキング中のプロジェクトを表示してください。」
**入力**
| 入力 | 必須 | デフォルト | 説明 |
| - | - | - | - |
| `category_id` | はい | - | Profound のカテゴリー。`list_categories` から取得します |
| `status` | いいえ | `null` | `suggested`、`tracked`、`retired` で絞り込みます。空欄の場合はすべての Projects が返されます |
| `limit` | いいえ | `20` | 返される Projects の最大数 |
| `offset` | いいえ | `0` | ページネーションのオフセット |
**注意事項**
* このツールは、Projects の総数を返しません。
1 つの Project を、タイトル、目標、説明、タスクを含めて読み込みます。
**プロンプトの例**:
* 「'Rank top three on savings accounts' プロジェクトについて説明してください。」
* 「そのプロジェクトでまだ未完了のタスクはどれですか?」
**入力**
| 入力 | 必須 | デフォルト | 説明 |
| - | - | - | - |
| `project_id` | はい | - | Project の ID。`list_projects` から取得します |
| `category_id` | はい | - | Project のカテゴリー |
リアルタイムの指標を Project の目標と比較するよう、アシスタントに依頼してみましょう。`get_project` が返すデータは、[アナリティクスツール](/ja-jp/mcp/capabilities/analytics-capabilities)と組み合わせて使うと効果的です。
Project のライフサイクルステータスを取得します。
* `suggested`: 提案された作業
* `tracked`: 目標に対して測定されている進行中の作業
* `retired`: アーカイブ済みの作業
最近生成された、または現在生成中の Projects については、このツールは `live_generation` の状態(`queued`、`running`、`completed`、`failed`)も返します。
**プロンプトの例**:
* 「生成を開始したプロジェクトはもう準備できていますか?」
* 「そのプロジェクトの生成は完了しましたか、それとも失敗しましたか?」
**入力**
| 入力 | 必須 | デフォルト | 説明 |
| - | - | - | - |
| `project_id` | はい | - | Project の ID。`list_projects` または `new_project` から取得します。生成の `run_id` ではありません |
| `category_id` | はい | - | Project のカテゴリー |
Project の生成を開始します。プレビューでは生成計画が表示され、確認すると Profound がバックグラウンドで Project を構築し、そのリンクを返します。構築には約 10 分かかり、アシスタントは `get_project_status` で完了したかどうかを確認できます。
**プロンプトの例**:
* 「普通預金口座に関するプロンプトでの可視性を向上させるプロジェクトを作成してください。」
* 「当座預金のトピックについて、米国市場に焦点を当てたアーンドメディアのプロジェクトを生成してください。」
**入力**
| 入力 | 必須 | デフォルト | 説明 |
| - | - | - | - |
| `category_id` | はい | - | 生成先のカテゴリー。`list_categories` から取得します |
| `focus` | はい | - | 生成する Project を表す具体的な 1 文。`context` と合わせて 2,000 文字の制限があります |
| `topics` | いいえ | `null` | Project が焦点を当てるトピック名 |
| `project_name` | いいえ | `null` | Project のタイトル。空欄の場合は Profound が名前を生成します |
| `work_types` | いいえ | `null` | 作成する作業の種類: `publish`、`refresh`、`earned`、`creative`、`social` |
| `date_range` | いいえ | `null` | 生成される作業が対象とする期間 |
| `platforms` | いいえ | `null` | 優先するプラットフォームまたはチャネル |
| `regions` | いいえ | `null` | 優先する市場または地域 |
| `tags` | いいえ | `null` | 生成内容の指針となるカテゴリータグ |
| `context` | いいえ | `null` | 生成内容の指針となる追加情報(目的、オーディエンス、競合、根拠、期待するアウトプット、制約)。`focus` と合わせて 2,000 文字の制限があります |
| `preview` | いいえ | `true` | `true` の場合は何も作成せずに計画を表示し、`false` の場合は生成を開始します |
Project をアーカイブし、削除せずに保管します。Project とその履歴は保持され、`retired` としてマークされるため、この変更は元に戻せます。
**プロンプトの例**:
* 「ホリデーキャンペーンのプロジェクトは完了したのでアーカイブしてください。」
* 「もう取り組んでいないプロジェクトを retired にしてください。」
**入力**
| 入力 | 必須 | デフォルト | 説明 |
| - | - | - | - |
| `project_id` | はい | - | Project の ID |
| `category_id` | はい | - | Project のカテゴリー |
| `reason` | いいえ | `null` | アーカイブする簡単な理由(例: 不要になった、完了済み、別のものに置き換えられた) |
| `preview` | いいえ | `true` | `true` の場合は Project を変更せずに計画を返し、`false` の場合は適用します |
Project にタスクを追加します。
**プロンプトの例**:
* 「savings プロジェクトに、料金ページを更新するタスクを追加してください。」
* 「'Rank top three on savings accounts' プロジェクトに、LinkedIn で新しい金利の発表を宣伝するタスクを追加してください。インパクトは高に設定してください。」
**入力**
| 入力 | 必須 | デフォルト | 説明 |
| - | - | - | - |
| `project_id` | はい | - | タスクを追加する Project |
| `category_id` | はい | - | Project のカテゴリー |
| `title` | はい | - | タスクのタイトル(5〜12 語) |
| `summary` | いいえ | `null` | タスクの概要 |
| `brief` | いいえ | `null` | タスクの作業指示。構造化されたブリーフオブジェクトとして送信します |
| `type` | いいえ | `null` | タスクの種類: `publish`、`refresh`、`earned`、`competitor_copy`、`creative`、`social` |
| `topic` | いいえ | `null` | このタスクが対象とするトピック |
| `impact` | いいえ | `null` | インパクトスコア(1〜5、5 が最高) |
| `reference_url` | いいえ | `null` | 作業対象のページや参照元など、補足となるリンク |
| `reference_label` | いいえ | `null` | 参照リンクの表示名 |
| `position` | いいえ | `null` | Project のタスク一覧におけるタスクの位置 |
| `preview` | いいえ | `true` | `true` の場合はタスクを作成せずに計画内容を表示し、`false` の場合は作成します |
既存のタスクのフィールドを更新します。
**プロンプトの例**:
* 「料金ページのタスクを更新してください。新しい金利ページが公開されたので、参照としてリンクしてください。」
* 「LinkedIn タスクの概要を、新しい普通預金金利に焦点を当てた内容に書き換えてください。」
**入力**
| 入力 | 必須 | デフォルト | 説明 |
| - | - | - | - |
| `project_id` | はい | - | Project の ID |
| `task_id` | はい | - | タスクの ID。`get_project` のタスク一覧から取得します |
| `category_id` | はい | - | Project のカテゴリー |
| `title` | いいえ | `null` | 新しいタイトル |
| `summary` | いいえ | `null` | 新しい概要の段落 |
| `brief` | いいえ | `null` | 新しいタスクの指示。構造化されたブリーフオブジェクトとして送信します |
| `type` | いいえ | `null` | 新しいタスクの種類 |
| `topic` | いいえ | `null` | 新しい対象トピック |
| `impact` | いいえ | `null` | 新しいインパクトスコア(1〜5) |
| `reference_url` | いいえ | `null` | タスクの新しい補足リンク |
| `reference_label` | いいえ | `null` | そのリンクの新しい表示名 |
| `preview` | いいえ | `true` | `true` の場合は計画された変更を表示し、`false` の場合は適用します |
**注意事項**:
* 新しい `brief` は古いブリーフを完全に置き換えるため、アシスタントは小さな変更であってもブリーフ全体を送信します。
タスクのステータスを変更します。ステータスのオプションは `not_started`、`in_progress`、`done`、`abandoned` です。`abandoned` ステータスはタスクを削除しません。
**プロンプトの例**:
* 「料金ページ更新のタスクを完了にしてください。」
* 「アーンドメディアのタスクは一時停止するので、保留にしてください。」
**入力**
| 入力 | 必須 | デフォルト | 説明 |
| - | - | - | - |
| `project_id` | はい | - | Project の ID |
| `task_id` | はい | - | タスクの ID |
| `category_id` | はい | - | Project のカテゴリー |
| `status` | はい | - | 新しいタスクのステータス |
| `note` | いいえ | `null` | ステータス変更とともに記録されるメモ |
| `preview` | いいえ | `true` | `true` の場合は提案されたステータス変更を返し、`false` の場合は適用します |
Project からタスクを完全に削除します。破壊的かつ元に戻せない操作で、プレビューのステップはありません。
タスクを失わずにアーカイブするには、代わりにステータスを `abandoned` に変更するよう依頼してください。
**プロンプトの例**:
* 「先ほど追加した重複タスクを削除してください。」
* 「そのテストタスクを完全に削除してください。」
**入力**
| 入力 | 必須 | デフォルト | 説明 |
| - | - | - | - |
| `project_id` | はい | - | Project の ID |
| `task_id` | はい | - | 削除するタスクの ID |
| `category_id` | はい | - | Project のカテゴリー |
## リソース
| リソース URI | 説明 |
| - | - |
| `file:///profound/projects-guide` | Projects のガイド。目標と測定、特定されたアイデンティティブロック、タスクの種類とブリーフのスキーマ、インパクトの評価基準、`new_project` のヒアリングについて説明します |
| `file:///profound/projects-guide/brief-examples` | Project ブリーフとタスクブリーフの完全な例 |