Plane MCP Server

플레인 MCP 서버

LLM이 Plane.so 와 상호 작용하여 Plane API를 통해 프로젝트와 이슈를 관리할 수 있도록 지원하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 사용하면 Claude와 같은 LLM이 사용자 제어 및 보안을 유지하면서 프로젝트 관리 워크플로와 직접 상호 작용할 수 있습니다.

특징

• Plane 작업 공간의 모든 프로젝트 나열
• 특정 프로젝트에 대한 자세한 정보를 얻으세요
• 사용자 정의 가능한 속성으로 새로운 문제 만들기
• 프로젝트의 문제 나열 및 필터링
• 특정 문제에 대한 자세한 정보를 얻으세요
• 기존 문제를 새로운 정보로 업데이트하세요

필수 조건

• Node.js 22.x 이상
• Plane.so API 키
• Plane.so 작업 공간

설치

옵션 1: 대장간 사용

시작하는 가장 빠른 방법은 Smithery를 사용하여 서버를 직접 설치하는 것입니다.

지엑스피1

이 명령은 Claude와 함께 사용할 Plane MCP 서버를 자동으로 설정합니다. 설치 후 Claude 설정에서 Plane API 키와 작업 공간 슬러그를 사용하여 서버를 구성해야 합니다.

유효한 클라이언트 옵션은 다음과 같습니다: claude, cline, windsurf, roo-cline, witsy, enconvo, cursor

커서를 사용하여 설치하는 예:

옵션 2: 수동 설정

서버를 수동으로 설정하려면 다음 단계를 따르세요.

1. 이 저장소를 복제하세요:

2. 종속성 설치:

3. 서버를 빌드하세요:

Claude for Desktop 사용

참고: 위의 옵션 1(Smithery)을 사용하셨다면 이 섹션을 건너뛸 수 있습니다. Smithery가 자동으로 MCP 서버를 구성해 드립니다.

1. Claude for Desktop 구성 파일을 엽니다.
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Plane MCP 서버 구성을 추가합니다.

3. 데스크톱용 Claude 재시작

사용 가능한 도구

참고: 도구 이름은 밑줄이 아닌 하이픈(예: list-projects )을 사용합니다. 서버는 호환성을 위해 밑줄을 하이픈으로 자동 변환합니다.

프로젝트 목록

Plane 작업 공간에 있는 모든 프로젝트를 나열합니다.

매개변수: 없음

예:

get-project

특정 프로젝트에 대한 자세한 정보를 얻습니다.

매개변수:

• project_id : 검색할 프로젝트의 ID

예:

이슈 생성

지정된 프로젝트에서 새로운 이슈를 생성합니다.

매개변수:

• project_id : 이슈가 생성되어야 하는 프로젝트의 ID
• name : 이슈 제목
• description_html : 문제에 대한 HTML 설명(Plane API에 필요함)
• priority (선택 사항): 문제의 우선순위("긴급", "높음", "보통", "낮음", "없음")
• state_id (선택 사항): 이 문제에 대한 상태 ID
• assignees (선택 사항): 이 문제에 할당할 사용자 ID 배열

참고: assignees 매개변수는 사용자 ID 문자열 배열이어야 합니다. 일반적인 오류로는 배열 대신 사전/객체를 제공하거나, assignees 필드에 전체 이슈 데이터를 실수로 중첩하는 경우가 있습니다. 서버는 이러한 경우를 처리하려고 시도하지만, 올바른 형식을 사용하는 것이 가장 좋습니다.

예:

목록 문제

선택적 필터링을 사용하여 지정된 프로젝트의 문제를 나열합니다.

매개변수:

• project_id : 이슈를 가져올 프로젝트의 ID
• state_id (선택 사항): 주 ID로 필터링
• priority (선택 사항): 우선순위별 필터링
• assignee_id (선택 사항): 담당자 ID로 필터링
• limit (선택 사항): 반환할 최대 문제 수(기본값: 50)

예:

get-issue

특정 문제에 대한 자세한 정보를 얻습니다.

매개변수:

• project_id : 문제가 포함된 프로젝트의 ID
• issue_id : 검색할 이슈의 ID

예:

업데이트-문제

프로젝트의 기존 이슈를 업데이트합니다.

매개변수:

• project_id : 문제가 포함된 프로젝트의 ID
• issue_id : 업데이트할 이슈의 ID
• name (선택 사항): 이슈의 업데이트된 제목
• description_html (선택 사항): 문제에 대한 HTML 설명(Plane API에 필요함)
• priority (선택 사항): 문제의 업데이트된 우선순위
• state_id (선택 사항): 문제의 업데이트된 상태 ID
• assignees (선택 사항): 이 문제에 할당할 사용자 ID 배열이 업데이트되었습니다.

참고: assignees 매개변수는 create-issue 도구와 동일한 형식 지침을 따르는 사용자 ID 문자열 배열이어야 합니다.

예:

개발

1. 개발 종속성 설치:

2. 개발 모드로 서버를 시작합니다.

테스트

MCP Inspector를 사용하여 서버를 테스트할 수 있습니다.

예시

Plane MCP 서버를 설정한 후 Claude와 시도할 수 있는 몇 가지 상호작용 예시는 다음과 같습니다.

1. "Plane 작업 공간에 있는 모든 프로젝트를 나열해 주시겠어요?"
2. "마케팅 프로젝트에서 '소셜 미디어 전략 업데이트'라는 제목으로 우선순위가 높은 새 이슈를 생성해 주세요."
3. "개발 프로젝트에서 가장 우선 순위가 높은 문제는 무엇입니까?"
4. "QA 프로젝트의 문제 #123을 업데이트하여 우선순위를 긴급으로 변경합니다."

클로드는 문제를 만들거나 수정하기 전에 귀하의 승인을 요청하면서 Plane과 상호 작용하기 위해 적절한 도구를 사용합니다.

보안 고려 사항

• API 키는 작동하려면 적절한 Plane 권한이 필요합니다.
• 데이터를 수정하는 모든 작업에는 명시적인 사용자 승인이 필요합니다.
• 환경 변수는 적절하게 보호되어야 합니다.
• API 키는 버전 제어에 커밋되어서는 안 됩니다.

기여하다

1. 저장소를 포크하세요
2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
4. 브랜치에 푸시( git push origin feature/amazing-feature )
5. 풀 리퀘스트 열기

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

지원하다

문제가 발생하거나 질문이 있는 경우:

1. GitHub 문제 섹션을 확인하세요
2. modelcontextprotocol.io 에서 MCP 설명서를 참조하세요.
3. 자세한 재생산 단계를 담은 새로운 이슈를 열어보세요

스타 역사