tallpizza/dooray-mcp

# 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)"

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

# 종속성 설치
uv sync

# .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

LOG_LEVEL=INFO

# 환경 변수를 포함한 완전한 설정
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"
  }
}'

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

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

# MCP 서버 목록 확인
claude mcp list

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

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

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

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

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

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

// 새 태그 생성
{
  "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": "완료"
}

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

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

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

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

// 업무 파일 콘텐츠 다운로드 (base64 인코딩)
{
  "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"
}