# 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

# 선택: 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

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

# .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": "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"
}