⚠️ 개인 저장소 공지 ⚠️

이 저장소는 SimHop IT & Media AB 팀원 전용 비공개 저장소입니다. MIT 라이선스에 따라 코드를 열람하고 사용할 수 있지만, 현재로서는 공개 기여는 받지 않습니다. 사용자 혼란을 방지하기 위해 저희 패키지와 동일하거나 매우 유사하지 않은 한, 저장소를 포크하여 자신만의 버전을 만들어도 됩니다.

🤘 클라우데우스 플레인 MCP 🎸

"평면 영역에서 AI의 힘을 최대한 활용하세요 - MCP 우수성의 기준을 제시하세요!" 🖤

🎯 우리의 사명: AI를 활용한 프로젝트 관리 향상

AI 기반 프로젝트 관리 환경이 빠르게 진화하는 가운데, Claudeus Plane MCP를 소개합니다. Claudeus의 AI 역량과 Plane의 프로젝트 관리 플랫폼을 강력하게 연결하는 플랫폼입니다. 저희의 사명은 다음과 같습니다.

✅ Plane과 원활한 AI 통합 제공
✅ 자동화된 프로젝트 관리 워크플로 활성화
✅ AI 지원을 통해 팀 협업을 강화하세요
✅ 작업 및 리소스 관리를 간소화하세요
✅ MCP 개발을 위한 새로운 표준 설정

왜 클라우데우스 플레인 MCP인가요?

성공적인 Claudeus WordPress MCP를 기반으로 구축된 이 서버는 다음과 같은 동일한 수준의 기능을 제공합니다.

🎸 기술적 우수성: 엄격한 유형 검사를 통한 완벽한 TypeScript 적용
🎸 품질 보증: 포괄적인 테스트 모음(95% 이상 적용 범위)
🎸 프로토콜 준수: 전체 MCP 2024-11-05 사양 구현
🎸 보안: 엔터프라이즈급 보안 관행
🎸 신뢰성: 강력한 오류 처리 및 복구
🎸 문서: 자세한 가이드 및 예시

🤘 우리가 Plane을 선택한 이유: 기술 교향곡

프로젝트 관리 솔루션이라는 광활한 환경 속에서, Plane을 선택한 것은 단순한 결정이 아니라 기술적 혁신이었습니다. Plane이 AI 기반 프로젝트 관리 혁신의 완벽한 기반으로 자리매김한 이유는 다음과 같습니다.

🎸 기술적 우수성 및 아키텍처

오픈소스 파워
- 전체 소스 코드 투명성
- 자유를 보장하는 AGPL v3.0 라이선스
- 활발한 커뮤니티 기여
- Docker/Kubernetes를 사용한 셀프 호스팅 기능
최신 기술 스택
- 최첨단 기술로 제작
- 깔끔하고 모듈식 아키텍처
- 확장 가능한 플러그인 시스템
- API 우선 디자인 철학
성능 및 확장성
- 번개처럼 빠른 응답 시간
- 효율적인 데이터베이스 작업
- 스마트 캐싱 메커니즘
- 수평 확장 지원

🎯 기능 유연성

기존 솔루션과 달리 워크플로에 강제로 참여하게 만드는 방식:

특징	비행기	기타
워크플로우 유연성	모든 방법론(Agile, Waterfall 등)에 적응 가능	종종 특정 방법론에 갇힘
사용자 정의	개방형 아키텍처로 완벽한 사용자 정의 가능	공급업체가 제공하는 옵션으로 제한됨
완성	완전한 접근이 가능한 오픈 API	종종 제한되거나 유료 API
셀프 호스팅	데이터 및 인프라에 대한 완전한 제어	일반적으로 클라우드 전용 또는 제한된 셀프 호스팅

⚡ 개발 속도

Plane의 아키텍처는 다음을 가능하게 합니다.

빠른 반복 : 빠른 기능 개발 및 배포
Easy Extension : 간단한 플러그인 개발
API 우수성 : 완벽한 REST API 적용
실시간 업데이트 : 라이브 변경 사항에 대한 WebSocket 지원

🔒 보안 및 제어

데이터 주권
- 데이터 위치에 대한 완벽한 제어
- 공급업체에 대한 종속성 없음
- 사용자 정의 보안 정책
- 규정 준수 유연성
인증 및 권한 부여
- 세분화된 권한 시스템
- 여러 인증 방법
- 역할 기반 액세스 제어
- API 키 관리

