asana-automation について
asana-automationは、Rube MCP上のComposio Asanaツールキットを通じて、タスク、プロジェクト、セクション、ユーザーに関する作業を自動化するスキルです。MCPクライアントからAsanaのワークスペースを管理する用途に向いています。
主な機能
- 01タスクの作成・検索・整理
- 02プロジェクトとセクションの管理
- 03チームとユーザー情報の取得
- 04APIリクエストの並列実行
活用シーン
- 01ワークスペースでタスクやサブタスクを作成
- 02プロジェクトのタスクをセクションに整理
- 03ワークスペースのメンバーを確認
- 04複数のAsana操作をまとめて実行
MCP 対応
Rube MCPを介してComposioのAsanaツールキットを利用します。クライアントでRube MCPに接続し、Asanaとの有効な接続を確立する必要があります。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ composiohq/ awesome-claude-skills --skill asana-automationインストール後、Claude Code で/asana-automationを入力して読み込まれたか確認します。
詳細
Rube MCP による Asana の自動化
Rube MCP を介して Composio の Asana ツールキットを使用し、Asana の操作を自動化します。
ツールキットのドキュメント:composio.dev/toolkits/asana
前提条件
- Rube MCP に接続されていること(RUBE_SEARCH_TOOLS が利用可能)
- ツールキット
asanaを指定したRUBE_MANAGE_CONNECTIONSを介して Asana に接続されていること - 最新のツールスキーマを取得するため、必ず最初に
RUBE_SEARCH_TOOLSを呼び出してください
セットアップ
Rube MCP を取得する:クライアント設定で https://rube.app/mcp を MCP サーバーとして追加してください。API キーは不要です。エンドポイントを追加するだけで動作します。
RUBE_SEARCH_TOOLSが応答することを確認し、Rube MCP が利用可能であることを確かめます- ツールキット
asanaを指定してRUBE_MANAGE_CONNECTIONSを呼び出します - 接続が ACTIVE でない場合は、返された認証リンクに従って Asana OAuth を完了します
- ワークフローを実行する前に、接続ステータスが ACTIVE と表示されていることを確認します
主なワークフロー
1. タスクを管理する
使用する状況:ユーザーがタスクの作成、検索、一覧表示、整理を希望している場合
ツールの呼び出し順序:
ASANA_GET_MULTIPLE_WORKSPACES- ワークスペース ID を取得[前提条件]ASANA_SEARCH_TASKS_IN_WORKSPACE- タスクを検索[任意]ASANA_GET_TASKS_FROM_A_PROJECT- プロジェクトのタスクを一覧表示[任意]ASANA_CREATE_A_TASK- 新しいタスクを作成[任意]ASANA_GET_A_TASK- タスクの詳細を取得[任意]ASANA_CREATE_SUBTASK- サブタスクを作成[任意]ASANA_GET_TASK_SUBTASKS- サブタスクを一覧表示[任意]
主なパラメーター:
workspace:ワークスペース GID(検索/作成に必須)projects:タスクを追加するプロジェクト GID の配列name:タスク名notes:タスクの説明assignee:担当者(ユーザー GID またはメールアドレス)due_on:期限(YYYY-MM-DD)
注意点:
- ほとんどの操作でワークスペース GID が必要です。最初に取得してください
- タスク GID は整数ではなく文字列で返されます
- 検索対象はワークスペースであり、プロジェクトではありません
2. プロジェクトとセクションを管理する
使用する状況:ユーザーがプロジェクトの作成、セクションの管理、タスクの整理を希望している場合
ツールの呼び出し順序:
ASANA_GET_WORKSPACE_PROJECTS- ワークスペースのプロジェクトを一覧表示[任意]ASANA_GET_A_PROJECT- プロジェクトの詳細を取得[任意]ASANA_CREATE_A_PROJECT- 新しいプロジェクトを作成[任意]ASANA_GET_SECTIONS_IN_PROJECT- セクションを一覧表示[任意]ASANA_CREATE_SECTION_IN_PROJECT- 新しいセクションを作成[任意]ASANA_ADD_TASK_TO_SECTION- タスクをセクションに移動[任意]ASANA_GET_TASKS_FROM_A_SECTION- セクション内のタスクを一覧表示[任意]
主なパラメーター:
project_gid:プロジェクト GIDname:プロジェクト名またはセクション名workspace:作成に使用するワークスペース GIDtask:セクションへの割り当てに使用するタスク GIDsection:セクション GID
注意点:
- プロジェクトはワークスペースに属します。作成にはワークスペース GID が必要です
- セクションはプロジェクト内で順序付けられています
- DUPLICATE_PROJECT は、任意でタスクを含めてコピーを作成します
3. チームとユーザーを管理する
使用する状況:ユーザーがチーム、チームメンバー、またはワークスペースのユーザー一覧を希望している場合
ツールの呼び出し順序:
ASANA_GET_TEAMS_IN_WORKSPACE- ワークスペースのチームを一覧表示[任意]ASANA_GET_USERS_FOR_TEAM- チームメンバーを一覧表示[任意]ASANA_GET_USERS_FOR_WORKSPACE- ワークスペースの全ユーザーを一覧表示[任意]ASANA_GET_CURRENT_USER- 認証済みユーザーを取得[任意]ASANA_GET_MULTIPLE_USERS- 複数ユーザーの詳細を取得[任意]
主なパラメーター:
workspace_gid:ワークスペース GIDteam_gid:チーム GID
注意点:
- ユーザーはワークスペース単位で管理されます
- チームメンバーを取得するにはチーム GID が必要です
4. 並列操作
使用する状況:ユーザーが一括操作を効率的に実行する必要がある場合
ツールの呼び出し順序:
ASANA_SUBMIT_PARALLEL_REQUESTS- 複数の API 呼び出しを並列実行[必須]
主なパラメーター:
actions:メソッド、パス、データを含むアクションオブジェクトの配列
注意点:
- 各アクションは有効な Asana API 呼び出しである必要があります
- 個々のリクエストが失敗しても、成功したリクエストはロールバックされません
よくあるパターン
ID の解決
ワークスペース名 -> GID:
1. Call ASANA_GET_MULTIPLE_WORKSPACES
2. Find workspace by name
3. Extract gid field
プロジェクト名 -> GID:
1. Call ASANA_GET_WORKSPACE_PROJECTS with workspace GID
2. Find project by name
3. Extract gid field
ページネーション
- Asana は
offsetパラメーターを使用したカーソルベースのページネーションを採用しています - レスポンスの
next_pageを確認します - 次のリクエストでは、
next_page.offsetの値をoffsetとして渡します
既知の注意点
GID の形式:
- Asana のすべての ID は整数ではなく、文字列(GID)です
- GID はグローバルに一意な識別子です
ワークスペースのスコープ:
- ほとんどの操作でワークスペースのコンテキストが必要です
- タスク、プロジェクト、ユーザーはワークスペースのスコープに属します
クイックリファレンス
| タスク | ツールスラッグ | 主なパラメーター |
|---|---|---|
| ワークスペースの一覧表示 | ASANA_GET_MULTIPLE_WORKSPACES | (なし) |
| タスクの検索 | ASANA_SEARCH_TASKS_IN_WORKSPACE | workspace, text |
| タスクの作成 | ASANA_CREATE_A_TASK | workspace, name, projects |
| タスクの取得 | ASANA_GET_A_TASK | task_gid |
| サブタスクの作成 | ASANA_CREATE_SUBTASK | parent, name |
| サブタスクの一覧表示 | ASANA_GET_TASK_SUBTASKS | task_gid |
| プロジェクトのタスク | ASANA_GET_TASKS_FROM_A_PROJECT | project_gid |
| プロジェクトの一覧表示 | ASANA_GET_WORKSPACE_PROJECTS | workspace |
| プロジェクトの作成 | ASANA_CREATE_A_PROJECT | workspace, name |
| プロジェクトの取得 | ASANA_GET_A_PROJECT | project_gid |
| プロジェクトの複製 | ASANA_DUPLICATE_PROJECT | project_gid |
| セクションの一覧表示 | ASANA_GET_SECTIONS_IN_PROJECT | project_gid |
| セクションの作成 | ASANA_CREATE_SECTION_IN_PROJECT | project_gid, name |
| セクションへの追加 | ASANA_ADD_TASK_TO_SECTION | section, task |
| セクションのタスク | ASANA_GET_TASKS_FROM_A_SECTION | section_gid |
| チームの一覧表示 | ASANA_GET_TEAMS_IN_WORKSPACE | workspace_gid |
| チームメンバー | ASANA_GET_USERS_FOR_TEAM | team_gid |
| ワークスペースのユーザー | ASANA_GET_USERS_FOR_WORKSPACE | workspace_gid |
| 現在のユーザー | ASANA_GET_CURRENT_USER | (なし) |
| 並列リクエスト | ASANA_SUBMIT_PARALLEL_REQUESTS | actions |
Composio 提供