asana-admin-mcp

MCP server for Asana 구조화 — portfolio, custom field / dropdown, project, section 표준 Asana connector가 채우지 못하는 부분을 채움 (그쪽은 task/read 중심)

⚠️ Dashboard는 할 수 없음 — 이 MCP의 한계가 아님

Asana는 Dashboard / chart / widget / project view tab용 public API를 전혀 제공하지 않음 (공식 OpenAPI spec의 175개 endpoints를 전부 확인 — 하나도 없음)

자동화할 수 있는 유일한 방법은 project_duplicate — 스펙에 duplicate project 시 Project Views (List / Board / Dashboard 탭)는 항상 함께 복사되며 끌 수 없다고 명시 → “프로토타입 프로젝트” 하나에 Dashboard를 설정해 두고 새 프로젝트가 필요할 때마다 duplicate

🟡 아직 검증되지 않음: 스펙에는 “Project Views”가 따라간다고 되어 있지만, Dashboard에 설정한 chart가 함께 가는지 아니면 빈 탭만 가는지는 명확하지 않음 — API로 확인 불가 (chart를 읽을 endpoint 없음) 눈으로 직접 확인해야 함 2026-08-17 smoke test에서는 chart가 없는 프로젝트를 duplicate 했으므로 이 질문에 아직 답할 수 없음

참고: Project Template은 Dashboard를 가져가지 않음 (Asana 포럼에 남아 있는 feature request) template이 아니라 duplicate를 사용해야 함

설치

1. 먼저 Asana token을 준비하세요 (각자 자신의 것이 필요함)

**GET-TOKEN.md**를 따라 진행 → ~/.asana_token에 저장

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

token은 개인 권한에 연결됨 다른 사람의 것 사용 금지 — Asana 로그에 token 소유자 이름이 표시됨

2. plugin 설치 (권장)

Claude Code에서 2줄을 입력하세요:

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

Claude Code가 repo를 clone하고 npm ci를 직접 실행한 다음 MCP를 등록해 줌 — ~/.claude.json을 건드릴 필요 없음 나중에 업데이트는 /plugin update

컴퓨터에 **Node 20+**가 필요함 (node -v로 확인)

방법 2 — 수동 설치 (plugin을 사용하고 싶지 않다면)

repo를 clone한 뒤 ติดตั้ง-asana-admin-mcp.command를 더블클릭 스크립트가 token을 요청하고, npm install을 실행한 다음 ~/.claude.json을 작성해 줌 (매번 backup)

두 방법을 동시에 사용하지 마세요 — asana-admin이라는 MCP가 2개 중복됩니다

Token은 env ASANA_TOKEN을 먼저 읽고, 없으면 ~/.asana_token으로 fallback → token은 repo에 절대 없으며 ~/.claude.json에 있을 필요도 없음

Tools (21)

모든 tool은 이름이 아닌 gid를 받음 — asana_find로 이름 → gid 변환 먼저

Discovery

Portfolio

Custom field / dropdown

Asana는 dropdown 값을 삭제할 수 없음 — enabled:false만 가능, 그 값을 선택한 작업은 원래 값을 계속 유지함

Project / Section

project / portfolio / custom field를 삭제하는 tool은 의도적으로 없음 — 삭제하면 복구할 수 없으니 웹 페이지에서 수행

색상 (portfolio / project / 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

token의 첫 번째 workspace에 ZZ-mcp-smoke-*로 시작하는 실제 데이터를 생성 → 모든 tool 검증 → 전부 직접 삭제 token을 넣지 않으면 전반부만 실행 (server boot + list tools)

작업 참고 사항

• 429 → Retry-After에 따라 자동 retry 3회

• Asana의 error는 status code만이 아니라 API의 실제 메시지로 반환 (어떤 field가 누락됐는지 / 어떤 gid가 잘못됐는지 알려줌)

• 보내지 않은 필드는 건드리지 않음 — name만 보낸 portfolio_update는 색상을 지우지 않음