Asana MCP Hybrid Integration
Asana公式MCP V2 + ローカルMCPガードサーバーのハイブリッド構成で、
Cursor Agent から自然言語でAsanaのポートフォリオ/プロジェクト/タスク管理を安全に実行する基盤。
Architecture
| MCP Server | Role | Transport |
|---|---|---|
| asana-official | 日常操作 (閲覧, 作成, 更新, 検索) | npx mcp-remote → Asana MCP V2 |
| asana-guard | ガード付き操作 (削除, 一括更新, 命名規則, 監査) | Python stdio |
Prerequisites
- Windows 10+
- Python 3.12+
- Node.js v22+ (for
npx mcp-remote) - Asana account with Developer Console access
Quick Start
# 1. Activate virtual environment
.venv\Scripts\Activate.ps1
# 2. Store your Asana PAT
python scripts\setup_auth.py
# 3. Verify connection
python scripts\verify_connection.py
# 4. Restart Cursor to load MCP servers
Guard MCP Tools
| Tool | Description |
|---|---|
guard_delete_task | Preview task deletion + issue confirm token |
guard_delete_project | Preview project deletion + issue confirm token |
guard_confirm_delete | Execute deletion with valid confirm token |
guard_audit_log | Search audit log entries |
guard_check_connection | Verify Asana API connectivity |
Security
- Secrets are stored in Windows Credential Manager via
keyring(DPAPI encrypted) - All guarded operations are logged to
logs/audit_YYYYMMDD.jsonl - Delete operations require two-step confirmation (preview → approve → execute)
- Sensitive values are automatically masked in audit logs