💰 비용 효율성

측면	비행기	기존 솔루션
라이센스	오픈소스	종종 사용자당 가격이 비싼 편입니다.
호스팅	셀프 호스팅 옵션	일반적으로 클라우드 전용
사용자 정의	무료 및 무제한	종종 유료 추가 기능이 필요합니다
API 사용	제한 없는	일반적으로 계량/제한됨

🚀 미래 지향적 아키텍처

Plane의 디자인은 현대의 개발 요구 사항과 완벽하게 일치합니다.

AI 통합 준비 완료
- AI 통합에 적합한 깔끔한 API 디자인
- ML에 적합한 구조화된 데이터 모델
- AI 기능을 위한 확장 가능한 아키텍처
- AI 지원을 위한 실시간 기능
현대 개발
- TypeScript/Python 백엔드
- React 기반 프런트엔드
- Docker 컨테이너화
- 쿠버네티스 오케스트레이션
커뮤니티 파워
- 활발한 개발 커뮤니티
- 정기적인 업데이트 및 개선
- 기여에 열려 있습니다
- 투명한 로드맵

🎸 메탈 팩터

헤비메탈이 기존의 음악적 경계를 벗어나는 것처럼 Plane도 기존 프로젝트 관리의 제약에서 벗어납니다.

자유 : 커버곡을 연주하는 대신 자신의 리프를 쓰는 것과 같음
Power : 프로젝트 관리의 운명을 완벽하게 제어하세요
혁신 : 새로운 워크플로 및 기능을 생성하는 능력
커뮤니티 : 메탈 커뮤니티와 마찬가지로 강력한 오픈소스 정신

🤘 "기업 프로젝트 관리의 세계에서 Plane은 게임의 판도를 바꾸는 언더그라운드 메탈 밴드와 같습니다. 날것 그대로이고 강력하며 완벽하게 진정성이 있죠!" - 아마데우스

🔮 파트너십 잠재력

Plane의 철학은 우리의 비전과 완벽하게 일치합니다.

오픈소스 우수성
- 두 회사 모두 투명성을 중시합니다
- 품질에 대한 공동의 헌신
- 커뮤니티 주도 개발
혁신에 집중하다
- AI 우선 사고
- 현대 건축
- 지속적인 진화
기술적 시너지
- API 기반 개발
- 최신 기술 스택
- 성과 중심

이것이 바로 Plane이 단순한 선택이 아닌, 프로젝트 관리 분야에서 우리의 기술적 동반자이기 때문입니다. Claudeus Plane MCP를 통한 AI 통합을 통해, 우리는 프로젝트 관리 세계를 뒤흔드는 효율성의 교향곡을 만들어가고 있습니다! 🤘

🚀 핵심 기능

🎯 프로젝트 관리

AI 지원을 통해 프로젝트를 생성하고 관리하세요
자동화된 프로젝트 설정 및 구성
스마트 프로젝트 템플릿 및 워크플로

📋 작업 관리

AI 기반 작업 생성 및 할당
자동화된 작업 우선순위 지정
스마트한 작업 종속성 관리

👥 팀 협업

지능형 자원 할당
자동화된 팀 알림
스마트한 작업 부하 분산

💬 커뮤니케이션

AI 강화 댓글 관리
스마트 알림 시스템
자동 상태 업데이트

📖 빠른 시작 가이드

필수 조건

지엑스피1

설치

# Clone the repository
git clone https://github.com/deus-h/claudeus-plane-mcp

# Install dependencies
pnpm install

# Build the project
pnpm build

# Configure Claude Desktop
cp claude_desktop_config.json.example claude_desktop_config.json
# Edit claude_desktop_config.json with your settings

구성

# Copy example configs
cp .env.example .env
cp plane-instances.json.example plane-instances.json

# Edit .env and plane-instances.json with your settings

plane-instances.json 구성

plane-instances.json 파일은 Plane 인스턴스를 통합하도록 구성하는 데 사용됩니다. 아래는 구조의 예입니다.

{
  "instance-alias": {
    "baseUrl": "https://your-plane-instance.com/api/v1",
    "defaultWorkspace": "your-workspace-slug",
    "otherWorkspaces": ["workspace2", "workspace3"],
    "apiKey": "your-plane-api-key"
  }
}

구성 필드

