codebeamer-mcp

Un servidor MCP (Model Context Protocol) para Codebeamer ALM. Permite a Claude y a otros clientes MCP leer y escribir proyectos, rastreadores y elementos en Codebeamer utilizando lenguaje natural.

codebeamer-mcp MCP server

Herramientas (18)

Lectura

Herramienta	Descripción
`list_projects`	Listar todos los proyectos
`get_project`	Obtener detalles del proyecto
`list_trackers`	Listar rastreadores en un proyecto
`get_tracker`	Obtener detalles del rastreador
`list_tracker_items`	Listar elementos en un rastreador
`search_items`	Búsqueda de texto completo / cbQL
`get_item`	Obtener detalles del elemento, incluidos los pasos de prueba (acción + resultado esperado) para elementos de caso de prueba
`get_item_relations`	Obtener asociaciones salientes/entrantes (depende de, bloquea, …)
`get_item_references`	Obtener referencias de trazabilidad ascendente/descendente (derivado de, cubre, …)
`get_item_comments`	Obtener comentarios del elemento
`get_item_reviews`	Obtener revisiones del Review Hub para un elemento (resultado, revisores, votos)
`get_user`	Obtener detalles del usuario

Escritura

Herramienta	Descripción
`create_item`	Crear un nuevo elemento en un rastreador. Admite carpetas, tipo de elemento y anidamiento principal
`update_item`	Actualizar un elemento existente (nombre, descripción, estado, prioridad, asignado, campos personalizados)
`add_comment`	Añadir un comentario a un elemento
`create_association`	Crear una asociación entre dos elementos (p. ej., depende de, bloquea)
`create_reference`	Añadir una referencia de trazabilidad descendente entre dos elementos
`create_harm`	Crear una entrada de daño en un rastreador de Lista de Daños RM con código IMDRF y gravedad (1–5)

Instalación

Requisitos

Node.js 20+
Acceso a una instancia de Codebeamer (URL, nombre de usuario, contraseña)

Claude Code (CLI)

La forma más rápida: ejecuta este comando en tu terminal:

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

O añádelo manualmente a .mcp.json en la raíz del proyecto (o ~/.claude/mcp.json para el ámbito global):

{
  "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

Edita el archivo de configuración para tu plataforma:

Plataforma	Ruta
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"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar.

Cursor

Añadir a .cursor/mcp.json en la raíz del proyecto (ámbito del proyecto) o ~/.cursor/mcp.json (global):

{
  "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

Añadir a ~/.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)

Añadir a .vscode/mcp.json en la raíz del proyecto:

{
  "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

Añadir a ~/.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"
      }
    }
  }
}

Alternativa: instalación global

npm install -g codebeamer-mcp

Luego usa "command": "codebeamer-mcp" (sin args) en lugar de npx en cualquier configuración anterior.

Fijar una versión específica

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

Actualizaciones

Método	Comportamiento de actualización
`npx -y codebeamer-mcp`	Siempre obtiene la última versión
`npm install -g codebeamer-mcp`	Se mantiene en la versión instalada. Ejecuta `npm update -g codebeamer-mcp` para actualizar
Versión fijada (`@0.2.0`)	Nunca se actualiza automáticamente; cambia la cadena de versión manualmente

⚠️ Nunca confirmes .mcp.json con credenciales reales — está listado en .gitignore.

Desde el código fuente (desarrollo)

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

Luego usa "command": "node" con "args": ["dist/index.js"] en tu .mcp.json.

Desarrollo y pruebas

# 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

Configuración

Variable	Descripción	Predeterminado
`CB_URL`	URL de la API de Codebeamer, p. ej. `https://your-instance.example.com/cb/api` (el servidor añade `/v3` automáticamente)	(requerido)
`CB_USERNAME`	Nombre de usuario de inicio de sesión	(requerido)
`CB_PASSWORD`	Contraseña	(requerido)
`CB_UNSAFE_SSL`	Establecer en `true` para permitir conexiones a servidores con certificados no verificados/autofirmados	`false`
`CB_API_VERSION`	Versión de la API	`v3`
`CB_TIMEOUT_MS`	Tiempo de espera de la solicitud (ms)	`30000`
`CB_MAX_ITEMS`	Máximo de elementos por página	`100`

codebeamer-mcp

codebeamer-mcp

Herramientas (18)

Lectura

Escritura

Instalación

Requisitos

Claude Code (CLI)

Claude Desktop

Cursor

Windsurf

VS Code (Copilot)

Gemini CLI

Alternativa: instalación global

Fijar una versión específica

Actualizaciones

Desde el código fuente (desarrollo)

Desarrollo y pruebas

Configuración

Resources

Tools

Latest Blog Posts

MCP directory API