제작: makeplane · makeplane/plane-mcp-server
Plane의 자사 MCP — 에이전트의 전체 작업 공간 제어: 프로젝트, 작업 항목, 주기, 모듈, 이니셔티브 등에 걸쳐 55개 이상의 도구.
plane-mcp-server는 Plane의 공식 MCP 서버입니다. API 키와 작업 영역 슬러그를 사용하면 에이전트는 프로젝트를 생성 및 업데이트하고, 작업 항목을 엔드투엔드(CRUD + 검색) 관리하고, 주기 및 모듈을 실행하고, 작업 영역 수준 이니셔티브를 조정하고, 접수 대기열을 선별하고, 사용자 지정 작업 항목 속성을 구성하고, 현재 사용자를 조회할 수 있습니다. uvx를 통해 stdio(로컬)를 지원하고 호스팅 클라이언트에 대해 OAuth 또는 PAT 헤더를 사용하여 HTTP/원격 전송도 지원합니다.
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"plane-mcp-server": {
"command": "uvx",
"args": [
"plane-mcp-server",
"stdio"
],
"env": {
"PLANE_API_KEY": "<from Plane → Settings → API tokens>",
"PLANE_WORKSPACE_SLUG": "your-workspace-slug",
"PLANE_BASE_URL": "https://api.plane.so"
}
}
}
}Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.
{
"mcpServers": {
"plane-mcp-server": {
"command": "uvx",
"args": [
"plane-mcp-server",
"stdio"
],
"env": {
"PLANE_API_KEY": "<from Plane → Settings → API tokens>",
"PLANE_WORKSPACE_SLUG": "your-workspace-slug",
"PLANE_BASE_URL": "https://api.plane.so"
}
}
}
}Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.
{
"mcpServers": {
"plane-mcp-server": {
"command": "uvx",
"args": [
"plane-mcp-server",
"stdio"
],
"env": {
"PLANE_API_KEY": "<from Plane → Settings → API tokens>",
"PLANE_WORKSPACE_SLUG": "your-workspace-slug",
"PLANE_BASE_URL": "https://api.plane.so"
}
}
}
}Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.
{
"mcpServers": {
"plane-mcp-server": {
"command": "uvx",
"args": [
"plane-mcp-server",
"stdio"
],
"env": {
"PLANE_API_KEY": "<from Plane → Settings → API tokens>",
"PLANE_WORKSPACE_SLUG": "your-workspace-slug",
"PLANE_BASE_URL": "https://api.plane.so"
}
}
}
}Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.
{
"mcpServers": [
{
"name": "plane-mcp-server",
"command": "uvx",
"args": [
"plane-mcp-server",
"stdio"
]
}
]
}Continue는 맵이 아닌 서버 오브젝트 배열 사용.
{
"context_servers": {
"plane-mcp-server": {
"command": {
"path": "uvx",
"args": [
"plane-mcp-server",
"stdio"
]
}
}
}
}context_servers에 추가. 저장 시 Zed가 핫 리로드.
claude mcp add plane-mcp-server -- uvx plane-mcp-server stdio한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.
언제 쓸까: 새로운 요청이 유입됩니다. 대량으로 분류하고 라우팅하려고 합니다.
결과: UI를 열지 않고도 섭취 항목이 줄어들고 경로가 더 잘 전달됩니다.
언제 쓸까: 주기 계획 시간 올바른 항목을 가져와 견적을 설정해야 합니다.
결과: 이니셔티브 계보를 캡처하여 한 번의 패스로 스프린트를 진행합니다.
언제 쓸까: 전략적 노력은 프로젝트 경계를 넘어 작업 공간 수준의 보기를 원합니다.
결과: 빈 컨테이너가 아닌 실제 작업으로 채워진 이니셔티브 대시보드입니다.
언제 쓸까: 비행기가 기본적으로 제공하지 않는 필드가 필요합니다.
결과: 평면 설정을 수동으로 열지 않고도 더욱 풍부한 데이터 모델을 사용할 수 있습니다.
병합된 PR을 닫은 평면 작업 항목에 다시 연결
미러 작업: 선형 이슈에서 평면 항목 생성 또는 그 반대로
이해관계자 판독을 위해 주기 요약을 Notion으로 푸시
| 도구 | 입력 | 언제 호출 | 비용 |
|---|---|---|---|
| projects.* | varies | 프로젝트 및 멤버 나열/생성/업데이트 | 1 API call |
| work_items.* | varies | 전체 CRUD + 작업 항목 검색 | 1 API call |
| cycles.* | varies | 스프린트/사이클 및 해당 항목 관리 | 1 API call |
| modules.* | varies | 모듈 및 전송 관리 | 1 API call |
| initiatives.* | varies | 작업공간 수준의 전략 계획 | 1 API call |
| intake.* | varies | 섭취 수락, 거부 또는 전달 | 1 API call |
| properties.* | project_id + schema | 사용자 정의 속성 구성 | 1 API call |
401 무단PLANE_API_KEY가 누락/만료되었거나 작업공간이 잘못되었습니다. 토큰을 다시 생성합니다.
curl -H 'X-API-Key: $PLANE_API_KEY' $PLANE_BASE_URL/api/v1/workspaces/작업 공간 슬러그 불일치PLANE_WORKSPACE_SLUG는 /app/<slug>/의 URL 세그먼트와 정확히 일치해야 합니다.
Open Plane in the browser; copy the slug from the URL비율 제한대량 작업 사이에 일시 중지를 추가합니다. 작업공간당 Plane API 비율 제한.
Inspect response headers for rate-limit fields| 대안 | 언제 쓰나 | 단점/장점 |
|---|---|---|
| linear | 당신의 팀은 Plane이 아닌 Linear에 살고 있습니다. | 다른 도구, 다른 모양 |
| monday | 귀하의 팀은 Monday.com에 있습니다 | 다양한 데이터 모델 |
| shrimp-task-manager | 전체 PM 플랫폼이 아닌 로컬 작업 관리자를 원합니다. | 팀 협업 없음 |