Skip to main content
Glama
Dooray MCP Server

Dooray MCP Server

by tallpizza

Dooray MCP Server

Dooray API를 Claude Code와 연동하기 위한 MCP (Model Context Protocol) 서버입니다.

기능

이 MCP 서버는 Dooray의 주요 기능을 6개의 통합 도구로 제공합니다:

  1. dooray_tasks - 업무 관리 (목록 조회, 상세 조회, 생성, 수정, 삭제, 상태 변경, 담당자 지정)

  2. dooray_comments - 댓글 관리 (목록 조회, 생성, 수정, 삭제, 멘션 지원)

  3. dooray_tags - 태그 관리 (목록 조회, 생성, 업무에 태그 추가/제거)

  4. dooray_search - 검색 기능 (업무 검색, 담당자별/상태별/태그별/기간별 검색)

  5. dooray_members - 사용자 관리 (이메일/ID 검색, 사용자 정보 조회, 프로젝트 멤버 목록)

  6. dooray_files - 파일 및 이미지 관리 (업무 파일 업로드/목록, S3 본문 이미지 업로드, 파일 메타데이터, 파일 콘텐츠 다운로드, Content ID로 직접 접근)

Related MCP server: ZenTao MCP Server

CLI (dooray)

토큰은 계정 단위이므로 한 번만 저장하면 모든 프로젝트에서 같은 계정 권한으로 쓸 수 있습니다.

uv tool install --editable .   # 어디서나 `dooray` 실행
dooray login                   # 토큰을 ~/.config/dooray/credentials (권한 600)에 저장
dooray whoami
dooray tasks list --projectId <id> --size 20
dooray comments create --taskId <id> --content "내용"
dooray tasks create --json '{"subject": "제목", "body": "내용"}'

환경 변수 DOORAY_API_TOKEN이 있으면 저장된 값보다 우선합니다. MCP 서버도 같은 저장 값을 읽으므로 claude mcp add -s user로 한 번만 등록하면 됩니다.

빠른 설치

GitHub에서 자동 설치

# 1. 저장소 클론
git clone https://github.com/tallpizza/dooray-mcp.git
cd dooray-mcp

# 2. 자동 설치 스크립트 실행
./install.sh

# 3. 환경 변수 설정 (.env 파일 수정)
# DOORAY_API_TOKEN과 DOORAY_DEFAULT_PROJECT_ID를 실제 값으로 변경

# 4. Claude Code에 추가
claude mcp add-json dooray "$(cat .mcp.json | jq -c .dooray)"

상세 설치 및 설정

1. GitHub에서 설치

# GitHub에서 프로젝트 클론
git clone https://github.com/tallpizza/dooray-mcp.git
cd dooray-mcp

# 종속성 설치
uv sync

2. 환경 변수 설정

.env 파일을 생성하고 다음 내용을 설정합니다:

# .env.example을 복사
cp .env.example .env

# .env 파일 내용
DOORAY_API_TOKEN=your-actual-dooray-api-token
DOORAY_BASE_URL=https://api.dooray.com
DOORAY_DEFAULT_PROJECT_ID=your-default-project-id

# 선택: Dooray 본문 이미지용 S3-compatible 스토리지 (upload_body_image 사용 시)
S3_BUCKET=your-public-image-bucket
S3_REGION=ap-northeast-2
S3_ACCESS_KEY_ID=your-s3-access-key
S3_SECRET_ACCESS_KEY=your-s3-secret-key

LOG_LEVEL=INFO

3. Claude Code MCP 서버 추가

방법 1: JSON으로 추가 (권장)

# 환경 변수를 포함한 완전한 설정
claude mcp add-json dooray '{
  "type": "stdio",
  "command": "uv",
  "args": ["run", "python", "-m", "dooray_mcp.server"],
  "env": {
    "DOORAY_API_TOKEN": "your-actual-dooray-api-token",
    "DOORAY_BASE_URL": "https://api.dooray.com",
    "DOORAY_DEFAULT_PROJECT_ID": "your-default-project-id",
    "S3_BUCKET": "your-public-image-bucket",
    "S3_REGION": "ap-northeast-2",
    "S3_ACCESS_KEY_ID": "your-s3-access-key",
    "S3_SECRET_ACCESS_KEY": "your-s3-secret-key"
  }
}'

방법 2: 설정 파일 사용

# .mcp.json 설정 파일 준비
cp .mcp.json.example .mcp.json
# 환경 변수를 실제 값으로 수정

