Plane MCP 서버

Plane 통합을 위한 MCP(Model Context Protocol) 서버입니다. 이 서버는 AI 에이전트를 통해 Plane과 상호 작용하기 위한 도구와 리소스를 제공합니다.

주요 기능

• 🔧 Plane 통합: Plane API 및 서비스와 상호 작용

• 🔌 다중 전송 방식: stdio, SSE 및 스트리밍 가능한 HTTP 전송 지원

• 🌐 원격 및 로컬: 로컬 및 원격 서비스로 모두 작동

• 🛠️ 확장성: 새로운 도구와 리소스를 쉽게 추가 가능

Related MCP server: claude-plane

사용법

이 서버는 세 가지 전송 방식을 지원합니다. 설치가 필요 없는 uvx 사용을 권장합니다.

1. Stdio 전송 (로컬 사용 시)

MCP 클라이언트 구성 (uvx 사용 권장):

{
  "mcpServers": {
    "plane": {
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "<your-api-key>",
        "PLANE_WORKSPACE_SLUG": "<your-workspace-slug>",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

2. OAuth를 사용한 원격 HTTP 전송

OAuth 인증을 사용하여 호스팅된 Plane MCP 서버에 연결합니다.

URL: https://mcp.plane.so/http/mcp

MCP 클라이언트 구성 (네이티브 원격 MCP 지원이 없는 Claude Desktop과 같은 도구용):

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/http/mcp"]
    }
  }
}

참고: 원격 서버에 연결할 때 OAuth 인증은 자동으로 처리됩니다.

3. PAT 토큰을 사용한 원격 HTTP 전송

개인 액세스 토큰(PAT)을 사용하여 호스팅된 Plane MCP 서버에 연결합니다.

URL: https://mcp.plane.so/api-key/mcp

헤더:

• Authorization: Bearer <PAT_TOKEN>

• X-Workspace-slug: <SLUG>

MCP 클라이언트 구성 (네이티브 원격 MCP 지원이 없는 Claude Desktop과 같은 도구용):

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/http/api-key/mcp"],
      "headers": {
        "Authorization": "Bearer <PAT_TOKEN>",
        "X-Workspace-slug": "<SLUG>"
      }
    }
  }
}

4. SSE 전송 (레거시)

⚠️ 레거시 전송: SSE(Server-Sent Events) 전송은 하위 호환성을 위해 유지됩니다. 새로운 구현에서는 대신 HTTP 전송(섹션 2 또는 3)을 사용해야 합니다.

Server-Sent Events를 통해 OAuth 인증을 사용하여 호스팅된 Plane MCP 서버에 연결합니다.

URL: https://mcp.plane.so/sse

MCP 클라이언트 구성 (SSE 전송을 지원하는 도구용):

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/sse"]
    }
  }
}

참고: 원격 서버에 연결할 때 OAuth 인증은 자동으로 처리됩니다. 이 전송 방식은 HTTP 전송을 위해 더 이상 사용되지 않습니다(deprecated).

구성

인증

서버는 환경 변수를 통한 인증이 필요합니다:

• PLANE_BASE_URL: Plane API의 기본 URL (기본값: https://api.plane.so) - 선택 사항

• PLANE_API_KEY: 인증을 위한 API 키 (stdio 전송 시 필수)

• PLANE_WORKSPACE_SLUG: 워크스페이스 슬러그 식별자 (stdio 전송 시 필수)

• PLANE_ACCESS_TOKEN: 인증을 위한 액세스 토큰 (API 키 대신 사용 가능)

예시 (stdio 전송 시):

export PLANE_BASE_URL="https://api.plane.so"
export PLANE_API_KEY="your-api-key"
export PLANE_WORKSPACE_SLUG="your-workspace-slug"

참고: 원격 HTTP 전송(OAuth 또는 PAT)의 경우, 인증은 연결 방식(OAuth 흐름 또는 PAT 헤더)을 통해 처리되므로 이러한 환경 변수가 필요하지 않습니다.

사용 가능한 도구

이 서버는 Plane과 상호 작용하기 위한 포괄적인 도구를 제공합니다. 모든 도구는 유형 안전성과 유효성 검사를 위해 Plane SDK의 Pydantic 모델을 사용합니다.

프로젝트

작업 항목 (Work Items)

사이클 (Cycles)

모듈 (Modules)

이니셔티브 (Initiatives)

인테이크 작업 항목 (Intake Work Items)

작업 항목 속성 (Work Item Properties)

사용자 (Users)

총 도구 수: 8개 카테고리에 걸쳐 55개 이상의 도구

개발

테스트 실행

pytest

코드 포맷팅

black plane_mcp/
ruff check plane_mcp/

라이선스

MIT 라이선스 - 자세한 내용은 LICENSE를 참조하세요.

기여

기여를 환영합니다! 자유롭게 Pull Request를 제출해 주세요.

지원 중단 알림

⚠️ Node.js 기반의 plane-mcp-server는 지원이 중단되었으며 더 이상 유지 관리되지 않습니다.

이 저장소는 Plane MCP 서버의 새로운 Python+FastMCP 기반 구현을 나타냅니다. 이전 Node.js 버전을 사용 중이었다면, 지속적인 지원과 업데이트를 위해 이 Python 기반 버전으로 마이그레이션하십시오.

새로운 구현은 다음을 제공합니다:

• Pydantic 모델을 통한 더 나은 유형 안전성

• FastMCP를 통한 향상된 성능

• 강화된 도구 범위

• 활발한 유지 관리 및 개발

마이그레이션 지원이 필요한 경우, 이 README의 구성 예시를 참조하거나 지원을 위해 이슈를 열어주세요.

이전 Node.js 구성 (지원 중단):

이전 Node.js 기반의 @makeplane/plane-mcp-server를 사용 중이었다면, 구성은 다음과 같았습니다:

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": [
        "-y",
        "@makeplane/plane-mcp-server"
      ],
      "env": {
        "PLANE_API_KEY": "<YOUR_API_KEY>",
        "PLANE_API_HOST_URL": "<HOST_URL_FOR_SELF_HOSTED>",
        "PLANE_WORKSPACE_SLUG": "<YOUR_WORKSPACE_SLUG>"
      }
    }
  }
}

위의 사용법 섹션에 표시된 새로운 Python 기반 구성으로 마이그레이션하십시오.