mcpField
A
asana-automation

asana-automation

github.com/davepoon生産性3.7k126 回インストール2 日前に更新
リポジトリ

asana-automation について

asana-automationは、Rube MCP上のComposio Asanaツールキットを使って、Asanaのタスク、プロジェクト、チームの作業を自動化するスキルです。MCPツール経由でAsanaデータを管理するユーザー向けです。

主な機能

  1. 01タスクの作成、検索、整理
  2. 02プロジェクトとセクションの管理
  3. 03チームとユーザーの確認
  4. 04APIリクエストの並列実行

活用シーン

  1. 01タスクやサブタスクの作成
  2. 02プロジェクトのセクション整理
  3. 03ワークスペースのチームとユーザーの検索
  4. 04複数のAsana操作の並列実行

MCP 対応

Rube MCPを介してComposioのAsanaツールキットを利用します。Asana接続を有効にし、利用前に最新のツールスキーマを取得する必要があります。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davepoon/buildwithclaude --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 キーは不要です。エンドポイントを追加するだけで動作します。

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

主なワークフロー

1. タスクを管理する

使用する状況：ユーザーがタスクの作成、検索、一覧表示、整理を希望している場合

ツールの呼び出し順序：

  1. ASANA_GET_MULTIPLE_WORKSPACES - ワークスペース ID を取得［前提条件］
  2. ASANA_SEARCH_TASKS_IN_WORKSPACE - タスクを検索［任意］
  3. ASANA_GET_TASKS_FROM_A_PROJECT - プロジェクトのタスクを一覧表示［任意］
  4. ASANA_CREATE_A_TASK - 新しいタスクを作成［任意］
  5. ASANA_GET_A_TASK - タスクの詳細を取得［任意］
  6. ASANA_CREATE_SUBTASK - サブタスクを作成［任意］
  7. ASANA_GET_TASK_SUBTASKS - サブタスクを一覧表示［任意］

主なパラメーター：

  • workspace：ワークスペース GID（検索／作成に必須）
  • projects：タスクを追加するプロジェクト GID の配列
  • name：タスク名
  • notes：タスクの説明
  • assignee：担当者（ユーザー GID またはメールアドレス）
  • due_on：期限（YYYY-MM-DD）

注意点：

  • ほとんどの操作でワークスペース GID が必要です。最初に取得してください
  • タスク GID は整数ではなく文字列で返されます
  • 検索対象はワークスペースであり、プロジェクトではありません
2. プロジェクトとセクションを管理する

使用する状況：ユーザーがプロジェクトの作成、セクションの管理、タスクの整理を希望している場合

ツールの呼び出し順序：

  1. ASANA_GET_WORKSPACE_PROJECTS - ワークスペースのプロジェクトを一覧表示［任意］
  2. ASANA_GET_A_PROJECT - プロジェクトの詳細を取得［任意］
  3. ASANA_CREATE_A_PROJECT - 新しいプロジェクトを作成［任意］
  4. ASANA_GET_SECTIONS_IN_PROJECT - セクションを一覧表示［任意］
  5. ASANA_CREATE_SECTION_IN_PROJECT - 新しいセクションを作成［任意］
  6. ASANA_ADD_TASK_TO_SECTION - タスクをセクションに移動［任意］
  7. ASANA_GET_TASKS_FROM_A_SECTION - セクション内のタスクを一覧表示［任意］

主なパラメーター：

  • project_gid：プロジェクト GID
  • name：プロジェクト名またはセクション名
  • workspace：作成に使用するワークスペース GID
  • task：セクションへの割り当てに使用するタスク GID
  • section：セクション GID

注意点：

  • プロジェクトはワークスペースに属します。作成にはワークスペース GID が必要です
  • セクションはプロジェクト内で順序付けられています
  • DUPLICATE_PROJECT は、任意でタスクを含めてコピーを作成します
3. チームとユーザーを管理する

使用する状況：ユーザーがチーム、チームメンバー、またはワークスペースのユーザー一覧を希望している場合

ツールの呼び出し順序：

  1. ASANA_GET_TEAMS_IN_WORKSPACE - ワークスペースのチームを一覧表示［任意］
  2. ASANA_GET_USERS_FOR_TEAM - チームメンバーを一覧表示［任意］
  3. ASANA_GET_USERS_FOR_WORKSPACE - ワークスペースの全ユーザーを一覧表示［任意］
  4. ASANA_GET_CURRENT_USER - 認証済みユーザーを取得［任意］
  5. ASANA_GET_MULTIPLE_USERS - 複数ユーザーの詳細を取得［任意］

主なパラメーター：

  • workspace_gid：ワークスペース GID
  • team_gid：チーム GID

注意点：

  • ユーザーはワークスペース単位で管理されます
  • チームメンバーを取得するにはチーム GID が必要です
4. 並列操作

使用する状況：ユーザーが一括操作を効率的に実行する必要がある場合

ツールの呼び出し順序：

  1. 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_WORKSPACEworkspace, text
タスクの作成ASANA_CREATE_A_TASKworkspace, name, projects
タスクの取得ASANA_GET_A_TASKtask_gid
サブタスクの作成ASANA_CREATE_SUBTASKparent, name
サブタスクの一覧表示ASANA_GET_TASK_SUBTASKStask_gid
プロジェクトのタスクASANA_GET_TASKS_FROM_A_PROJECTproject_gid
プロジェクトの一覧表示ASANA_GET_WORKSPACE_PROJECTSworkspace
プロジェクトの作成ASANA_CREATE_A_PROJECTworkspace, name
プロジェクトの取得ASANA_GET_A_PROJECTproject_gid
プロジェクトの複製ASANA_DUPLICATE_PROJECTproject_gid
セクションの一覧表示ASANA_GET_SECTIONS_IN_PROJECTproject_gid
セクションの作成ASANA_CREATE_SECTION_IN_PROJECTproject_gid, name
セクションへの追加ASANA_ADD_TASK_TO_SECTIONsection, task
セクションのタスクASANA_GET_TASKS_FROM_A_SECTIONsection_gid
チームの一覧表示ASANA_GET_TEAMS_IN_WORKSPACEworkspace_gid
チームメンバーASANA_GET_USERS_FOR_TEAMteam_gid
ワークスペースのユーザーASANA_GET_USERS_FOR_WORKSPACEworkspace_gid
現在のユーザーASANA_GET_CURRENT_USER（なし）
並列リクエストASANA_SUBMIT_PARALLEL_REQUESTSactions

Composio 提供

コメント

Markdown 対応