# Claude Code에서 사용
claude --mcp-config .mcp.json

4. 연결 확인

# MCP 서버 목록 확인
claude mcp list

# Dooray 서버가 ✓ Connected로 표시되는지 확인

5. 도구 테스트

# 업무 목록 조회 테스트
claude --print "dooray_tasks를 사용해서 업무 목록을 조회해주세요."

# 댓글 생성 테스트
claude --print "dooray_comments를 사용해서 댓글을 생성해주세요."

사용법

도구별 사용 예제

1. dooray_tasks (업무 관리)

// 업무 목록 조회
{
  "action": "list",
  "projectId": "project-123"  // 선택사항 (환경 변수 사용 가능)
}

// 업무 생성
{
  "action": "create",
  "projectId": "project-123",
  "title": "새 업무",
  "description": "업무 설명",
  "priority": "normal"
}

2. dooray_comments (댓글 관리)

// 댓글 생성 (멘션 포함)
{
  "action": "create",
  "taskId": "task-456",
  "content": "댓글 내용",
  "mentions": ["user1", "user2"]  // 선택사항
}

3. dooray_tags (태그 관리)

// 새 태그 생성
{
  "action": "create",
  "projectId": "project-123",
  "tagName": "긴급",
  "tagColor": "#FF0000"  // # 포함 가능, 자동으로 제거됨
}

// 업무에 태그 추가
{
  "action": "add_to_task",
  "taskId": "task-456",
  "tagName": "긴급"
}
// 업무 텍스트 검색
{
  "searchType": "tasks",
  "projectId": "project-123",
  "query": "버그 수정"
}

// 상태별 검색
{
  "searchType": "by_status",
  "projectId": "project-123",
  "status": "완료"
}

5. dooray_members (사용자 관리)

// 이메일로 사용자 검색
{
  "action": "search_by_email",
  "email": "user@company.com"
}

// 프로젝트 멤버 목록
{
  "action": "list_project_members",
  "projectId": "project-123"
}

6. dooray_files (파일 및 이미지 관리)

// 업무 파일 업로드
{
  "action": "upload_task_file",
  "taskId": "task-456",
  "filePath": "/path/to/image.png",
  "filename": "image.png",    // 선택사항
  "mimeType": "image/png",    // 선택사항 (미지정 시 확장자로 추정)
  "projectId": "project-123"  // 선택사항 (환경 변수 사용 가능)
}

// 응답에는 result.id와 함께 result.fileId, result.metadataApiUrl, result.downloadApiUrl이 포함됩니다.
// 주의: downloadApiUrl/rawUrl은 Authorization 헤더가 필요한 API URL입니다.
// Dooray 본문/댓글에 이미지 URL로 붙여 넣으면 표시되지 않습니다. 업로드만으로 업무 첨부파일에는 등록됩니다.

// Dooray 본문/댓글에 사용할 이미지 URL 생성 (S3 업로드)
{
  "action": "upload_body_image",
  "filePath": "/path/to/image.png",
  "filename": "image.png",        // 선택사항
  "mimeType": "image/png",        // 선택사항
  "altText": "스크린샷",          // 선택사항
  "s3Key": "dooray/image.png"     // 선택사항 (미지정 시 자동 생성)
}

// 응답의 markdown 값을 업무/댓글 본문에 넣으면 됩니다.
// 예: ![스크린샷](https://your-public-image-bucket.s3.ap-northeast-2.amazonaws.com/dooray-images/2026/05/18/....png)
// S3 객체는 Dooray 사용자가 인증 없이 접근 가능해야 합니다.

// 업무 파일 목록 조회
{
  "action": "list_task_files",
  "taskId": "task-456",
  "projectId": "project-123"  // 선택사항 (환경 변수 사용 가능)
}

// 업무 파일 메타데이터 조회
{
  "action": "get_task_file_metadata",
  "taskId": "task-456",
  "fileId": "file-789",
  "projectId": "project-123"
}

// 업무 파일 콘텐츠 다운로드 (임시 파일로 저장)
{
  "action": "get_task_file_content",
  "taskId": "task-456",
  "fileId": "file-789",
  "projectId": "project-123"
}

// Content ID로 직접 파일 메타데이터 조회 (Drive API)
{
  "action": "get_drive_file_metadata",
  "fileId": "content-id-xyz"
}

// Content ID로 직접 파일 콘텐츠 다운로드 (Drive API, 임시 파일로 저장)
{
  "action": "get_drive_file_content",
  "fileId": "content-id-xyz"
}

