Asana용 MCP 서버

Asana의 이 모델 컨텍스트 프로토콜 서버 구현을 통해 Anthropic의 Claude Desktop Application과 같은 MCP 클라이언트에서 Asana API와 통신할 수 있습니다.

MCP에 대한 자세한 내용은 여기에서 확인하세요.

• https://www.anthropic.com/news/model-context-protocol

• https://modelcontextprotocol.io/introduction

• https://github.com/modelcontextprotocol

용법

원하시는 AI 도구(예: Claude Desktop)에서 아사나 관련 작업, 프로젝트, 작업 공간 및/또는 댓글에 대해 질문해 보세요. "아사나"라는 단어를 언급하면 LLM 담당자가 적합한 도구를 선택할 가능성이 높아집니다.

예:

스프린트 30 프로젝트에서 완료되지 않은 아사나 작업이 몇 개나 있나요?

또 다른 예:

도구

1. asana_list_workspaces

   • Asana에서 사용 가능한 모든 작업 공간 나열

   • 선택 입력:

     • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

   • 반환: 작업 공간 목록

2. asana_search_projects

   • 이름 패턴 매칭을 사용하여 Asana에서 프로젝트 검색

   • 필수 입력:

     • 작업 공간(문자열): 검색할 작업 공간

     • name_pattern(문자열): 프로젝트 이름과 일치하는 정규 표현식 패턴

   • 선택 입력:

     • 보관됨(부울): 보관된 프로젝트만 반환합니다(기본값: false)

     • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

   • 반환: 일치하는 프로젝트 목록

3. asana_search_tasks

   • 고급 필터링 옵션을 사용하여 작업 공간에서 작업 검색

   • 필수 입력:

     • 작업 공간(문자열): 검색할 작업 공간

   • 선택 입력:

     • text(문자열): 작업 이름과 설명에서 검색할 텍스트

     • resource_subtype(문자열): 작업 하위 유형(예: 마일스톤)으로 필터링

     • 완료(부울): 완료된 작업에 대한 필터링

     • is_subtask(부울): 하위 작업에 대한 필터

     • has_attachment(부울): 첨부 파일이 있는 작업을 필터링합니다.

     • is_blocked(부울): 종속성이 완료되지 않은 작업을 필터링합니다.

     • is_blocking(부울): 종속 항목이 있는 완료되지 않은 작업을 필터링합니다.

     • 담당자, 프로젝트, 섹션, 태그, 팀 및 기타 여러 고급 필터

     • sort_by(문자열): due_date, created_at, finished_at, likes, modified_at(기본값: modified_at) 순으로 정렬

     • sort_ascending(boolean): 오름차순으로 정렬합니다(기본값: false)

     • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

     • custom_fields(객체): 사용자 정의 필드 필터를 포함하는 객체

   • 반환: 일치하는 작업 목록

4. asana_get_task

   • 특정 작업에 대한 자세한 정보를 얻으세요

   • 필수 입력:

     • task_id(문자열): 검색할 작업 ID

   • 선택 입력:

     • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

   • 반환: 자세한 작업 정보

5. asana_create_task

   • 프로젝트에서 새 작업 만들기

   • 필수 입력:

     • project_id(문자열): 작업을 생성할 프로젝트

     • name(문자열): 작업의 이름

   • 선택 입력:

     • notes(문자열): 작업에 대한 설명

     • html_notes(문자열): 작업에 대한 HTML 형식의 설명

     • due_on(문자열): YYYY-MM-DD 형식의 마감일

     • 담당자(문자열): 담당자(나 또는 사용자 ID일 수 있음)

     • 팔로워(문자열 배열): 팔로워로 추가할 사용자 ID 배열

     • parent(문자열): 이 작업을 설정할 부모 작업 ID

     • 프로젝트(문자열 배열): 이 작업을 추가할 프로젝트 ID 배열

     • resource_subtype(문자열): 작업 유형(기본 작업 또는 마일스톤)

     • custom_fields(객체): 사용자 정의 필드 GID 문자열을 해당 값에 매핑하는 객체

   • 반환: 생성된 작업 정보