baseUrl : Plane API의 기본 URL(필수)
defaultWorkspace : 기본 작업 공간 슬러그(필수)
otherWorkspaces : 추가 작업 공간 슬러그 배열(선택 사항)
apiKey : Plane API 키(필수)

🛠️ 개발

프로젝트 구조

src/
├── api/              # Plane API integration
│   ├── client/       # API client implementation
│   ├── endpoints/    # Endpoint definitions
│   └── types/        # API type definitions
│
├── mcp/              # MCP protocol implementation
│   ├── server.ts     # Core MCP server
│   ├── transport/    # Transport handlers
│   ├── tools.ts      # Tool definitions
│   └── types/        # MCP type definitions
│
├── tools/            # Tool implementations
│   ├── projects/     # Project management
│   ├── tasks/        # Task operations
│   ├── users/        # User management
│   └── comments/     # Comment handling
│
└── prompts/          # AI prompt templates
    ├── projects/     # Project-related prompts
    ├── tasks/        # Task-related prompts
    └── analysis/     # Analysis prompts

사용 가능한 스크립트

# Development
pnpm dev         # Start development server
pnpm watch       # Watch for changes
pnpm inspector   # Launch MCP Inspector

# Testing
pnpm test              # Run tests
pnpm test:watch        # Watch tests
pnpm test:coverage     # Generate coverage

# Building
pnpm build       # Build for production
pnpm clean       # Clean build files

🔒 보안

입증

API 키 기반 인증
안전한 토큰 관리
요청 검증

데이터 보호

암호화된 통신
보안 구성 저장소
입력 살균

🤝 기여하기

이 저장소는 SimHop IT & Media AB 개발팀이 관리하는 비공개 저장소입니다. 공개 기여는 받지 않지만, 팀원들은 개발 기준에 따라 기여할 수 있습니다.

기능 브랜치 생성( feature/AmazingFeature )
테스트 범위를 95% 이상으로 유지
TypeScript 및 문서 표준을 따르세요
검토를 위해 PR 제출

📄 라이센스

🎸 마법을 만드는 팀

SimHop IT & Media AB - 혁신과 메탈의 만남 🤘

스웨덴에 본사를 둔 SimHop IT & Media AB는 탁월한 기술력과 창의적인 혁신을 결합합니다. 저희 팀은 다음과 같습니다.

Amadeus Samiel H. (CTO/수석 솔루션 아키텍트)

컴퓨터 과학 석사
20년 이상의 기술적 우수성
Claudeus MCP 서버의 거장

사이먼 말키(CEO)

20년 이상의 비즈니스 리더십
전략 기획 전문가
SimHop의 성공을 이끄는 비전가

Amadeus Samiel H. 가 🤘❤️로 만들었습니다.

🛠 MCP 도구 참조

도구 범주 및 위험 수준

도구 이름	범주	역량	위험 수준
프로젝트 관리
`claudeus_plane_projects__list`	프로젝트	모든 프로젝트 나열	🟢 안전함
`claudeus_plane_projects__create`	프로젝트	새로운 프로젝트 만들기	🟡 중간
`claudeus_plane_projects__update`	프로젝트	프로젝트 수정	🟡 중간
`claudeus_plane_projects__delete`	프로젝트	프로젝트 제거	🔴 높음
작업 관리
`claudeus_plane_tasks__list`	작업	모든 작업 나열	🟢 안전함
`claudeus_plane_tasks__create`	작업	새로운 작업 만들기	🟡 중간
`claudeus_plane_tasks__update`	작업	작업 수정	🟡 중간
`claudeus_plane_tasks__delete`	작업	작업 제거	🔴 높음
사용자 관리
`claudeus_plane_users__list`	사용자	모든 사용자 나열	🟢 안전함
`claudeus_plane_users__invite`	사용자	새로운 사용자 초대	🟡 중간
`claudeus_plane_users__update`	사용자	사용자 역할 수정	🟡 중간
`claudeus_plane_users__remove`	사용자	사용자 제거	🔴 높음
댓글 관리
`claudeus_plane_comments__list`	댓글	모든 댓글을 나열하세요	🟢 안전함
`claudeus_plane_comments__create`	댓글	댓글을 작성하세요	🟡 중간
`claudeus_plane_comments__update`	댓글	댓글 편집	🟡 중간
`claudeus_plane_comments__delete`	댓글	댓글 삭제	🔴 높음

위험 수준 범례