S3 이미지 URL 설정

upload_body_image에 필요한 최소 S3 환경변수는 아래 4개입니다.

  • S3_BUCKET

  • S3_REGION

  • S3_ACCESS_KEY_ID

  • S3_SECRET_ACCESS_KEY

나머지는 기본값을 사용합니다.

  • S3_PREFIX: dooray-images

  • S3_ACL: public-read (S3_ACL=none이면 ACL 전송 안 함)

  • S3_PUBLIC_BASE_URL: 미설정 시 S3 공개 URL 자동 생성

  • S3_ENDPOINT_URL: 미설정 시 AWS S3 기본 endpoint 사용

  • S3_FORCE_PATH_STYLE: endpoint URL을 쓰면 기본 true, 아니면 false

API 정보

  • Base URL: https://api.dooray.com

  • 인증: Authorization: dooray-api {TOKEN}

  • 업무 관리: /project/v1/projects/{projectId}/posts

  • 댓글 관리: /project/v1/projects/{projectId}/posts/{taskId}/logs

  • 태그 관리: /project/v1/projects/{projectId}/tags

  • 사용자 관리: /common/v1/members

  • 파일 관리: /project/v1/projects/{projectId}/posts/{taskId}/files

  • Drive 파일: /drive/v1/files/{fileId}

문제 해결

연결 문제

  1. 인증 오류: DOORAY_API_TOKEN이 올바른지 확인

  2. 프로젝트 ID 오류: DOORAY_DEFAULT_PROJECT_ID가 존재하는 프로젝트인지 확인

  3. 권한 오류: API 토큰이 해당 프로젝트에 대한 권한을 가지고 있는지 확인

MCP 연결 문제

  1. 서버 연결 실패: claude mcp list에서 상태 확인

  2. 도구 인식 실패: MCP 서버 재시작 또는 Claude Code 재시작

  3. 권한 문제: --dangerously-skip-permissions 플래그 사용 (개발 환경에서만)

개발 및 기여

이 프로젝트는 MIT 라이센스 하에 배포되며, 버그 리포트와 기능 요청을 환영합니다.

버전 정보

  • 버전: 1.0.0

  • Python: 3.8+

  • MCP: 1.0.0+

  • HTTP 클라이언트: httpx 0.25.0+

Available Tools

7 tools
dooray_commentsC

Manage Dooray task comments - get list, create, update, delete comments with mention support

Inputs: action (required), taskId (required), commentId, content, +1 more.

dooray_filesC

Manage Dooray files and images - list task files, get file metadata, download file content from tasks or directly by content ID

Inputs: action (required), taskId, fileId, projectId.

dooray_membersC

Manage Dooray members - search by email/ID, get member details, check project membership

Inputs: action (required), email, userId, projectId.

dooray_tagsC

Manage Dooray tags - list available tags, create new tags, add/remove tags from tasks

Inputs: action (required), taskId, tagName, tagColor, +1 more.

dooray_tasksC

Manage Dooray tasks - list, get details, create, update, delete, change status, assign members

Inputs: action (required), taskId, title, description, +4 more.

dooray_workflowsC

Manage Dooray workflows - list project workflows, get workflow details, create, update, delete workflows

Inputs: action (required), workflowId, name, projectId.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting a specific Dooray resource: comments, files, members, search, tags, tasks, and workflows. There is no overlap in functionality, and an agent can easily distinguish between them based on their resource focus.

    Naming Consistency5/5

    All tools follow a consistent 'dooray_' prefix with a descriptive noun (e.g., dooray_comments, dooray_tasks). This uniform snake_case naming pattern makes the tool set predictable and easy to navigate.

    Tool Count5/5

    With 7 tools, the server is well-scoped for managing Dooray project resources. Each tool covers a distinct aspect of the platform (e.g., tasks, members, workflows), and none feel redundant or missing for the domain.

    Completeness5/5

    The tool set provides comprehensive coverage of Dooray's core project management features, including CRUD operations for tasks, workflows, tags, comments, and files, plus search and member management. There are no obvious gaps for the stated purpose.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to interact with ClickUp's task management API for core project workflows, supporting operations like task creation, updates, search, assignment, and team analytics through natural language.
      28
      5
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      Enables interaction with Dooray's task and calendar management system, allowing users to filter and list tasks, retrieve details, and manage task comments. It provides a set of tools for seamless integration with MCP-compatible clients like Claude Desktop and Cursor.
      6
      -