Skip to main content
Glama
deenesjakoruzh
3KniGHtcZ

codebeamer-mcp

by 3KniGHtcZ
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

codebeamer-mcp

Codebeamer ALM을 위한 MCP(Model Context Protocol) 서버입니다. Claude 및 기타 MCP 클라이언트가 자연어를 사용하여 Codebeamer의 프로젝트, 트래커 및 항목을 읽고 쓸 수 있도록 합니다.

codebeamer-mcp MCP server

도구 (18)

읽기

도구

설명

list_projects

모든 프로젝트 나열

get_project

프로젝트 세부 정보 가져오기

list_trackers

프로젝트 내 트래커 나열

get_tracker

트래커 세부 정보 가져오기

list_tracker_items

트래커 내 항목 나열

search_items

전체 텍스트 / cbQL 검색

get_item

테스트 케이스 항목에 대한 테스트 단계(작업 + 예상 결과)를 포함한 항목 세부 정보 가져오기

get_item_relations

나가는/들어오는 연결(의존성, 차단 등) 가져오기

get_item_references

업스트림/다운스트림 추적성 참조(파생, 커버리지 등) 가져오기

get_item_comments

항목 댓글 가져오기

get_item_reviews

항목에 대한 Review Hub 리뷰(결과, 검토자, 투표) 가져오기

get_user

사용자 세부 정보 가져오기

쓰기

도구

설명

create_item

트래커에 새 항목 생성. 폴더, 항목 유형 및 상위 중첩 지원

update_item

기존 항목 업데이트(이름, 설명, 상태, 우선순위, 담당자, 사용자 정의 필드)

add_comment

항목에 댓글 추가

create_association

두 항목 간의 연결 생성(예: 의존성, 차단)

create_reference

두 항목 간의 다운스트림 추적성 참조 추가

create_harm

IMDRF 코드 및 심각도(1~5)를 사용하여 RM Harms List 트래커에 위해 항목 생성

설치

요구 사항

  • Node.js 20 이상

  • Codebeamer 인스턴스에 대한 액세스 권한(URL, 사용자 이름, 비밀번호)

Claude Code (CLI)

가장 빠른 방법 — 터미널에서 다음 명령을 실행하세요:

claude mcp add codebeamer -e CB_URL=https://your-instance.example.com/cb/api \
  -e CB_USERNAME=your_username -e CB_PASSWORD=your_password \
  -- npx -y codebeamer-mcp

또는 프로젝트 루트의 .mcp.json(전역 범위의 경우 ~/.claude/mcp.json)에 수동으로 추가하세요:

{
  "mcpServers": {
    "codebeamer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Claude Desktop

사용 중인 플랫폼의 구성 파일을 편집하세요:

플랫폼

경로

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Linux

~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

저장 후 Claude Desktop을 다시 시작하세요.

Cursor

프로젝트 루트의 .cursor/mcp.json(프로젝트 범위) 또는 ~/.cursor/mcp.json(전역)에 추가하세요:

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json에 추가하세요:

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

VS Code (Copilot)

프로젝트 루트의 .vscode/mcp.json에 추가하세요:

{
  "servers": {
    "codebeamer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Gemini CLI

~/.gemini/settings.json에 추가하세요:

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

대안: 전역 설치

npm install -g codebeamer-mcp

그런 다음 위의 구성에서 npx 대신 "command": "codebeamer-mcp"(args 없음)를 사용하세요.

특정 버전 고정

"args": ["-y", "codebeamer-mcp@0.2.0"]

업데이트

방법

업데이트 동작

npx -y codebeamer-mcp

항상 최신 버전을 가져옴

npm install -g codebeamer-mcp

설치된 버전을 유지함. 업데이트하려면 npm update -g codebeamer-mcp 실행

고정된 버전 (@0.2.0)

자동 업데이트되지 않음; 버전 문자열을 수동으로 변경

⚠️ 실제 자격 증명이 포함된 .mcp.json은 절대 커밋하지 마세요 — .gitignore에 나열되어 있습니다.

소스에서 빌드 (개발용)

git clone https://github.com/3KniGHtcZ/codebeamer-mcp.git
cd codebeamer-mcp
npm install
npm run build

그런 다음 .mcp.json에서 "args": ["dist/index.js"]와 함께 "command": "node"를 사용하세요.

개발 및 테스트

# Run tests (no real Codebeamer instance needed)
npm test

# Start the mock API server (port 3001)
node mock-server.mjs

# Interactive testing via MCP Inspector
CB_URL=http://localhost:3001 CB_USERNAME=mock CB_PASSWORD=mock \
  npx @modelcontextprotocol/inspector node dist/index.js

구성

변수

설명

기본값

CB_URL

Codebeamer API URL, 예: https://your-instance.example.com/cb/api (서버가 자동으로 /v3를 추가함)

(필수)

CB_USERNAME

로그인 사용자 이름

(필수)

CB_PASSWORD

비밀번호

(필수)

CB_UNSAFE_SSL

인증되지 않았거나 자체 서명된 인증서가 있는 서버에 대한 연결을 허용하려면 true로 설정

false

CB_API_VERSION

API 버전

v3

CB_TIMEOUT_MS

요청 시간 초과 (ms)

30000

CB_MAX_ITEMS

페이지당 최대 항목 수

100

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - A tier

How are these scores calculated?

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/3KniGHtcZ/codebeamer-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server