# Dooray MCP Tools Reference
Dooray MCP Server가 제공하는 32개 도구의 상세 레퍼런스입니다.
> **API 문서**: https://helpdesk.dooray.com/share/pages/9wWo-xwiR66BO5LGshgVTg/2939987647631384419
---
## Task (태스크)
### `dooray_list_tasks`
프로젝트의 태스크 목록을 필터링하여 조회합니다.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `project_id` | string | ✅ | - | 프로젝트 ID |
| `page` | int | - | 0 | 페이지 번호 |
| `size` | int | - | 20 | 페이지 크기 |
| `workflow_class` | string | - | - | 워크플로우 클래스 필터 (예: `working`, `closed`) |
| `to_member_ids` | string | - | - | 담당자 멤버 ID |
| `tag_ids` | string | - | - | 태그 ID 필터 |
| `milestone_ids` | string | - | - | 마일스톤 ID 필터 |
| `due_date` | string | - | - | 마감일 필터 |
| `order` | string | - | `-createdAt` | 정렬 기준 |
### `dooray_get_task`
특정 태스크의 상세 정보를 조회합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `post_id` | string | ✅ | 태스크 ID |
### `dooray_create_task`
새 태스크를 생성합니다.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `project_id` | string | ✅ | - | 프로젝트 ID |
| `subject` | string | ✅ | - | 태스크 제목 |
| `body` | string | - | - | 태스크 본문 (Markdown) |
| `body_mime_type` | string | - | `text/x-markdown` | 본문 MIME 타입 |
| `to_member_ids` | list[string] | - | - | 담당자 멤버 ID 목록 |
| `cc_member_ids` | list[string] | - | - | 참조자 멤버 ID 목록 |
| `milestone_id` | string | - | - | 마일스톤 ID |
| `tag_ids` | list[string] | - | - | 태그 ID 목록 |
| `due_date` | string | - | - | 마감일 |
| `priority` | string | - | - | 우선순위: `none`, `lowest`, `low`, `normal`, `high`, `highest` |
| `parent_post_id` | string | - | - | 상위 태스크 ID (하위 태스크 생성 시) |
### `dooray_update_task`
기존 태스크를 수정합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `post_id` | string | ✅ | 태스크 ID |
| `subject` | string | - | 변경할 제목 |
| `body` | string | - | 변경할 본문 |
| `body_mime_type` | string | - | 본문 MIME 타입 |
| `due_date` | string | - | 변경할 마감일 |
| `priority` | string | - | 변경할 우선순위 |
| `milestone_id` | string | - | 변경할 마일스톤 ID |
### `dooray_set_task_workflow`
태스크의 워크플로우(상태)를 변경합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `post_id` | string | ✅ | 태스크 ID |
| `workflow_id` | string | ✅ | 변경할 워크플로우 ID (`dooray_list_workflows`로 조회) |
### `dooray_set_task_done`
태스크를 완료 상태로 변경합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `post_id` | string | ✅ | 태스크 ID |
---
## Comment (댓글)
### `dooray_list_comments`
태스크의 댓글 목록을 조회합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `post_id` | string | ✅ | 태스크 ID |
### `dooray_add_comment`
태스크에 새 댓글을 추가합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `post_id` | string | ✅ | 태스크 ID |
| `content` | string | ✅ | 댓글 내용 (Markdown) |
### `dooray_update_comment`
기존 댓글을 수정합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `post_id` | string | ✅ | 태스크 ID |
| `log_id` | string | ✅ | 댓글 ID |
| `content` | string | ✅ | 변경할 댓글 내용 |
### `dooray_delete_comment`
댓글을 삭제합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `post_id` | string | ✅ | 태스크 ID |
| `log_id` | string | ✅ | 댓글 ID |
---
## Project (프로젝트)
### `dooray_get_project`
프로젝트의 상세 정보를 조회합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
**반환 정보**: 이름, 코드, 설명, 상태, 범위, 생성일
### `dooray_list_workflows`
프로젝트에서 사용 가능한 워크플로우(상태) 목록을 조회합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
**반환 정보**: 각 워크플로우의 ID, 이름, 클래스, 순서
> 💡 `dooray_set_task_workflow`에서 사용할 `workflow_id`를 이 도구로 먼저 조회하세요.
---
## Milestone (마일스톤)
### `dooray_list_milestones`
프로젝트의 마일스톤 목록을 조회합니다.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `project_id` | string | ✅ | - | 프로젝트 ID |
| `page` | int | - | 0 | 페이지 번호 |
| `size` | int | - | 20 | 페이지 크기 |
| `status` | string | - | - | 상태 필터: `open` 또는 `closed` |
### `dooray_get_milestone`
특정 마일스톤의 상세 정보를 조회합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `milestone_id` | string | ✅ | 마일스톤 ID |
### `dooray_create_milestone`
새 마일스톤을 생성합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `name` | string | ✅ | 마일스톤 이름 |
| `start_at` | string | - | 시작일 |
| `end_at` | string | - | 종료일 |
### `dooray_update_milestone`
기존 마일스톤을 수정합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `milestone_id` | string | ✅ | 마일스톤 ID |
| `name` | string | - | 변경할 이름 |
| `status` | string | - | 변경할 상태: `open` 또는 `closed` |
| `start_at` | string | - | 변경할 시작일 |
| `end_at` | string | - | 변경할 종료일 |
### `dooray_delete_milestone`
마일스톤을 삭제합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `milestone_id` | string | ✅ | 마일스톤 ID |
---
## Tag (태그)
### `dooray_list_tags`
프로젝트의 태그 목록을 조회합니다.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `project_id` | string | ✅ | - | 프로젝트 ID |
| `page` | int | - | 0 | 페이지 번호 |
| `size` | int | - | 20 | 페이지 크기 |
### `dooray_get_tag`
특정 태그의 상세 정보를 조회합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `tag_id` | string | ✅ | 태그 ID |
### `dooray_create_tag`
새 태그를 생성합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `name` | string | ✅ | 태그 이름 |
| `color` | string | - | 태그 색상 |
---
## Template (템플릿)
### `dooray_list_templates`
프로젝트의 포스트 템플릿 목록을 조회합니다.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `project_id` | string | ✅ | - | 프로젝트 ID |
| `page` | int | - | 0 | 페이지 번호 |
| `size` | int | - | 20 | 페이지 크기 |
### `dooray_get_template`
특정 템플릿의 상세 정보를 조회합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `template_id` | string | ✅ | 템플릿 ID |
### `dooray_create_template`
새 포스트 템플릿을 생성합니다.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `project_id` | string | ✅ | - | 프로젝트 ID |
| `name` | string | ✅ | - | 템플릿 이름 |
| `body` | string | ✅ | - | 템플릿 본문 |
| `body_mime_type` | string | - | `text/x-markdown` | 본문 MIME 타입 |
### `dooray_update_template`
기존 템플릿을 수정합니다.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `project_id` | string | ✅ | - | 프로젝트 ID |
| `template_id` | string | ✅ | - | 템플릿 ID |
| `name` | string | - | - | 변경할 이름 |
| `body` | string | - | - | 변경할 본문 |
| `body_mime_type` | string | - | `text/x-markdown` | 본문 MIME 타입 |
### `dooray_delete_template`
템플릿을 삭제합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `template_id` | string | ✅ | 템플릿 ID |
---
## Member (멤버)
### `dooray_search_members`
조직 내 멤버를 검색합니다. 최소 하나의 검색 조건을 입력하세요.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `name` | string | - | - | 이름으로 검색 |
| `user_code` | string | - | - | 사용자 코드로 검색 |
| `external_email` | string | - | - | 외부 이메일로 검색 |
| `page` | int | - | 0 | 페이지 번호 |
| `size` | int | - | 20 | 페이지 크기 |
### `dooray_list_project_members`
프로젝트의 멤버 목록을 조회합니다.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `project_id` | string | ✅ | - | 프로젝트 ID |
| `page` | int | - | 0 | 페이지 번호 |
| `size` | int | - | 20 | 페이지 크기 |
### `dooray_get_project_member`
프로젝트 멤버의 상세 정보를 조회합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | ✅ | 프로젝트 ID |
| `member_id` | string | ✅ | 멤버 ID |
### `dooray_add_project_member`
프로젝트에 멤버를 추가합니다.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `project_id` | string | ✅ | - | 프로젝트 ID |
| `member_id` | string | ✅ | - | 추가할 멤버 ID |
| `role` | string | - | `member` | 역할 |
---
## Messenger (메신저)
### `dooray_list_channels`
사용 가능한 메신저 채널 목록을 조회합니다.
파라미터 없음.
### `dooray_create_channel`
새 메신저 채널을 생성합니다.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `title` | string | ✅ | - | 채널 이름 |
| `member_ids` | list[string] | ✅ | - | 초기 멤버 ID 목록 |
| `channel_type` | string | - | `private` | 채널 타입: `private` 또는 `public` |
| `capacity` | int | - | - | 채널 최대 인원 |
### `dooray_send_channel_message`
채널에 메시지를 전송합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | ✅ | 채널 ID |
| `content` | string | ✅ | 메시지 내용 |
### `dooray_send_direct_message`
특정 멤버에게 다이렉트 메시지를 전송합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `member_id` | string | ✅ | 수신자 멤버 ID |
| `content` | string | ✅ | 메시지 내용 |
### `dooray_join_channel_members`
채널에 멤버를 추가합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | ✅ | 채널 ID |
| `member_ids` | list[string] | ✅ | 추가할 멤버 ID 목록 |
### `dooray_leave_channel_members`
채널에서 멤버를 제거합니다.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | ✅ | 채널 ID |
| `member_ids` | list[string] | ✅ | 제거할 멤버 ID 목록 |
---
## CLI Reference
모든 MCP Tool은 CLI로도 사용할 수 있습니다.
```bash
# 도움말
dooray --help
dooray task --help
dooray messenger --help
# 예시
dooray task list --project-id PROJECT_ID
dooray task create --project-id PROJECT_ID --subject "Bug fix" --priority high
dooray member search --name "홍길동"
dooray messenger dm --member-id MEMBER_ID --content "안녕하세요"
```