🟢 안전 : 읽기 전용 작업, 데이터 수정 없음
🟡 중간 : 콘텐츠를 생성하거나 수정하지만 되돌릴 수 있습니다.
🔴 높음 : 파괴적인 작업이나 시스템 전체 변경

🎯 기술 심층 분석

아키텍처 개요 🏗️

기술 아키텍처의 각 구성 요소는 최대의 효율성과 안정성을 위해 설계되었습니다.

핵심 구성 요소 🤘

요소	책임	주요 특징
API 계층	평면 통합	REST 클라이언트, 유형 안전성, 속도 제한
MCP 프로토콜	의사소통	JSON-RPC 2.0, 양방향 흐름
보안	보호	인증, 암호화, 검증
도구	운영	프로젝트, 작업, 사용자, 코멘트
프롬프트	AI 통합	템플릿, 컨텍스트 인식

기술 구현 🎸

특징	구현	설명
유형 안전	타입스크립트	전체 정적 타이핑, 런타임 검증
API 처리	REST/JSON-RPC	효율적인 요청/응답 처리
이벤트 시스템	이벤트 이미터	비동기 이벤트 처리
오류 처리	다층	포괄적인 오류 관리
캐싱	메모리 내/Redis	성능 최적화

보안 조치 🛡️

층	보호	특징
수송	TLS/SSL	암호화된 통신
입증	API 키	안전한 토큰 관리
확인	스키마 기반	입력/출력 검증
암호화	AES-256	데이터 보호
심사	포괄적인	활동 추적

성능 튜닝 🚀

최적화	기술	설명
캐싱	다단계	응답 및 쿼리 캐싱
배칭	그룹화 요청	API 호출 감소
압축	GZIP/브로틀리	네트워크 최적화
쿼리 최적화	스마트 페칭	효율적인 API 쿼리
부하 분산	분포	스케일 처리

오류 범주 및 처리 🎸

범주	코드 범위	손질	예
규약	-32600에서 -32603까지	자동 재시도	잘못된 JSON-RPC
비행기 API	1000-1999	폴백	API 시간 초과
보안	2000-2999	알리다	인증 실패
도구	3000-3999	다시 덮다	작업 실패
체계	4000-4999	다시 시작	자원 고갈

디자인 원칙 파워 코드 🤘

원칙	설명	구현
모듈성	느슨한 결합	독립 구성 요소
유형 안전	강력한 타이핑	TypeScript + 검증
보안	제로 트러스트	다층 보호
성능	스피드 메탈	최적화된 운영

🎸 전문가 팁: 잘 조율된 기타처럼, 각 부품은 최대의 분쇄 성능을 위해 정밀하게 조정되었습니다! ❤️

⚡ 성과 지표

시간 절약

일	수동 프로세스	클라우데우스와 함께	결과
프로젝트 설정	2시간	2분	✓ 98.3%
작업 생성	30분	30초	✓ 98.3%
사용자 관리	1시간	1분	✓ 98.3%
대량 업데이트	4시간	3분	✓ 98.7%

비용 효율성

의지	전통적인 비용	설명
프로젝트 매니저	월 5000달러	프로젝트 설정 및 관리
작업 관리자	3000달러/월	작업 추적 및 업데이트
팀 리더	월 4000달러	자원 할당
총	월 12,000달러	모든 서비스가 결합됨

클로드 프로	월 20달러	Anthropic 에서

차이점	월 11,980달러	Claude Desktop( Mac , Windows )을 사용한 Claudeus Plane MCP를 이용한 잠재적 비용 절감

🎸 Claude 데스크톱 통합

구성 위치

Claude Desktop 구성 파일은 다음 위치에서 찾을 수 있습니다.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

⚠️ 중요 : Claude Desktop에 이미 다른 MCP 서버가 구성되어 있는 경우, 예시 파일을 직접 복사하지 마세요. 기존 구성을 덮어쓰게 됩니다! 대신 다음을 수행하세요.

기존 Claude Desktop 사용자의 경우 :
- Claude Desktop을 통해 기존 구성을 엽니다.
  - Claude 메뉴를 클릭하세요
  - "설정..."을 선택하세요
  - 왼쪽 막대에서 "개발자"를 클릭하세요
  - "구성 편집"을 클릭하세요
