Каталог MCP
3KniGHtcZ/codebeamer-mcp

3KniGHtcZ/codebeamer-mcp

Name: 3KniGHtcZ/codebeamer-mcp
Availability: InStock
Author: 3knightcz

MCP сервер для Codebeamer ALM — читает и создаёт проекты, трекеры и элементы через естественный язык. Управляйте требованиями, задачами и связями без лишних кликов. Полезен инженерам и тестировщика...

Github NPM Сайт сервера

README

19 инструментов

Версии

Установить сервер

codebeamer-mcp

An MCP (Model Context Protocol) server for Codebeamer ALM. Allows Claude and other MCP clients to read and write projects, trackers, and items in Codebeamer using natural language.

Tools (19)

Read

Tool	Description
`list_projects`	List all projects
`get_project`	Get project details
`list_trackers`	List trackers in a project
`get_tracker`	Get tracker details
`list_tracker_items`	List items in a tracker
`search_items`	Full-text / cbQL search
`get_item`	Get item summary: ID, name, tracker, status and description. Lightweight — use when you only need to identify the item and read its content
`get_item_details`	Get full structured detail of an item: project, priority, assignees, timestamps, story points, custom fields and test steps. Description omitted — fetch it via `get_item`
`get_item_relations`	Get outgoing/incoming associations (depends on, blocks, …)
`get_item_references`	Get upstream/downstream traceability references (derived from, covers, …)
`get_item_comments`	Get item comments
`get_item_reviews`	Get Review Hub reviews for an item (result, reviewers, votes)
`get_user`	Get user details

Инструменты были проиндексированы: 18.10.2026

add_comment

Добавляет комментарий к элементу работы Codebeamer. Поддерживает форматы обычного текста и вики-разметки. Возвращает созданный комментарий.

Добавить комментарий

Параметры

commentstringобязательный
Текст комментария
formatenum
Формат комментария: PlainText или Wiki markup
itemIdintegerобязательный
Числовой ID элемента для комментирования

create_association

Создайте ассоциацию (связь) между двумя элементами работы Codebeamer. Распространённые типы ассоциаций: 'depends on', 'blocks', 'related to', 'derived from'. Используйте get_item_relations на существующем элементе, чтобы узнать допустимые идентификаторы типов ассоциаций.

Создать ассоциацию

Параметры

descriptionstring
Необязательное описание для ассоциации.
fromItemIdintegerобязательный
ID исходного элемента
toItemIdintegerобязательный
ID целевого элемента.
typeIdintegerобязательный
Идентификатор типа связи (используйте get_item_relations, чтобы узнать доступные типы)

create_harm

Создаёт новый элемент в трекере Codebeamer RM Harms List. Поддерживает установку кода IMDRF (текст) и степени серьёзности (целое число от 1 до 5). Используйте list_trackers, чтобы найти ID трекера Harms List для вашего проекта.

Создать вред

Параметры

descriptionstring
Описание вреда (обычный текст или вики-разметка)
imdrfCodestring
Код IMDRF для этого вреда (например, 'E0001')
namestringобязательный
Название вреда / краткое описание
parentIdinteger
Идентификатор родительского элемента (например, папки), в который нужно вложить этот harm.
severityinteger
Уровень серьезности (целое число 1-5)
trackerIdintegerобязательный
Числовой идентификатор трекера RM Harms List

create_item

Создать новый рабочий элемент в трекере Codebeamer. Используйте get_tracker, чтобы узнать доступные поля, статусы и приоритеты. Возвращает созданный элемент со всеми полями.

Создать элемент

Параметры

assignedToIdsinteger[]
Массив идентификаторов пользователей для назначения.
descriptionstring
Описание элемента (простой текст или вики-разметка)
isFolderboolean
Установите true, чтобы создать элемент папки вместо обычного элемента.
itemTypeNamestring
Имя типа элемента, заданное в трекере (например, 'Folder', 'Informative'). Переопределяет isFolder.
namestringобязательный
Краткое описание элемента / заголовок
parentIdinteger
Идентификатор родительского элемента, в который вкладывается этот элемент (например, в папку)
priorityIdinteger
Priority ID (используйте get_tracker, чтобы просмотреть доступные приоритеты)
statusIdinteger
Status ID (используйте get_tracker, чтобы увидеть доступные статусы)
storyPointsinteger
Оценка в story points
trackerIdintegerобязательный
Числовой ID трекера, в котором создать элемент.

