wrike-automation

Rube MCP による Wrike の自動化

Rube MCP 経由で Composio の Wrike ツールキットを使用し、Wrike のプロジェクト管理業務を自動化します。

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS を利用可能であること）
• RUBE_MANAGE_CONNECTIONS を通じて有効な Wrike 接続があること（ツールキット wrike）
• 必ず最初に RUBE_SEARCH_TOOLS を呼び出し、最新のツールスキーマを取得してください

セットアップ

Rube MCP を入手する：クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。Wrike の操作には、有効な認証済み接続と付与された権限が必要です。エンドポイントを追加するだけではアクセス権は付与されません。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確認します
2. ツールキット wrike を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Wrike OAuth を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

書き込みとスキーマの境界

以下のスラッグやパラメーターを使用する前に、インストール済みのツールスキーマと現在のベンダーの動作を確認してください。対象のワークスペース、フォルダー、ID を正確に確認してください。タスクの作成、割り当て、招待、共有、削除は、それぞれ個別にユーザーに表示される書き込み操作です。破壊的な操作の対象範囲を事前に確認し、該当する明示的な許可を得てください。この過去の表から削除・ごみ箱への移動・復元の動作を推測したり、結果が不確かな書き込み操作を再試行したり、非同期処理の開始応答から成功を推定したりしないでください。まず、結果の状態を読み戻してください。

主なワークフロー

1. タスクの作成と管理

使用する場面：ユーザーが Wrike でタスクを作成、割り当て、または更新したい場合

ツールの順序：

1. WRIKE_GET_FOLDERS - 対象のフォルダー／プロジェクトを探します［前提条件］
2. WRIKE_GET_ALL_CUSTOM_FIELDS - 必要に応じてカスタムフィールド ID を取得します［任意］
3. WRIKE_CREATE_TASK - 新しいタスクを作成します［必須］
4. WRIKE_MODIFY_TASK - タスクのプロパティを更新します［任意］

主なパラメーター：

• folderId：タスクを作成する親フォルダーの ID
• title：タスクのタイトル
• description：タスクの説明（HTML に対応）
• responsibles：割り当てるユーザー ID の配列
• status：'Active'、'Completed'、'Deferred'、'Cancelled'
• importance：'High'、'Normal'、'Low'
• customFields：{id, value} オブジェクトの配列
• dates：type、start、due、duration を含むオブジェクト

注意点：

• folderId は必須です。タスクはフォルダーに属している必要があります
• responsibles には Wrike のユーザー ID が必要です。メールアドレスや名前は使用できません
• カスタムフィールド ID は GET_ALL_CUSTOM_FIELDS から取得する必要があります
• priorityBefore と priorityAfter は同時に指定できません
• Team プランでは Status フィールドを利用できない場合があります
• dates.start と dates.due には 'YYYY-MM-DD' 形式を使用します

2. フォルダーとプロジェクトの管理

使用する場面：ユーザーがフォルダーやプロジェクトを作成、変更、整理したい場合

ツールの順序：

1. WRIKE_GET_FOLDERS - 既存のフォルダーを一覧表示します［必須］
2. WRIKE_CREATE_FOLDER - 新しいフォルダー／プロジェクトを作成します［任意］
3. WRIKE_MODIFY_FOLDER - フォルダーのプロパティを更新します［任意］
4. WRIKE_LIST_SUBFOLDERS_BY_FOLDER_ID - サブフォルダーを一覧表示します［任意］
5. WRIKE_DELETE_FOLDER - フォルダーを完全に削除します［任意］

主なパラメーター：

• folderId：作成時の親フォルダー ID、変更時の対象フォルダー ID
• title：フォルダー名
• description：フォルダーの説明
• customItemTypeId：フォルダーではなくプロジェクトとして作成する場合に設定します
• shareds：共有相手のユーザー ID またはメールアドレスの配列
• project：GET_FOLDERS でプロジェクト（true）またはフォルダー（false）を絞り込むための値

注意点：