- 또는 텍스트 편집기에서 직접 구성 파일을 엽니다.
- 기존 mcpServers 객체에 Claudeus Plane MCP 서버 구성을 추가합니다.
새로운 Claude Desktop 사용자를 위해 : 예제 구성 파일을 복사할 수 있습니다.
# For macOS cp claude_desktop_config.json.example ~/Library/Application\ Support/Claude/claude_desktop_config.json # For Windows (in PowerShell) Copy-Item claude_desktop_config.json.example $env:APPDATA\Claude\claude_desktop_config.json

구성 예제

NPX 설정

{
  "mcpServers": {
    "claudeus-plane-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claudeus-plane-mcp"
      ],
      "env": {
        "PLANE_INSTANCES_PATH": "/absolute/path/to/your/plane-instances.json"
      }
    }
  }
}

Docker 설정 🐳

{
  "mcpServers": {
    "claudeus-plane-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--network=host",
        "--mount", "type=bind,src=/absolute/path/to/your/plane-instances.json,dst=/app/plane-instances.json",
        "--mount", "type=bind,src=/absolute/path/to/your/.env,dst=/app/.env",
        "mcp/plane",
        "--config", "/app/plane-instances.json"
      ]
    }
  }
}

🎸 전문가 팁: /absolute/path/to/your/plane-instances.json 구성 파일의 실제 경로로 바꿔야 합니다!

구성 후

Claude Desktop을 완전히 다시 시작하세요
입력란 오른쪽 하단에 있는 망치 🔨 아이콘을 찾으세요.
클릭하면 사용 가능한 비행기 관리 도구를 볼 수 있습니다.
분쇄를 시작하세요! 🤘

문제 해결

Claude에 서버가 표시되지 않는 경우:

claude_desktop_config.json 구문을 확인하세요.
파일 경로가 절대적이고 유효한지 확인하세요
Claude의 기록을 다음에서 확인하세요.
- macOS: ~/Library/Logs/Claude
- Windows: %APPDATA%\Claude\logs

⚠️ 문제 및 고려 사항

현재 제한 사항 및 해결 방법

1. Claude 데스크톱 응답 제한

문제 : 복잡한 작업 중에 Claude Desktop의 최대 응답 길이에 도달할 수 있습니다.
영향 : 작업이 중단되어 사용자 개입이 필요할 수 있습니다.
해결 방법 :
- 작업을 더 작은 배치로 나누도록 Claude Desktop을 구성합니다.
- Claude Desktop 설정 > 고급:
  - "최대 응답 길이"를 더 낮은 값으로 설정하세요.
  - "자동 분할 응답" 활성화
- 대규모 작업에 Inspector UI를 사용하세요

2. 속도 제한 고려 사항

문제 : Plane API에 속도 제한이 있습니다.
영향 : 대량 작업이 제한될 수 있습니다.
완화책 :
- 일괄 처리 기능 사용
- 요청 사이에 적절한 지연을 구현합니다.
- 속도 제한 정보를 위한 API 응답 헤더 모니터링

3. 메모리 관리

문제 : 대규모 작업이 상당한 메모리를 소모할 수 있음
영향 : 잠재적인 성능 저하
모범 사례 :
- 대규모 작업 중 시스템 리소스 모니터링
- 대용량 데이터 세트에 페이지 매김 사용
- 정리 루틴을 구현하세요

향후 개선 사항

우리는 다음 사항에 대해 적극적으로 노력하고 있습니다.

Claude Desktop의 향상된 응답 처리
고급 속도 제한 관리
메모리 최적화 기술
향상된 오류 복구 메커니즘

🎸 전문가 팁: GitHub 토론에서 해결 방법과 모범 사례를 확인하세요!

🎸 지원 및 커뮤니티 ❤️

GitHub 토론: 아이디어 공유, 문제 보고, 대화 참여
문서: 전체 기술 문서
예: 샘플 구현

🎸 전문가 팁: GitHub 토론을 이용해 경험을 공유하고, 문제점을 보고하고, 개선 사항을 제안해 보세요!

프로젝트 관리자의 애국가

Amadeus & Claude의

Plane의 광활한 공간에서,
작업은 우아하게 흐릅니다.
AI의 포옹,
완벽한 속도를 설정합니다.

클로드의 힘으로,
프로젝트가 시작됩니다.
코드의 기쁨 속에서,
모든 동기화가 완벽해요.

관리자의 꿈,
AI와 팀이 있는 곳,
상류에서 작업하세요.
금속의 반짝임과 같다.