플레인 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

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

npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client cursor

옵션 2: 수동 설정

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

이 저장소를 복제하세요:

git clone https://github.com/kelvin6365/plane-mcp-server.git
cd plane-mcp-server

종속성 설치:

npm install

서버를 빌드하세요:

npm run build

Claude for Desktop 사용

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

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

{
  "mcpServers": {
    "plane": {
      "command": "node",
      "args": ["path/to/plane-mcp-server/build/index.js"],
      "env": {
        "PLANE_API_KEY": "your_plane_api_key_here",
        "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
      }
    }
  }
}

데스크톱용 Claude 재시작

사용 가능한 도구

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

프로젝트 목록

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

매개변수: 없음

예:

{}

get-project

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

매개변수:

project_id : 검색할 프로젝트의 ID

예:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef"
}

이슈 생성

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

매개변수:

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

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

예:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "name": "Implement new feature",
  "description_html": "<p>We need to implement the new reporting feature</p>",
  "priority": "high",
  "assignees": ["user-id-1", "user-id-2"]
}

목록 문제

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

매개변수:

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

예:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "priority": "high",
  "limit": 10
}

get-issue

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

매개변수:

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

예:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "issue_id": "01def456-7890-12gh-3456-789ijklmnopq"
}

업데이트-문제

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

매개변수:

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

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

예:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "issue_id": "01def456-7890-12gh-3456-789ijklmnopq",
  "priority": "urgent",
  "description_html": "<p>Updated description with <strong>more details</strong></p>"
}

개발

개발 종속성 설치:

npm install --save-dev typescript @types/node

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

npm run dev

테스트

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

npx @modelcontextprotocol/inspector node dist/index.js

예시

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

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

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

보안 고려 사항

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

기여하다

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

특허

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

지원하다

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

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

Plane MCP Server

Integrations