@orbit/mcp-plain

Plain 고객 지원 플랫폼용 MCP 서버입니다. Model Context Protocol을 통해 스레드, 헬프 센터 문서 등을 관리하는 도구를 제공합니다.

설정

Claude Code 사용 시

프로젝트의 .claude/settings.json에 추가하세요:

{
  "mcpServers": {
    "plain": {
      "command": "npx",
      "args": ["-y", "@orbitlogistics/mcp-plain@latest"],
      "env": {
        "PLAIN_API_KEY": "${PLAIN_API_KEY}"
      }
    }
  }
}

그런 다음 셸 환경(예: .zshrc, .envrc 또는 시크릿 관리자)에서 PLAIN_API_KEY를 설정하세요.

다른 MCP 클라이언트 사용 시

서버를 직접 실행하세요:

PLAIN_API_KEY=plainApiKey_xxx npx @orbitlogistics/mcp-plain@latest

Related MCP server: plane-mcp-server

도구

참고: 이 서버는 전체 Plain API를 다루지 않습니다 — 현재 사용 중인 엔드포인트만 포함합니다. 추가 메서드가 필요하다면 PR을 환영합니다!

스레드

• list_threads - 필터(상태, 우선순위, 라벨, 고객, 테넌트)로 스레드 목록 조회

• get_thread - ID로 전체 스레드 세부 정보 조회(타임라인 포함)

• get_thread_by_ref - 참조 번호로 스레드 조회(예: T-510)

• get_thread_fields - 스레드의 사용자 정의 필드 값 조회

• create_thread - 새 스레드 생성(필요 시 이메일로 고객 자동 생성)

• reply_to_thread - 원래 채널을 통해 답장 보내기

• mark_thread_as_done - 스레드를 해결됨으로 표시

• upsert_thread_field - 사용자 정의 필드 값 설정/업데이트

• add_internal_note - 내부 메모 게시(고객에게 보이지 않음)

• add_labels - 스레드에 카테고리 라벨 추가

• get_label_types - 사용 가능한 라벨 유형 목록 조회

스레드 링크

• link_threads - 스레드를 다른 Plain 스레드, Linear 이슈, Jira 이슈 또는 일반 소스에 연결

• get_thread_links - 스레드의 링크 목록 조회

• unlink_thread - 링크 ID로 링크 제거

get_thread 및 get_thread_by_ref는 스레드의 처음 25개 링크를 links 배열로도 반환합니다.

첨부 파일

• get_attachment_download_url - 임시 다운로드 URL 가져오기

• get_attachment_content - 첨부 파일 콘텐츠 가져오기(텍스트 또는 base64)

헬프 센터

• list_help_centers - 모든 헬프 센터 목록 조회

• get_help_center - 헬프 센터 구조 조회(그룹 및 문서)

• list_help_center_articles - 전체 콘텐츠가 포함된 문서 목록 조회

• get_help_center_article - ID로 문서 조회

• get_help_center_article_by_slug - URL 슬러그로 문서 조회

• upsert_help_center_article - 문서 생성 또는 업데이트(항상 DRAFT로 저장)

• create_help_center_article_group - 문서 그룹 생성

• delete_help_center_article_group - 빈 문서 그룹 삭제

개발

pnpm install
pnpm test
pnpm build

라이선스

MIT