Plane MCP Server

플레인 MCP 서버

Plane MCP 서버는 Plane에 MCP(Model Context Protocol)의 기능을 제공하여 AI 에이전트와 개발자 도구가 Plane 작업 공간과 프로그래밍 방식으로 상호 작용할 수 있도록 합니다.

지능형 어시스턴트, 자동화 스크립트 또는 워크플로 기반 도구를 개발하는 경우 이 서버는 Plane API에 원활하게 연결됩니다. 이를 통해 프로젝트를 만들고, 문제를 관리하고, 작업을 할당하고, AI 기반 도구와 작업을 동기화할 수 있습니다.

무엇을 할 수 있나요?

이 서버는 Plane을 사용하는 모든 사람에게 다양한 유용한 기능을 제공합니다.

• AI 또는 앱 인터페이스에서 직접 프로젝트와 작업 항목을 시작합니다.
• 진행 상황 업데이트, 팀원 배정, 속성 설정 또는 주석 추가 등을 모두 프로그래밍 방식으로 수행할 수 있습니다.
• 워크플로를 통해 문제를 이동하고 상태를 즉시 업데이트합니다.
• 라벨, 모듈, 주기를 사용하여 작업을 구성합니다.
• 여러 프로젝트에서 팀의 작업에 대한 데이터를 분석합니다.
• Plane과 자연스럽게 상호작용하는 스마트한 앱을 만들어 보세요. AI 에이전트가 작업을 기록하든, 봇이 프로젝트를 깔끔하게 유지하든 상관없습니다.

도구

사용자

• get_user
  • 현재 사용자의 정보를 가져옵니다
  • 매개변수가 필요하지 않습니다

프로젝트

• get_projects
  • 현재 사용자의 모든 프로젝트 가져오기
  • 매개변수가 필요하지 않습니다
• create_project
  • 새 프로젝트를 만듭니다
  • 매개변수:
    • name (문자열, 필수): 프로젝트 이름

문제 유형

• list_issue_types
  • 특정 프로젝트에 대한 모든 문제 유형을 가져옵니다.
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
• get_issue_type
  • 특정 문제 유형에 대한 세부 정보 가져오기
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • type_id (문자열, 필수): 문제 유형의 UUID
• create_issue_type
  • 프로젝트에서 새로운 이슈 유형을 만듭니다.
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • issue_type_data : 다음을 포함하는 개체:
      • name (문자열, 필수): 이슈 유형의 이름
      • description (문자열, 필수): 문제 유형에 대한 설명
• update_issue_type
  • 기존 문제 유형 업데이트
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • type_id (문자열, 필수): 문제 유형의 UUID
    • issue_type_data (객체): 이슈 유형에 대해 업데이트할 필드
• delete_issue_type
  • 문제 유형 삭제
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • type_id (문자열, 필수): 문제 유형의 UUID

주

• list_states
  • 특정 프로젝트의 모든 상태 가져오기
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
• get_state
  • 특정 주에 대한 세부 정보를 얻으세요
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • state_id (문자열, 필수): 주의 UUID
• create_state
  • 프로젝트에서 새 상태 만들기
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • state_data : 다음을 포함하는 객체:
      • name (문자열, 필수): 주 이름
      • color (문자열, 필수): 상태에 대한 색상 코드
• update_state
  • 기존 상태 업데이트
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • state_id (문자열, 필수): 주의 UUID
    • state_data (객체): 상태를 업데이트할 필드
• delete_state
  • 상태 삭제
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • state_id (문자열, 필수): 주의 UUID

라벨

• list_labels
  • 특정 프로젝트에 대한 모든 라벨 가져오기
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
• get_label
  • 특정 라벨의 세부 정보 가져오기
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • label_id (문자열, 필수): 레이블의 UUID
• create_label
  • 프로젝트에서 새 라벨 만들기
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • label_data : 다음을 포함하는 객체:
      • name (문자열, 필수): 레이블의 이름
      • color (문자열, 필수): 레이블의 색상 코드
• update_label
  • 기존 라벨 업데이트
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • label_id (문자열, 필수): 레이블의 UUID
    • label_data (객체): 레이블에 업데이트할 필드
• delete_label
  • 라벨 삭제
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • label_id (문자열, 필수): 레이블의 UUID

문제

• get_issue_using_readable_identifier
  • 읽을 수 있는 식별자(예: PROJ-123)를 사용하여 문제 세부 정보를 가져옵니다.
  • 매개변수:
    • project_identifier (문자열, 필수)
    • issue_identifier (문자열, 필수): 이슈 번호: 프로젝트 식별자(예: "PROJ") r(예: "123")
• get_issue_comments
  • 특정 문제에 대한 모든 의견을 얻으세요
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • issue_id (문자열, 필수): 문제의 UUID
• add_issue_comment
  • 문제에 대한 의견을 추가하세요
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • issue_id (문자열, 필수): 문제의 UUID
    • comment_html (문자열, 필수): 댓글의 HTML 콘텐츠
