Provides comprehensive file and image management capabilities including listing task files, retrieving file metadata, downloading file content in base64 encoding, and direct file access through Content IDs via Drive API.
Dooray MCP Server
Dooray API를 Claude Code와 연동하기 위한 MCP (Model Context Protocol) 서버입니다.
기능
이 MCP 서버는 Dooray의 주요 기능을 6개의 통합 도구로 제공합니다:
dooray_tasks - 업무 관리 (목록 조회, 상세 조회, 생성, 수정, 삭제, 상태 변경, 담당자 지정)
dooray_comments - 댓글 관리 (목록 조회, 생성, 수정, 삭제, 멘션 지원)
dooray_tags - 태그 관리 (목록 조회, 생성, 업무에 태그 추가/제거)
dooray_search - 검색 기능 (업무 검색, 담당자별/상태별/태그별/기간별 검색)
dooray_members - 사용자 관리 (이메일/ID 검색, 사용자 정보 조회, 프로젝트 멤버 목록)
dooray_files - 파일 및 이미지 관리 (업무 파일 목록, 파일 메타데이터, 파일 콘텐츠 다운로드, Content ID로 직접 접근)
빠른 설치
GitHub에서 자동 설치
상세 설치 및 설정
1. GitHub에서 설치
2. 환경 변수 설정
.env
파일을 생성하고 다음 내용을 설정합니다:
3. Claude Code MCP 서버 추가
방법 1: JSON으로 추가 (권장)
방법 2: 설정 파일 사용
4. 연결 확인
5. 도구 테스트
사용법
도구별 사용 예제
1. dooray_tasks (업무 관리)
2. dooray_comments (댓글 관리)
3. dooray_tags (태그 관리)
4. dooray_search (검색 기능)
5. dooray_members (사용자 관리)
6. dooray_files (파일 및 이미지 관리)
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}
문제 해결
연결 문제
인증 오류:
DOORAY_API_TOKEN
이 올바른지 확인프로젝트 ID 오류:
DOORAY_DEFAULT_PROJECT_ID
가 존재하는 프로젝트인지 확인권한 오류: API 토큰이 해당 프로젝트에 대한 권한을 가지고 있는지 확인
MCP 연결 문제
서버 연결 실패:
claude mcp list
에서 상태 확인도구 인식 실패: MCP 서버 재시작 또는 Claude Code 재시작
권한 문제:
--dangerously-skip-permissions
플래그 사용 (개발 환경에서만)
개발 및 기여
이 프로젝트는 MIT 라이센스 하에 배포되며, 버그 리포트와 기능 요청을 환영합니다.
버전 정보
버전: 1.0.0
Python: 3.8+
MCP: 1.0.0+
HTTP 클라이언트: httpx 0.25.0+
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables integration with Dooray API for comprehensive project management including task operations, comment management, tag organization, search functionality, and user management. Supports task creation, modification, status updates, assignee management, and collaborative features through natural language interactions.
Related MCP Servers
- AsecurityAlicenseAqualityProvides API access to a locally-hosted task management system with features for creating, updating, and organizing tasks, including support for urgency levels, effort estimates, subtasks, and bi-directional sync with Obsidian markdown files.Last updated -129MIT License
- AsecurityFlicenseAqualityProvides tools for AI assistants to interact with the Dida365 (TickTick) task management API, allowing management of tasks and projects after user authorization.Last updated -531
- -securityAlicense-qualityA server that enables management of schedules through the Dooray API, allowing users to add events with automated time settings and support for location and description information.Last updated -1MIT License
- AsecurityAlicenseAqualityEnables 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.Last updated -283MIT License