Asana MCP Server

Asana MCP Server

Asana MCPサーバーは、モデルコンテキストプロトコル（MCP）のオープンソース実装です。AIツール（例：AnthropicのClaude Desktop）がAsanaプラットフォームと対話できるようにします。標準化され、安全で豊富なAPIエンドポイントのセットを公開し、AIと自動化エージェントがAsanaデータを読み取り、操作できるようにします。

Author: roychri


プロトコルを表示

Asana MCPサーバーとは？

Asana MCPサーバーは、大規模言語モデル（LLM）クライアントとAsana APIの間の橋渡しを行います。これにより、Asanaのワークスペース、プロジェクト、タスク、コメント、ステータスにアクセス、検索、作成、更新、分析するための均一で安全なインターフェースを提供します。読み取り専用モードと完全アクセスモードがあり、さまざまなセキュリティとワークフローの要件に対応します。

Asana MCPサーバーの設定方法

  1. Asanaアカウントを作成する:

    • Asanaでサインアップします。

  2. Asanaアクセストークンを生成する:

  3. Asana MCPサーバーをインストールする:

    • Claude Desktopと統合するには、claude_desktop_config.jsonに以下の設定を追加します: 
      {
  "mcpServers": {
    "asana": {
      "command": "npx",
      "args": ["-y", "@roychri/mcp-server-asana"],
      "env": {
        "ASANA_ACCESS_TOKEN": "your-asana-access-token"
      }
    }
  }
}
    • Claude Code用には、次のコマンドを実行します: 
      claude mcp add asana -e ASANA_ACCESS_TOKEN=<TOKEN> -- npx -y @roychri/mcp-server-asana
      <TOKEN>をあなたのAsanaアクセストークンに置き換えます。

  4. 環境変数:

    • ASANA_ACCESS_TOKEN（必須）：あなたのAsana APIトークン。
    • READ_ONLY_MODE（オプション）：trueに設定すると、書き込み操作が無効になり、テストまたは読み取り専用ワークフローに適しています。

  5. 高度な設定:

    • ローカルで変更をテストするには、同梱されているMCPインスペクターを使用します。
    • ベータ版を使用するには、@roychri/mcp-server-asana@betaを指定します。

Asana MCPサーバーの使用方法

設定が完了し、実行中になると、Asana MCPサーバーは、MCP対応のAIアプリケーション（例：Claude Desktop）にAsanaのツールとリソースを自動的に提供します。使用する手順は以下の通りです:

  1. Asanaのワークスペース、プロジェクト、またはタスクについて自然言語で質問します。
  2. より特定の操作を行うには、プロンプトに「asana」と言及してLLMが正しいツールを選択できるようにします。
  3. サーバーは、タスクの検索、プロジェクトの作成、コメントのリスト、タスクの完了分析など、数十の呼び出し可能なツールを公開します。
  4. AIアプリケーションのUIまたはMCPインスペクターを通じて、ツールの呼び出しを監視およびテストできます。
  5. 読み取り専用モードでは、安全な操作のみが有効であり、データを作成または変更する試みはブロックされます。

主な機能

  • 包括的な統合: AIアプリケーションとAsana APIの直接かつ安全なリンクで、主要な機能を網羅します。
  • 豊富なツールセット: タスク、プロジェクト、ステータス、およびコメントの検索、作成、更新、分析のための20以上の呼び出し可能なツールがあります。
  • カスタマイズ可能なアクセス: 読み取り専用および読み書きの操作モードをサポートし、セキュリティと制御を強化します。
  • プロンプトテンプレート: ステータスの要約やタスクの完了分析など、一般的なシナリオに対する内蔵プロンプトジェネレーターがあります。
  • リソース表現: Asanaのワークスペースとプロジェクトを構造化されたMCPリソースとして完全に公開し、豊かなコンテキストを構築します。
  • スケーラブルアーキテクチャ: ローカルおよびクラウド/サーバー展開向けに設計されています。
  • オープンソース & MITライセンス: どの文脈でも自由に使用、変更、拡張できます。

使用例

  • 自動化されたプロジェクト報告: AIにプロジェクトやタスクのステータスを要約させ、ボトルネックを解消し、期限を過ぎた作業項目を明らかにさせます。
  • スマートタスク管理: 自然言語でAsanaと対話し、タスクを作成、更新、または検索します。
  • ワークフローの自動化: 会話やその他のAI主導のワークフローに基づいてAsanaの更新をトリガーするエージェントを動かします。
  • プロジェクト監査と分析: 内蔵ツールを使用してタスクの完了状況を確認し、プロジェクトの統計を抽出し、作業配分を分析します。
  • テストと読み取り専用モニタリング: 読み取り専用モードでAsana環境を安全に探索または監視し、コンプライアンスやデモに役立てます。

FAQ

Q1: MCPサーバーを使用するにはどのような権限が必要ですか？
A1: あなたのAsanaアカウントは、APIアクセスを許可するAsanaプラン（無料または有料）が必要です。生成したアクセストークンは、あなたのユースケースに必要な読み取りまたは書き込み操作を許可する必要があります。

Q2: 誤って変更を防ぐために、Asana MCPサーバーを読み取り専用モードで実行するにはどうすればよいですか？
A2: サーバー起動時に環境変数READ_ONLY_MODE=trueを設定します。作成、更新、削除ツールは無効になります。

Q3: サーバーが権限エラーを返します。どうすれば解決できますか？
A3: あなたのAsanaアクセストークンが正しくアクティブであることを再確認してください。AsanaアカウントにAPIアクセスがあり、サーバー設定がclaude_desktop_config.json内の資格情報と一致していることを確認してください。

Q4: 完全に展開せずにローカルでサーバーをテストするにはどうすればよいですか？
A4: サーバーディレクトリ内でnpm run inspectorを実行してMCPインスペクターを使用します。必要に応じてCLIENT_PORTとSERVER_PORTでカスタムポートを指定できます。

Q5: Claude以外のLLMでこのサーバーを使用できますか？
A5: はい、あなたのAIツールがモデルコンテキストプロトコルをサポートしていれば、Asana MCPサーバーに接続できます。