• create_issue
  • 새로운 이슈를 생성하세요
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • issue_data : 다음을 포함하는 객체:
    • name (문자열, 필수): 이슈 제목
    • description_html (문자열, 필수): 문제에 대한 HTML 설명
• update_issue
  • 기존 문제 업데이트
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • issue_id (문자열, 필수): 문제의 UUID
    • issue_data (객체): 이슈에 대해 업데이트할 필드

모듈

• list_modules
  • 특정 프로젝트에 대한 모든 모듈 가져오기
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
• get_module
  • 특정 모듈의 세부 정보 가져오기
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • module_id (문자열, 필수): 모듈의 UUID
• create_module
  • 프로젝트에서 새 모듈을 만듭니다
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • module_data : 다음을 포함하는 객체:
      • name (문자열, 필수): 모듈의 이름
• update_module
  • 기존 모듈 업데이트
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • module_id (문자열, 필수): 모듈의 UUID
    • module_data (객체): 모듈에서 업데이트할 필드
• delete_module
  • 모듈 삭제
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • module_id (문자열, 필수): 모듈의 UUID

모듈 문제

• list_module_issues
  • 특정 모듈에 대한 모든 문제를 가져옵니다.
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • module_id (문자열, 필수): 모듈의 UUID
• add_module_issues
  • 모듈에 문제 추가
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • module_id (문자열, 필수): 모듈의 UUID
    • issues (문자열[], 필수): 추가할 문제 UUID 배열
• delete_module_issue
  • 모듈에서 문제 제거
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • module_id (문자열, 필수): 모듈의 UUID
    • issue_id (문자열, 필수): 제거할 문제의 UUID

사이클

• list_cycles
  • 특정 프로젝트의 모든 사이클을 가져옵니다.
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
• get_cycle
  • 특정 사이클의 세부 정보를 얻으세요
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • cycle_id (문자열, 필수): 사이클의 UUID
• create_cycle
  • 프로젝트에서 새로운 사이클을 만듭니다
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • cycle_data : 다음을 포함하는 객체:
    • name (문자열, 필수): 사이클의 이름
    • start_date (문자열, 필수): 시작 날짜(YYYY-MM-DD)
    • end_date (문자열, 필수) : 종료 날짜(YYYY-MM-DD)
• update_cycle
  • 기존 사이클 업데이트
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • cycle_id (문자열, 필수): 사이클의 UUID
    • cycle_data (객체): 사이클에서 업데이트할 필드
• delete_cycle
  • 사이클 삭제
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • cycle_id (문자열, 필수): 사이클의 UUID

사이클 문제

• list_cycle_issues
  • 특정 주기에 대한 모든 문제를 가져옵니다.
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • cycle_id (문자열, 필수): 사이클의 UUID
• add_cycle_issues
  • 사이클에 문제 추가
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • cycle_id (문자열, 필수): 사이클의 UUID
    • issues (문자열[], 필수): 추가할 문제 UUID 배열
• delete_cycle_issue
  • 사이클에서 문제 제거
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • cycle_id (문자열, 필수): 사이클의 UUID
    • issue_id (문자열, 필수): 제거할 문제의 UUID

작업 로그

• get_issue_worklogs
  • 특정 문제에 대한 모든 작업 로그 가져오기
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • issue_id (문자열, 필수): 문제의 UUID
• get_total_worklogs
  • 프로젝트에 대한 총 기록 시간 가져오기
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
• create_worklog
  • 이슈에 대한 새로운 작업 로그를 만듭니다.
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • issue_id (문자열, 필수): 문제의 UUID
    • worklog_data : 다음을 포함하는 개체:
      • description (문자열, 필수): 수행된 작업에 대한 설명
      • duration (정수, 필수): 지속 시간(분)
• update_worklog
  • 기존 작업 로그 업데이트
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • issue_id (문자열, 필수): 문제의 UUID
    • worklog_id (문자열, 필수): 작업 로그의 UUID
    • worklog_data (객체): 작업 로그에 업데이트할 필드
• delete_worklog
  • 작업 로그 삭제
  • 매개변수:
    • project_id (문자열, 필수): 프로젝트의 UUID
    • issue_id (문자열, 필수): 문제의 UUID
    • worklog_id (문자열, 필수): 작업 로그의 UUID

구성 매개변수

• PLANE_API_KEY - Plane API 토큰입니다. Plane 앱의 Workspace Settings > API Tokens 페이지( /settings/api-tokens/ )에서 생성할 수 있습니다.
• PLANE_WORKSPACE_SLUG - Plane 인스턴스의 작업 공간 슬러그입니다. 작업 공간 슬러그는 Plane의 작업 공간에 대한 고유 작업 공간 식별자를 나타내며, URL에서 찾을 수 있습니다.
• PLANE_API_HOST_URL (선택 사항) - Plane API 서버의 호스트 URL입니다. 기본값은 https://api.plane.so/ 입니다.

용법

클로드 데스크탑

claude_desktop_config.json 업데이트하여 Claude Desktop 에 Plane을 추가할 수 있습니다.

지엑스피1

VS코드

.vscode.json 또는 mcp.json 파일을 편집하여 Plane을 VSCode 에 연결할 수도 있습니다.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.