create_reference

Добавляет прямую ссылку от одного элемента Codebeamer к другому. Прямые ссылки обозначают связи вывода/трассировки (например, требование, производное от другого). Элемент 'from' получает прямую ссылку, указывающую на элемент 'to'.

Создать downstream-ссылку

Параметры

fromItemIdintegerобязательный
Item ID, к которому будет добавлена downstream-ссылка.
toItemIdintegerобязательный
Идентификатор элемента, на который ссылаться как на downstream.

get_item

Получить лёгкую сводку рабочего элемента Codebeamer: ID, название, трекер, статус и описание. Используйте, когда нужно только найти элемент и прочитать его описание. Для приоритета, ответственных, дат, story points, пользовательских полей и шагов теста вызывайте get_item_details.

Get Item

Параметры

itemIdintegerобязательный
Числовой идентификатор элемента (рабочего элемента)

get_item_comments

Получить все комментарии (ветку обсуждения) для элемента Codebeamer.

Получить комментарии элемента

Параметры

itemIdintegerобязательный
Числовой идентификатор элемента

get_item_details

Получает полную структурированную информацию о рабочем элементе Codebeamer: проект, приоритет, назначенные лица, временные метки создания/обновления, story points, пользовательские поля и тестовые шаги. Описание намеренно опущено - получите его через get_item.

Получить сведения об элементе

Параметры

itemIdintegerобязательный
Числовой идентификатор элемента (рабочего элемента)

get_item_references

Получить ссылки на восходящую и нисходящую трассировку для элемента Codebeamer. Восходящие ссылки указывают на элементы, от которых произведён данный элемент (например, требования). Нисходящие ссылки указывают на элементы, произведённые из данного (например, тестовые сценарии).

Получить ссылки на элемент

Параметры

itemIdintegerобязательный
Числовой идентификатор элемента

get_item_relations

Получает все связи (ассоциации) для элемента Codebeamer. Показывает входящие и исходящие ссылки, такие как 'depends on', 'blocks', 'derived from' и т.д.

Получить связи элементов

Параметры

itemIdintegerобязательный
Числовой идентификатор элемента

get_item_reviews

Получает все рецензии Review Hub для элемента трекера Codebeamer. Показывает общий результат проверки (APPROVED/REJECTED/UNDECIDED), голоса отдельных рецензентов и настройки проверки (требуемые одобрения/отклонения).

Получить отзывы о товаре

Параметры

itemIdintegerобязательный
Числовой идентификатор элемента

get_project

Получает полные сведения об одном проекте Codebeamer по его числовому идентификатору.

Получить проект

Параметры

projectIdintegerобязательный
Числовой идентификатор проекта Codebeamer

get_tracker

Получить сведения о трекере Codebeamer, включая схему его полей. Список полей показывает, какие поля доступны для элементов в этом трекере, что полезно при составлении cbQL-запросов.

Получить трекер

Параметры

trackerIdintegerобязательный
Числовой идентификатор трекера.

get_user

Получает детали профиля пользователя Codebeamer по его числовому идентификатору. Идентификаторы пользователей появляются в полях элементов, таких как assignedTo и createdBy.

Получить пользователя

Параметры

userIdintegerобязательный
Числовой ID пользователя

list_projects

Перечислить все проекты Codebeamer, доступные аутентифицированному пользователю. Возвращает сводную таблицу с идентификаторами проектов, названиями и ключами. Используйте полученные идентификаторы для получения трекеров или элементов.

Список проектов

Параметры

pageinteger
Номер страницы (начинается с 1)
pageSizeinteger
Элементов на странице (макс. 100)

list_tracker_items

Выводит список всех элементов в указанном трекере Codebeamer с пагинацией. Возвращает таблицу с ID элементов, краткими описаниями, статусами и приоритетами.

Список элементов трекера

Параметры

pageinteger
Номер страницы (начинается с 1)
pageSizeinteger
Элементов на странице (макс. 100)
trackerIdintegerобязательный
Числовой идентификатор трекера.

list_trackers