6. asana_get_task_stories

   • 특정 작업에 대한 의견과 스토리를 받으세요

   • 필수 입력:

     • task_id(문자열): 스토리를 가져올 작업 ID

   • 선택 입력:

     • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

   • 반환: 작업 스토리/코멘트 목록

7. asana_update_task

   • 기존 작업 세부 정보 업데이트

   • 필수 입력:

     • task_id(문자열): 업데이트할 작업 ID

   • 선택 입력:

     • name(문자열): 작업의 새 이름

     • notes(문자열): 작업에 대한 새로운 설명

     • due_on(문자열): YYYY-MM-DD 형식의 새로운 마감일

     • 담당자(문자열): 새로운 담당자(나 또는 사용자 ID일 수 있음)

     • 완료(부울): 작업을 완료로 표시하거나 표시하지 않음

     • resource_subtype(문자열): 작업 유형(기본 작업 또는 마일스톤)

     • custom_fields(객체): 사용자 정의 필드 GID 문자열을 해당 값에 매핑하는 객체

   • 반환: 업데이트된 작업 정보

8. asana_get_project

   • 특정 프로젝트에 대한 자세한 정보를 얻으세요

   • 필수 입력:

     • project_id(문자열): 검색할 프로젝트 ID

   • 선택 입력:

     • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

   • 반환: 자세한 프로젝트 정보

9. asana_get_project_task_counts

   • 프로젝트의 작업 수를 가져옵니다

   • 필수 입력:

     • project_id(문자열): 작업 수를 가져올 프로젝트 ID

   • 선택 입력:

     • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

   • 반환: 작업 개수 정보

10. asana_get_project_sections

• 프로젝트의 섹션 가져오기

• 필수 입력:

  • project_id(문자열): 섹션을 가져올 프로젝트 ID

• 선택 입력:

  • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

• 반환: 프로젝트 섹션 목록

11. asana_create_task_story

• 작업에 대한 댓글이나 스토리를 작성하세요

• 필수 입력:

  • task_id(문자열): 스토리를 추가할 작업 ID

  • text(문자열): 스토리/댓글의 텍스트 내용

• 선택 입력:

  • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

• 반환: 생성된 스토리 정보

12. asana_add_task_dependencies

• 작업에 대한 종속성 설정

• 필수 입력:

  • task_id(문자열): 종속성을 추가할 작업 ID

  • 종속성(문자열 배열): 이 작업이 종속된 작업 ID 배열

• 반환: 업데이트된 작업 종속성

13. asana_add_task_dependents

• 작업에 대한 종속 항목 설정(이 작업에 종속된 작업)

• 필수 입력:

  • task_id(문자열): 종속 항목을 추가할 작업 ID

  • 종속 항목(문자열 배열): 이 작업에 종속된 작업 ID 배열

• 반환: 업데이트된 작업 종속성

14. asana_create_subtask

• 기존 작업에 대한 새 하위 작업 만들기

• 필수 입력:

  • parent_task_id(문자열): 하위 작업을 생성할 상위 작업 ID

  • name(문자열): 하위 작업의 이름

• 선택 입력:

  • notes(문자열): 하위 작업에 대한 설명

  • due_on(문자열): YYYY-MM-DD 형식의 마감일

  • 담당자(문자열): 담당자(나 또는 사용자 ID일 수 있음)

  • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

• 반환: 하위 작업 정보가 생성되었습니다.

15. asana_get_multiple_tasks_by_gid

• GID를 통해 여러 작업에 대한 자세한 정보를 얻으세요(최대 25개 작업)

• 필수 입력:

  • task_ids(문자열 배열 또는 쉼표로 구분된 문자열): 검색할 작업 GID(최대 25개)

• 선택 입력:

  • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

• 반환: 자세한 작업 정보 목록

16. asana_get_project_status

• 프로젝트 상태 업데이트 받기

