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

2つのアイテム間にアソシエーションを作成（例：依存関係、ブロック）

create_reference

2つのアイテム間に下流のトレーサビリティ参照を追加

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 で "command": "node" と "args": ["dist/index.js"] を使用します。

開発とテスト

# 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