コンテンツにスキップ

ADK 向け Asana MCP ツール

Supported in ADKPythonTypeScript

Asana MCP Server は ADK エージェントを Asana のワークマネジメント プラットフォームに接続します。この連携により、エージェントは 自然言語でプロジェクト、タスク、目標、チームコラボレーションを管理できます。

ユースケース

  • プロジェクト状況の追跡: プロジェクト進捗のリアルタイム更新を取得し、 ステータスレポートを確認し、マイルストーンと期限情報を取得します。

  • タスク管理: 自然言語でタスクを作成・更新・整理します。 エージェントにタスク割り当て、ステータス変更、優先度更新を任せられます。

  • 目標のモニタリング: Asana Goals にアクセスして更新し、 組織全体のチーム目標と主要成果を追跡します。

前提条件

  • ワークスペースへアクセス可能な Asana アカウント

エージェントで使う

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters

root_agent = Agent(
    model="gemini-2.5-pro",
    name="asana_agent",
    instruction="Help users manage projects, tasks, and goals in Asana",
    tools=[
        McpToolset(
            connection_params=StdioConnectionParams(
                server_params=StdioServerParameters(
                    command="npx",
                    args=[
                        "-y",
                        "mcp-remote",
                        "https://mcp.asana.com/sse",
                    ]
                ),
                timeout=30,
            ),
        )
    ],
)
import { LlmAgent, MCPToolset } from "@google/adk";

const rootAgent = new LlmAgent({
    model: "gemini-2.5-pro",
    name: "asana_agent",
    instruction: "Help users manage projects, tasks, and goals in Asana",
    tools: [
        new MCPToolset({
            type: "StdioConnectionParams",
            serverParams: {
                command: "npx",
                args: [
                    "-y",
                    "mcp-remote",
                    "https://mcp.asana.com/sse",
                ],
            },
        }),
    ],
});

export { rootAgent };

Note

このエージェントを初めて実行すると、OAuth によるアクセス許可を要求するため ブラウザウィンドウが自動で開きます。あるいはコンソールに表示される 認可 URL を使用することもできます。エージェントが Asana データへアクセスするには この要求を承認する必要があります。

利用可能なツール

Asana の MCP サーバーにはカテゴリ別に整理された 30 以上のツールが含まれます。 ツールはエージェント接続時に自動検出されます。エージェント実行後、 トレースグラフで利用可能ツールを確認するには ADK Web UI を使用してください。

Category Description
Project tracking プロジェクトの進捗更新とレポート取得
Task management タスクの作成、更新、整理
User information ユーザー情報と割り当ての参照
Goals Asana Goals の追跡と更新
Team organization チーム構造とメンバーシップ管理
Object search Asana オブジェクトを横断するクイック typeahead 検索

追加リソース