• 필수 입력:

  • project_status_gid(문자열): 검색할 프로젝트 상태 GID

• 선택 입력:

  • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

• 반환: 프로젝트 상태 정보

17. asana_get_project_statuses

• 프로젝트의 모든 상태 업데이트 받기

• 필수 입력:

  • project_gid(문자열): 상태를 가져올 프로젝트 GID

• 선택 입력:

  • limit (숫자): 페이지당 결과(1-100)

  • offset(문자열): 페이지 번호 오프셋 토큰

  • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

• 반환: 프로젝트 상태 업데이트 목록

18. asana_create_project_status

• 프로젝트에 대한 새로운 상태 업데이트를 만듭니다.

• 필수 입력:

  • project_gid(문자열): 상태를 생성할 프로젝트 GID

  • text(문자열): 상태 업데이트의 텍스트 내용

• 선택 입력:

  • color(문자열): 상태의 색상(녹색, 노란색, 빨간색)

  • title(문자열): 상태 업데이트의 제목

  • html_text(문자열): 상태 업데이트를 위한 HTML 형식 텍스트

  • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

• 반환: 생성된 프로젝트 상태 정보

19. asana_delete_project_status

• 프로젝트 상태 업데이트 삭제

• 필수 입력:

  • project_status_gid(문자열): 삭제할 프로젝트 상태 GID

• 반환: 삭제 확인

20. asana_set_parent_for_task

• 작업의 상위 항목을 설정하고 해당 상위 항목의 다른 하위 항목 내에 하위 작업을 배치합니다.

• 필수 입력:

  • task_id(문자열): 작업할 작업 ID

  • 데이터(객체):

    • parent(문자열): 작업의 새 부모 또는 부모가 없는 경우 null

• 선택 입력:

  • insert_after(문자열): 작업을 삽입할 부모의 하위 작업 또는 목록의 시작 부분에 삽입할 경우 null

  • insert_before(문자열): 작업을 삽입할 부모의 하위 작업 또는 목록 끝에 삽입할 경우 null

  • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

• 반환: 업데이트된 작업 정보

21. asana_get_tasks_for_tag

• 특정 태그에 대한 작업 가져오기

• 필수 입력:

  • tag_gid(문자열): 작업을 검색할 태그 GID

• 선택 입력:

  • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

  • opt_pretty(부울): '예쁜' 형식으로 응답을 제공합니다.

  • limit(정수): 페이지당 반환할 개체 수입니다. 값은 1에서 100 사이여야 합니다.

  • offset(문자열): API에서 반환된 다음 페이지에 대한 오프셋입니다.

• 반환: 지정된 태그에 대한 작업 목록

22. asana_get_tags_for_workspace

• 작업 공간에서 태그 가져오기

• 필수 입력:

  • workspace_gid(문자열): 작업 공간 또는 조직의 전역 고유 식별자

• 선택 입력:

  • limit(정수): 페이지당 결과 수. 페이지당 반환할 객체 수. 값은 1에서 100 사이여야 합니다.

  • offset(문자열): 오프셋 토큰. API에서 반환된 다음 페이지까지의 오프셋입니다.

  • opt_fields(문자열): 포함할 선택적 필드의 쉼표로 구분된 목록

• 반환: 작업 공간의 태그 목록

프롬프트

1. task-summary

   • 메모, 사용자 정의 필드 및 주석을 기반으로 작업에 대한 요약 및 상태 업데이트를 받으세요.

   • 필수 입력:

     • task_id(문자열): 요약을 가져올 작업 ID

   • 반환: 작업 요약 생성을 위한 지침이 포함된 자세한 프롬프트

2. task-completeness

   • 작업 설명에 완료에 필요한 모든 세부 정보가 포함되어 있는지 분석합니다.

   • 필수 입력:

     • task_id(문자열): 분석할 작업 ID 또는 URL

   • 반환: 작업 완료 분석을 위한 지침이 포함된 자세한 프롬프트

