Asana MCP Server (공식 V2 원격) — Claude Code MCP 서버

Asana 워크스페이스의 태스크·프로젝트·목표를 다루는 공식 V2 원격 MCP 서버. OAuth 2.0 인증(V1은 2026-05-11 종료 예정).

Asana MCP Server(공식 V2 원격)는 프로젝트·작업 관리 도구 Asana가 직접 제공하는 원격 MCP(Model Context Protocol) 서버입니다. Claude Code 같은 MCP 클라이언트가 이 서버에 연결하면, 자연어 지시만으로 Asana 워크스페이스의 태스크·프로젝트·목표(goal)를 조회하고 다룰 수 있습니다. 서버 엔드포인트는 https://mcp.asana.com/v2/mcp이며 HTTP 트랜스포트와 OAuth 2.0 인증을 사용합니다. (V1 서버는 2026-05-11 종료 예정이므로 신규 연동은 V2로 진행하는 것을 권장합니다.)

해결하는 문제는 분명합니다. 업무 현황을 확인하거나 새 태스크를 만들고 담당자·마감일을 정리하려고 Asana 웹/앱을 매번 오가는 컨텍스트 전환 비용을, AI 에이전트가 대신 처리하도록 줄여줍니다. 예를 들어 "이번 주 마감인 내 태스크 보여줘", "이 프로젝트에 신규 태스크를 만들고 OOO에게 배정해줘", "분기 목표 진행 상황을 요약해줘"처럼 대화로 요청하면, 에이전트가 MCP 도구를 호출해 Asana 데이터를 가져오거나 변경합니다.

핵심 기능은 (1) 태스크 조회·생성·업데이트, (2) 프로젝트 단위 작업 정리, (3) 목표(goal) 추적, (4) 워크스페이스 컨텍스트 기반 검색·요약 등 협업 워크플로 자동화입니다. 공식 서버이므로 인증·권한이 Asana 계정 체계와 일관되게 동작하며, 제공되는 정확한 도구 목록과 스코프는 버전에 따라 달라질 수 있으니 공식 문서 확인을 권장합니다.

누가 쓰면 좋은가: Asana로 업무를 관리하면서 Claude 같은 AI 에이전트로 보고서 작성·진행상황 요약·반복적인 태스크 입력을 자동화하려는 팀, PM, 개발·운영 담당자에게 적합합니다. 출처: 공식 문서 https://developers.asana.com/docs/using-asanas-mcp-server

언제 쓰나

Asana를 팀 업무 관리에 쓰면서, Claude Code 등 AI 에이전트로 태스크 조회·생성·배정, 프로젝트/목표 진행상황 요약, 반복적인 작업 입력을 자동화하고 싶을 때 적합합니다. 업무 현황을 묻거나 보고서를 만들 때 Asana 웹/앱을 오가는 컨텍스트 전환을 줄이려는 경우에 특히 유용합니다. 단, V1은 2026-05-11 종료 예정이므로 신규 연동은 V2 원격 서버로 진행하세요.

설치

claude mcp add --transport http --client-id YOUR_CLIENT_ID --client-secret --callback-port 8080 asana https://mcp.asana.com/v2/mcp

원격 HTTP 트랜스포트 + OAuth 2.0 인증을 사용하는 공식 V2 서버(`https://mcp.asana.com/v2/mcp`)입니다. 연결하려면 Asana 개발자 콘솔에서 OAuth 앱을 등록해 클라이언트 ID/시크릿을 발급받아야 하며, OAuth 콜백 처리를 위한 로컬 콜백 포트(예: 8080)가 필요합니다. V1 서버는 2026-05-11 종료 예정이므로 V2로 연동하세요. 제공 도구·인증 스코프·콜백 설정 세부는 버전에 따라 달라질 수 있으니 공식 문서를 확인하는 것을 권장합니다.

필요 키(직접 발급, 플레이스홀더): ASANA_OAUTH_CLIENT_ID, ASANA_OAUTH_CLIENT_SECRET

보안 주의

OAuth 자격증명(ASANA_OAUTH_CLIENT_ID, ASANA_OAUTH_CLIENT_SECRET)은 비밀키이므로 커밋·로그·공유를 금지하고 환경변수/시크릿 매니저로만 관리하세요. 이 서버는 Asana 워크스페이스의 태스크·프로젝트·목표 등 업무 데이터에 접근하며, 권한 범위에 따라 태스크 생성·수정·삭제 같은 쓰기 작업도 가능하므로 에이전트가 의도치 않게 데이터를 변경/삭제하지 않도록 권한을 최소 스코프로 제한하고 변경성 작업은 확인 후 실행하는 것이 안전합니다. 또한 태스크 제목·설명 등 외부에서 입력된 콘텐츠가 프롬프트 인젝션 경로가 될 수 있으므로, 가져온 내용을 그대로 신뢰해 자동 실행하지 말고 검토하세요.

자주 묻는 질문

Asana MCP Server V1과 V2의 차이는 무엇인가요?

V2는 공식 원격 MCP 서버(https://mcp.asana.com/v2/mcp)로 OAuth 2.0 인증을 사용합니다. V1은 2026-05-11 종료 예정이므로 신규 연동은 V2로 진행하는 것이 권장됩니다. 구체적인 기능 차이는 공식 문서 확인을 권장합니다.

연결하려면 무엇이 필요한가요?

Asana 개발자 콘솔에서 OAuth 앱을 등록해 클라이언트 ID/시크릿을 발급받고, OAuth 인증을 처리할 로컬 콜백 포트가 필요합니다. 인증 후 Claude 같은 MCP 클라이언트에서 워크스페이스 데이터를 다룰 수 있습니다.

AI가 태스크를 삭제하거나 잘못 변경할 위험은 없나요?

권한 스코프에 따라 쓰기·변경 작업이 가능하므로 위험이 있습니다. 최소 권한으로 제한하고, 생성·수정·삭제 같은 변경성 작업은 자동 실행 대신 확인 후 진행하는 것을 권장합니다.