asana-admin-mcp

MCP-сервер для структурирования Asana — портфолио, пользовательские поля / dropdown, проекты, секции. Заполняет пробелы, которые стандартный коннектор Asana не умеет (тот ориентирован на задачи/чтение).

⚠️ Dashboard не работает — и это не ограничение данного MCP

Asana не предоставляет публичный API для Dashboard / chart / widget / project view tab вообще (проверили все 175 endpoints в официальной OpenAPI-спецификации — ни одного нет).

Единственный способ автоматизировать — project_duplicate: согласно спецификации, при дублировании проекта Project Views (вкладки List / Board / Dashboard) копируются всегда, и это нельзя отключить. → Настройте Dashboard в одном «проекте-шаблоне» и дублируйте его каждый раз, когда нужен новый проект.

🟡 Ещё не доказано: в спецификации сказано, что «Project Views» копируются, но не указано явно, копируются ли настроенные в Dashboard чарты или только пустые вкладки — через API это не проверить (нет endpoint для чтения chart), нужно смотреть глазами. smoke test от 2026-08-17 дублировал проект без chart, поэтому этот вопрос остаётся открытым.

Примечание: Project Template не переносит Dashboard (это до сих пор висит как feature request на форуме Asana). Нужно использовать duplicate, а не template.

Установка

1. Сначала получите Asana token (у каждого должен быть свой)

Следуйте GET-TOKEN.md → сохраните в ~/.asana_token

printf '%s' 'วาง_token_ตรงนี้' > ~/.asana_token && chmod 600 ~/.asana_token

token привязан к правам конкретного пользователя — нельзя использовать чужой — в логах Asana будет виден владелец token.

2. Установка плагина (рекомендуется)

В Claude Code введите две строки:

/plugin marketplace add plakorp/asana-admin-mcp
/plugin install asana-admin@asana-admin-mcp

Claude Code сам склонирует репозиторий, выполнит npm ci и зарегистрирует MCP — трогать ~/.claude.json не нужно. Обновление позже: /plugin update.

На машине нужен Node 20+ (проверьте через node -v).

Способ 2 — ручная установка (если не хотите использовать плагин)

Склонируйте репозиторий и дважды кликните ติดตั้ง-asana-admin-mcp.command Скрипт запросит token, выполнит npm install и запишет ~/.claude.json (каждый раз с резервной копией).

Не используйте оба способа одновременно — получится два дублирующихся MCP с именем asana-admin.

Token сначала читается из env ASANA_TOKEN; если его нет — fallback на ~/.asana_token. → token никогда не хранится в репозитории и не должен попадать в ~/.claude.json.

Инструменты (21)

Все инструменты принимают gid, а не имя — используйте asana_find, чтобы преобразовать имя → gid.

Поиск

Портфолио

Пользовательские поля / dropdown

Asana не позволяет удалить значение dropdown — можно только enabled:false; задачи, где это значение уже выбрано, сохранят прежнее значение.

Проект / Секция

Намеренно нет инструментов для удаления проектов / портфолио / пользовательских полей — их невозможно восстановить, делайте это в веб-интерфейсе.

Цвета (доступны для портфолио / проекта / enum option)

none red orange yellow-orange yellow yellow-green green blue-green aqua blue indigo purple magenta hot-pink pink cool-gray

Тестирование

ASANA_TOKEN=$(cat ~/.asana_token) npm run smoke

Создаёт реальные объекты в первом workspace токена с именами, начинающимися на ZZ-mcp-smoke-* → проверяет все инструменты → удаляет всё сам. Если token не указан, выполняется только первая половина (server boot + list tools).

Примечания по работе

• 429 → автоматический retry 3 раза согласно Retry-After

• ошибки Asana возвращаются как настоящие сообщения API (указывают, какого поля не хватает / какой gid неверный), а не просто status code

• неотправленные поля не затрагиваются — portfolio_update, которому передан только name, не очищает цвет