• DELETE_FOLDER は完全削除であり、すべての内容（タスク、サブフォルダー、ドキュメント）が削除されます
• rootFolderId または recycleBinId を親として指定することはできません
• フォルダーの作成時に、作成者と自動的に共有されます
• customItemTypeId はフォルダーをプロジェクトに変換します
• descendants=true を指定した GET_FOLDERS はフォルダーツリーを返します（規模が大きくなる場合があります）

3. タスクの取得と追跡

使用するタイミング：タスクを検索したり、ステータスを確認したり、進捗を監視したりする場合

ツールの実行順序：

1. WRIKE_FETCH_ALL_TASKS - オプションのフィルターを使用してタスクを一覧表示します［必須］
2. WRIKE_GET_TASK_BY_ID - 特定のタスクの詳細情報を取得します［任意］

主なパラメーター：

• status：タスクのステータスで絞り込みます（'Active'、'Completed' など）
• dueDate：期限の範囲で絞り込みます（開始／終了／一致）
• fields：レスポンスに含める追加フィールド
• page_size：1ページあたりの結果数（1～100）
• taskId：詳細取得対象の特定のタスク ID
• resolve_user_names：ユーザー ID を名前に自動解決します（デフォルトは true）

注意点：

• FETCH_ALL_TASKS は、1ページあたり最大 100 件でページネーションされます
• dueDate フィルターでは、'equal'、'start'、'end' フィールドがサポートされています
• 日付形式：'yyyy-MM-dd' または 'yyyy-MM-ddTHH:mm:ss'
• GET_TASK_BY_ID は読み取り専用の詳細情報を返します
• 単一タスクのクエリでは、customFields がデフォルトで返されます

4. タスクのブループリントを起動

使用するタイミング：事前定義されたテンプレートからタスクを作成する場合

ツールの実行順序：

1. WRIKE_LIST_TASK_BLUEPRINTS - 利用可能なブループリントを一覧表示します［前提条件］
2. WRIKE_LIST_SPACE_TASK_BLUEPRINTS - 特定のスペース内のブループリントを一覧表示します［代替手段］
3. WRIKE_LAUNCH_TASK_BLUEPRINT_ASYNC - ブループリントを起動します［必須］

主なパラメーター：

• task_blueprint_id：起動するブループリントの ID
• title：ルートタスクのタイトル
• parent_id：親フォルダー／プロジェクトの ID（または super_task_id）
• super_task_id：親タスクの ID（または parent_id）
• reschedule_date：タスクの再スケジュール先の日付
• reschedule_mode：'RescheduleStartDate' または 'RescheduleFinishDate'
• entry_limit：コピーするタスクの最大数（1～250）

注意点：

• parent_id または super_task_id のいずれかが必要です。両方を指定することはできません
• ブループリントの起動は非同期です。タスクが表示されるまで時間がかかることがあります
• reschedule_date を指定するには、reschedule_mode の設定が必要です
• entry_limit により、ブループリントの起動ごとにコピーされるタスク／フォルダーは最大 250 件に制限されます
• copy_descriptions のデフォルトは false です。タスクの説明を含めるには true を設定します

5. ワークスペースとメンバーの管理

使用するタイミング：スペース、メンバー、または招待を管理する場合

ツールの実行順序：

1. WRIKE_GET_SPACE - スペースの詳細を取得します［任意］
2. WRIKE_GET_CONTACTS - ワークスペースの連絡先／メンバーを一覧表示します［任意］
3. WRIKE_CREATE_INVITATION - ユーザーをワークスペースに招待します［任意］
4. WRIKE_DELETE_SPACE - スペースを完全に削除します［任意］

主なパラメーター：

• spaceId：スペース識別子
• email：招待先のメールアドレス
• role：ユーザーのロール（'Admin'、'Regular User'、'External User'）
• firstName／lastName：招待する相手の名前

注意点：

• DELETE_SPACE は取り消せず、スペースのすべての内容が削除されます
• 招待では、userTypeId と role／external は相互に排他的です
• カスタムのメール件名／メッセージには、有料の Wrike プランが必要です
• GET_CONTACTS はワークスペース全体の連絡先を返します。タスク固有の担当者は返しません

よくあるパターン

フォルダー ID の解決

