MCP 도구 참조
AB Projects는 AI 어시스턴트(예: Claude)가 프로젝트, 작업, 문서를 다룰 수 있도록 하는 MCP 도구를 제공합니다. 어시스턴트가 이 도구들을 통해 무언가를 변경하면 앱과 동일한 경로를 거칩니다: 제공한 메모가 포함된 변경 기록 항목, 감사 로그 항목, 그리고 연결된 Microsoft Teams 채널에 게시되는 적응형 카드(Adaptive Cards) — AI 활동이 명확하게 공개됩니다. 읽기 전용 도구는 데이터만 반환하고 아무것도 변경하지 않습니다.
프로젝트 도구
| 도구 | 설명 | 매개변수 |
|---|---|---|
ab_get_my_projects |
작업 수 및 완료율과 같은 통계를 포함하여 멤버로 속한 모든 프로젝트를 나열합니다. | 없음 |
ab_get_project_members |
프로젝트의 모든 멤버를 역할 및 멤버십 ID와 함께 나열합니다. 작업을 할당하는 데 필요한 멤버십 ID를 얻으려면 이를 사용하십시오. | project_id 필수 |
ab_get_project_options |
프로젝트의 유효한 상태, 유형, 환경 ID를 가져옵니다. 상태, 유형, 환경을 ab_create_task 또는 ab_update_task에 전달하기 전에 먼저 이를 호출하십시오. |
project_id 필수 |
작업 도구
| 도구 | 설명 | 매개변수 |
|---|---|---|
ab_get_my_tasks |
활성 작업을 가져옵니다 — 기한 초과, 오늘 마감, 진행 중. 작업 ID, 제목, 우선순위, 상태, 마감일, 진행률을 반환합니다. | project_id 선택 — 특정 프로젝트로 필터링 |
ab_search_tasks |
모든 프로젝트에서 키워드로 작업을 검색합니다. | query 필수 — 검색 키워드 project_id 선택 — 특정 프로젝트로 범위 지정 |
ab_get_task |
작업의 전체 세부 정보를 가져옵니다 — 설명, 날짜, 담당자, 예상/실제 시간, 하위 작업 정보, 상위 작업 ID, GitHub 브랜치, 그리고 가장 최근 50개 댓글이 인라인으로 포함됩니다. 상태, 유형, 환경은 사람이 읽을 수 있는 이름으로 반환됩니다. | project_id 필수 task_id 필수 |
ab_create_task |
새 작업을 생성합니다. 변경 로그 항목이 기록되고 연결된 Teams 채널에 알림이 게시됩니다. | project_id 필수 title 필수 description 선택 — Markdown 지원 priority 선택 — 1 = 높음, 2 = 중간, 3 = 낮음 (기본값: 2) assignee_id 선택 — 담당자의 멤버십 ID due_date 선택 — yyyy-MM-dd status / type / environment 선택 — ab_get_project_options의 IDparent_task_id 선택 — 상위 항목의 행 키. 설정하면 이것이 하위 작업이 되고 상위 항목의 "하위 작업 있음" 플래그가 자동으로 업데이트됩니다 note 선택 — 사유, 변경 로그 및 Teams 채널에 표시됨 |
ab_update_task |
작업의 속성을 업데이트합니다 — 제목, 설명, 상태, 진행률, 우선순위, 담당자, 유형, 환경, 또는 상위 항목. 각 변경은 제공된 메모와 함께 기록에 기록됩니다. | project_id 필수 task_id 필수 title / description 선택 (Markdown) status 선택 — 새 상태 ID progress 선택 — 0에서 100 priority 선택 — 1/2/3 assignee_id / type / environment 선택 parent_task_id 선택 — 다른 상위 항목 아래로 이동; 분리하려면 빈 문자열 note 선택 — 사유, 변경 로그 및 Teams 채널에 표시됨 |
ab_complete_task |
작업을 완료로 표시합니다. 진행률을 100%로 설정하고 변경 기록에 완료 항목을 기록합니다. | project_id 필수 task_id 필수 note 선택 — 완료 메모, 변경 로그 및 Teams 채널에 표시됨 |
ab_add_comment |
작업에 댓글을 추가합니다. 댓글은 작업의 스레드에 표시되며 ab_get_task에 의해 인라인으로 포함되므로 후속 호출이 두 번째 도구 호출 없이 읽을 수 있습니다. |
project_id 필수 task_id 필수 content 필수 — 댓글 텍스트 |
일정 도구
| 도구 | 설명 | 매개변수 |
|---|---|---|
ab_get_schedule |
현재 주의 일정을 가져옵니다 — 기한 초과, 오늘 마감, 이번 주 마감으로 그룹화됩니다. | project_id 선택 — 특정 프로젝트로 필터링 |
문서(Wiki) 도구
| 도구 | 설명 | 매개변수 |
|---|---|---|
ab_get_wiki_tree |
프로젝트의 문서 탐색 트리(폴더 및 페이지)를 가져옵니다. | project_id 필수 |
ab_get_wiki_article |
문서의 전체 콘텐츠, 메타데이터, 버전 정보를 읽습니다. | project_id 필수 article_id 필수 — ab_get_wiki_tree 또는 ab_search_wiki에서 |
ab_search_wiki |
특정 폴더 경로 아래의 문서를 나열합니다. | project_id 필수 parent_path 선택 — 나열할 폴더 (기본값: 루트의 경우 /) |
ab_create_wiki_article |
Markdown으로 새 문서를 생성합니다. 연결된 Teams 채널에 알림을 게시합니다. | project_id 필수 title 필수 content 필수 — Markdown parent_path 선택 — 폴더, 예: / 또는 /Engineering (기본값: /)tags 선택 — 쉼표로 구분 |
ab_update_wiki_article |
기존 문서를 업데이트합니다. 편집 메모와 함께 새 버전을 생성하고 Teams 채널에 알림을 게시합니다. | project_id 필수 article_id 필수 content 필수 — 업데이트된 Markdown edit_note 필수 — 변경 내용; 버전 기록에 표시됨 tags 선택 — 업데이트된 쉼표 구분 태그 |
ab_add_wiki_comment |
문서에 댓글을 추가합니다. | project_id 필수 article_id 필수 content 필수 — 댓글 텍스트 |
AI 변경 사항이 표시되는 방식
MCP 도구를 통해 작업이나 문서가 생성, 업데이트, 완료되면 AB Projects는 자동으로:
- 사용자 이름과 제공된 메모와 함께 항목의 변경 기록에 변경 사항을 기록합니다
- 감사 목적으로 작업 로그 항목을 작성합니다
- 프로젝트의 연결된 Microsoft Teams 채널에 적응형 카드를 게시하거나 업데이트하며, 활동이 AI 생성으로 명확하게 공개됩니다
따라서 AI 기반 변경 사항은 AB Projects 앱이나 Teams 탭에서 직접 수행한 변경 사항과 동일한 가시성 및 추적성을 갖습니다. 어시스턴트를 연결하는 방법은 MCP를 통한 AI 어시스턴트 연결을 참조하십시오.