3. create-task

   • 지정된 세부 정보로 새 작업 만들기

   • 필수 입력:

     • project_name(문자열): 작업이 생성되어야 하는 Asana 프로젝트의 이름

     • title(문자열): 작업의 제목

   • 선택 입력:

     • notes(문자열): 작업에 대한 메모 또는 설명

     • due_date(문자열): 작업 마감일(YYYY-MM-DD 형식)

   • 반환: 포괄적인 작업을 만드는 데 대한 지침이 포함된 자세한 프롬프트

자원

1. 작업 공간 - asana://workspace/{workspace_gid}

   • Asana 작업 공간을 리소스로 표현

   • 각 작업 공간은 별도의 리소스로 노출됩니다.

   • URI 형식: asana://workspace/{workspace_gid}

   • 반환: 작업 공간 세부 정보가 포함된 JSON 객체:

     • name : 작업 공간 이름(문자열)

     • id : 작업 공간 글로벌 ID(문자열)

     • type : 리소스 유형(문자열)

     • is_organization : 작업 공간이 조직인지 여부(부울)

     • email_domains : 작업 공간과 연결된 이메일 도메인 목록(string[])

   • MIME 유형: application/json

2. 프로젝트 - asana://project/{project_gid}

   • GID로 프로젝트 세부 정보를 검색하기 위한 템플릿 리소스

   • URI 형식: asana://project/{project_gid}

   • 반환: 프로젝트 세부 정보가 포함된 JSON 객체:

     • name : 프로젝트 이름(문자열)

     • id : 프로젝트 글로벌 ID(문자열)

     • type : 리소스 유형(문자열)

     • archived : 프로젝트가 보관되었는지 여부(부울)

     • public : 프로젝트가 공개인지 여부(부울)

     • notes : 프로젝트 설명/노트(문자열)

     • color : 프로젝트 색상(문자열)

     • default_view : 기본 뷰 유형(문자열)

     • due_date , due_on , start_on : 프로젝트 날짜 정보(문자열)

     • workspace : 작업공간 정보를 담고 있는 객체

     • team : 팀 정보를 담고 있는 객체

     • sections : 프로젝트의 섹션 객체 배열

     • custom_fields : 프로젝트에 대한 사용자 정의 필드 정의 배열

   • MIME 유형: application/json

설정

1. Asana 계정 만들기 :

   • 아사나를 방문하세요.

   • "가입"을 클릭하세요.

2. Asana 액세스 토큰 검색 :

   • Asana 개발자 콘솔에서 개인 액세스 토큰을 생성할 수 있습니다.

     • https://app.asana.com/0/my-apps

   • 자세한 내용은 여기에서 확인하세요: https://developers.asana.com/docs/personal-access-token

3. Claude Desktop 구성 : claude_desktop_config.json 에 다음을 추가합니다.

   지엑스피1

베타 버전(아직 출시되지 않음)을 설치하려면 다음을 사용할 수 있습니다.

• @roychri/mcp-server-asana@beta

현재 베타 릴리스가 있는 경우 다음 중 하나에서 찾을 수 있습니다.

1. https://www.npmjs.com/package/@roychri/mcp-server-asana?activeTab=versions

2. npm dist-tag ls @roychri/mcp-server-asana

문제 해결

권한 오류가 발생하는 경우:

1. 귀하가 보유한 Asana 플랜이 API 액세스를 허용하는지 확인하세요.

2. claude_desktop_config.json 에 액세스 토큰과 구성이 올바르게 설정되었는지 확인하세요.

기여하다

이 저장소를 복제하고 해킹을 시작하세요.

MCP 검사기를 사용하여 로컬로 테스트하세요

변경 사항을 테스트하려면 다음과 같이 MCP 검사기를 사용할 수 있습니다.

이렇게 하면 클라이언트는 포트 5173 에 노출되고 서버는 포트 3000 에 노출됩니다.

해당 포트가 이미 다른 곳에서 사용되고 있는 경우 다음을 사용할 수 있습니다.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.