Выведи все трекеры (Requirements, Bugs, Test Cases и т.д.) в проекте Codebeamer. Используй полученные ID трекеров, чтобы вывести элементы или получить детали трекера.

Список трекеров

Параметры

pageinteger
Номер страницы (начинается с 1)
pageSizeinteger
Элементов на странице (макс. 100)
projectIdintegerобязательный
Числовой идентификатор проекта.

search_items

Ищет элементы Codebeamer с помощью языка запросов cbQL. Примеры: 'tracker.id IN (42) AND status.name = "Open"', 'summary LIKE "login bug"', 'priority.name = "High" AND assignedTo.name = "john.doe"', 'project.id IN (1) AND modifiedAt >= -1w'. Используйте get_tracker, чтобы увидеть доступные поля для трекера.

Search Items (cbQL)

Параметры

pageinteger
Номер страницы (начинается с 1)
pageSizeinteger
Элементов на странице (макс. 100)
querystringобязательный
Строка запроса cbQL

update_item

Обновляет поля существующего рабочего элемента Codebeamer. Укажите только те поля, которые хотите изменить. Возвращает обновлённый элемент со всеми полями.

Обновить элемент

Параметры

assignedToIdsinteger[]
Новый массив идентификаторов назначенных пользователей (заменяет текущий)
descriptionstring
Новое описание (обычный текст или вики-разметка)
itemIdintegerобязательный
Числовой идентификатор элемента для обновления.
namestring
Новое краткое описание / заголовок
priorityIdinteger
Новый ID приоритета
statusIdinteger
Новый идентификатор статуса
storyPointsinteger
Новая оценка story points.

`0.5.2`основная	28.05.2026
`0.5.1`	13.05.2026
`0.5.0`	06.05.2026
`0.4.1`	15.04.2026
`0.4.0`	15.04.2026
`0.3.0`	11.04.2026
`0.2.2`	19.03.2026
`0.2.0`	16.03.2026
`0.1.0`	15.03.2026

Выберите клиент, чтобы установить 3KniGHtcZ/codebeamer-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "3knightcz-codebeamer-mcp-mwlxrjwsc1": {
      "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"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "3knightcz-codebeamer-mcp-mwlxrjwsc1": {
      "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"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "3knightcz-codebeamer-mcp-mwlxrjwsc1": {
      "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"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"3knightcz-codebeamer-mcp-mwlxrjwsc1\",\"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

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "3knightcz-codebeamer-mcp-mwlxrjwsc1": {
      "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 Code

Добавьте сервер одной командой в терминале:

claude mcp add 3knightcz-codebeamer-mcp-mwlxrjwsc1 --env CB_URL=https://your-instance.example.com/cb/api --env CB_USERNAME=your_username --env CB_PASSWORD=your_password -- npx -y codebeamer-mcp

Либо через JSON-конфиг:

claude mcp add-json 3knightcz-codebeamer-mcp-mwlxrjwsc1 "{\"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\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add 3knightcz-codebeamer-mcp-mwlxrjwsc1 --env CB_URL=https://your-instance.example.com/cb/api --env CB_USERNAME=your_username --env CB_PASSWORD=your_password -- npx -y codebeamer-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.3knightcz-codebeamer-mcp-mwlxrjwsc1]
command = "npx"
args = ["-y", "codebeamer-mcp"]

[mcp_servers.3knightcz-codebeamer-mcp-mwlxrjwsc1.env]
CB_URL = "https://your-instance.example.com/cb/api"
CB_USERNAME = "your_username"
CB_PASSWORD = "your_password"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите 3KniGHtcZ/codebeamer-mcp, а в поле команды запуска — строку ниже:

npx -y codebeamer-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "3knightcz-codebeamer-mcp-mwlxrjwsc1": {
      "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"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "3knightcz-codebeamer-mcp-mwlxrjwsc1": {
      "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"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например 3knightcz-codebeamer-mcp-mwlxrjwsc1.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: 3knightcz-codebeamer-mcp-mwlxrjwsc1
    command: npx
    args:
      - "-y"
      - "codebeamer-mcp"
    env:
      CB_URL: https://your-instance.example.com/cb/api
      CB_USERNAME: your_username
      CB_PASSWORD: your_password

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "3knightcz-codebeamer-mcp-mwlxrjwsc1": {
      "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"
      }
    }
  }
}

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx