codebeamer-mcp

MCP-сервер (Model Context Protocol) для Codebeamer ALM. Позволяет 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`	Создать запись о вреде в трекере RM Harms List с кодом IMDRF и степенью тяжести (1–5)

Установка

Требования

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

Затем используйте "command": "codebeamer-mcp" (без args) вместо npx в любой из конфигураций выше.

Закрепление конкретной версии

"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

Затем используйте "command": "node" с "args": ["dist/index.js"] в вашем .mcp.json.

Разработка и тестирование

# 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`	URL API Codebeamer, например `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`	Тайм-аут запроса (мс)	`30000`
`CB_MAX_ITEMS`	Макс. количество элементов на страницу	`100`

codebeamer-mcp

codebeamer-mcp

Инструменты (18)

Чтение

Запись

Установка

Требования

Claude Code (CLI)

Claude Desktop

Cursor

Windsurf

VS Code (Copilot)

Gemini CLI

Альтернатива: глобальная установка

Закрепление конкретной версии

Обновления

Из исходного кода (разработка)

Разработка и тестирование

Конфигурация

Resources

Tools

Latest Blog Posts

MCP directory API