1. Call WRIKE_GET_FOLDERS (optionally with project=true for projects only)
2. Navigate folder tree to find target
3. Extract folder id (e.g., 'IEAGKVLFK4IHGQOI')
4. Use as folderId in task/folder creation

カスタムフィールドの設定

1. Call WRIKE_GET_ALL_CUSTOM_FIELDS to get definitions
2. Find field by name, extract id and type
3. Format value according to type (text, dropdown, number, date)
4. Include as {id: 'FIELD_ID', value: 'VALUE'} in customFields array

タスクの割り当て

1. Call WRIKE_GET_CONTACTS to find user IDs
2. Use user IDs in responsibles array when creating tasks
3. Or use addResponsibles/removeResponsibles when modifying tasks

ページネーション

• FETCH_ALL_TASKS：page_size（最大 100）を使用し、さらに結果があるか確認します
• GET_FOLDERS：descendants=false で pageSize を設定した場合は、nextPageToken を使用します
• LIST_TASK_BLUEPRINTS：next_page_token と page_size（デフォルトは 100）を使用します

既知の落とし穴

ID 形式:

• Wrike の ID は不透明な英数字文字列です（例: 'IEAGTXR7I4IHGABC'）
• タスク ID、フォルダー ID、スペース ID、ユーザー ID はすべてこの形式を使用します
• カスタムフィールド ID も同じパターンに従います
• ID を推測しないでください。必ずリスト/検索操作から解決してください

権限:

• 操作はユーザーロールと共有設定に依存します
• 共有フォルダー/タスクは共有ユーザーにのみ表示されます
• 管理者操作には適切なロールが必要です
• 一部の機能（カスタムステータス、請求タイプ）はプランに依存します

削除の安全性:

• DELETE_FOLDER はすべての内容を完全に削除します
• DELETE_SPACE はスペース全体と内容を削除します
• 代わりに MODIFY_FOLDER を使用してゴミ箱に移動することを検討してください
• ゴミ箱からの復元は、restore=true を指定した MODIFY_FOLDER で可能です

日付の扱い:

• 日付は 'yyyy-MM-dd' 形式を使用します
• DateTime は 'yyyy-MM-ddTHH:mm:ssZ' またはタイムゾーンオフセット付きを使用します
• タスクの日付にはタイプ（'Planned'、'Actual'）、開始日、期限、期間が含まれます
• 期間は分単位です

クイックリファレンス

タスク	ツールスラッグ	主なパラメータ
タスクを作成	WRIKE_CREATE_TASK	folderId, title, responsibles, status
タスクを変更	WRIKE_MODIFY_TASK	taskId, title, status, addResponsibles
ID でタスクを取得	WRIKE_GET_TASK_BY_ID	taskId
すべてのタスクを取得	WRIKE_FETCH_ALL_TASKS	status, dueDate, page_size
フォルダーを取得	WRIKE_GET_FOLDERS	project, descendants
フォルダーを作成	WRIKE_CREATE_FOLDER	folderId, title
フォルダーを変更	WRIKE_MODIFY_FOLDER	folderId, title, addShareds
フォルダーを削除	WRIKE_DELETE_FOLDER	folderId
サブフォルダーを一覧表示	WRIKE_LIST_SUBFOLDERS_BY_FOLDER_ID	folderId
カスタムフィールドを取得	WRIKE_GET_ALL_CUSTOM_FIELDS	(なし)
ブループリントを一覧表示	WRIKE_LIST_TASK_BLUEPRINTS	limit, page_size
ブループリントを起動	WRIKE_LAUNCH_TASK_BLUEPRINT_ASYNC	task_blueprint_id, title, parent_id
スペースを取得	WRIKE_GET_SPACE	spaceId
スペースを削除	WRIKE_DELETE_SPACE	spaceId
連絡先を取得	WRIKE_GET_CONTACTS	(なし)
ユーザーを招待	WRIKE_CREATE_INVITATION	email, role

使用する場面

このスキルは、概要に記載されたワークフローまたはアクションを実行する場合に適用されます。

制限事項

• タスクが上記の範囲に明確に一致する場合にのみ、このスキルを使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全境界、または成功基準が欠けている場合は、停止して確認を求めてください。