플레인 MCP 서버

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

특징

• Plane 작업 공간의 모든 프로젝트 나열

• 특정 프로젝트에 대한 자세한 정보를 얻으세요

• 사용자 정의 가능한 속성으로 새로운 문제 만들기

• 프로젝트의 문제 나열 및 필터링

• 특정 문제에 대한 자세한 정보를 얻으세요

• 기존 문제를 새로운 정보로 업데이트하세요

Related MCP server: Plane MCP Server

필수 조건

• 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: 수동 설정

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

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

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

2. 종속성 설치:

npm install

3. 서버를 빌드하세요:

npm run build

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 서버 구성을 추가합니다.

{
  "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"
      }
    }
  }
}

3. 데스크톱용 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>"
}

개발

1. 개발 종속성 설치:

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

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

npm run dev

테스트

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

npx @modelcontextprotocol/inspector node dist/index.js

예시

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. 자세한 재생산 단계를 담은 새로운 이슈를 열어보세요

스타 역사