# Codebeamer MCP connector

The Codebeamer connector brings traceability links, attachments, baselines and branches from Codebeamer into Claude, ChatGPT, Cursor and Microsoft Copilot, so each person works as themselves and every action is logged.

Source: https://elaichi.ai/connectors/codebeamer/

## Facts

| | |
| --- | --- |
| Application | Codebeamer |
| Category | Product Development |
| AI tools | 215 |
| Authentication | Connects with an API key |
| Bring your own OAuth app | No |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, Microsoft Copilot, any MCP client, and the Elaichi Agent |
| Tools advertised by name | No. Connected tools are never listed one by one, however few there are. The endpoint advertises `search_tools` and `execute_tool` instead |

## What you can ask once Codebeamer is connected

- Show the traceability links on requirement REQ-1420 and what's missing.
- Create a baseline for the braking system project before release.
- List open merge conflicts on the variant branch and summarize them.

## Connect Codebeamer in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick Codebeamer.
2. Optionally set Share with, then press Connect.
3. Paste a Codebeamer API key. One person generates a token in Codebeamer and pastes it once. Everyone else works through Share with, and never sees it.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Codebeamer tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## Codebeamer MCP connector for Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## Codebeamer MCP connector for Claude Code

Endpoint: https://api.elaichi.ai/mcp

1. In a terminal, run `claude mcp add` with the endpoint.
2. Start Claude Code and run `/mcp`.
3. Pick elaichi, then sign in and approve in the browser.

```bash
claude mcp add --transport http elaichi --scope user https://api.elaichi.ai/mcp
```

Use `--scope project` instead to share it with the repository through `.mcp.json`.

## Codebeamer MCP connector for ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web. The plugin directory lives at chatgpt.com/plugins.

## Codebeamer MCP connector for Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## Codebeamer MCP connector for Microsoft Copilot

Endpoint: https://api.elaichi.ai/mcp

1. In Copilot Studio, open your agent, then Tools, Add a tool, New tool and Model Context Protocol.
2. Paste the endpoint into Server URL, choose OAuth 2.0, then Dynamic discovery, and press Create.
3. Create a new connection, sign in and approve, then press Add to agent.
4. Under Channels, open Teams and Microsoft Copilot and make the agent available in Microsoft Copilot.

Microsoft Copilot was called Microsoft 365 Copilot. Keep the tool on end-user credentials, so each person signs in as themselves.

## Connect Codebeamer to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Every scope the client asks for starts ticked except "Delete things", which you tick yourself. Calling a Codebeamer tool needs "Use your connected apps". Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Think hard before granting Use your connected apps, which can also delete in connected apps and cannot be undone.

## What teams do with Codebeamer through Elaichi

### Link a requirement to its test after review

Systems engineering. Once a review closes, ask the agent to create the association between the requirement and the test case that covers it. The link appears in Codebeamer under your name, with no form to fill.

### Clear merge conflicts on a variant branch

Software. Ask for the open conflicts on a branch merge and a short summary of each. Walk through them one at a time instead of hunting through the conflict list by hand.

### Attach the test report to the right item

Quality. Drop the signed report onto a work item from the chat, or pull back an older attachment someone deleted by mistake. Attachment history stays visible so you can see what was replaced.

### Freeze a baseline before the audit

Compliance. Create a baseline of the project the moment the review board signs off. Later, ask who changed which traceability links since that baseline and get the history back in plain language.

### Export a deployment package for a customer

Release management. Create the deployment and its export in Codebeamer with one request, then hand the package to the customer team without opening the admin screens.

### See which links changed this sprint

Program management. Ask for the association history on a tracker and get a readable list of what was linked, unlinked or updated, and by whom, ready for the weekly status call.

## Elaichi vs Zapier MCP vs Composio for Codebeamer

All three can connect Codebeamer to an AI assistant, and all three have admin controls. They differ in where access lives and how you pay.

| What to check | Elaichi | Zapier MCP | Composio |
| --- | --- | --- | --- |
| Where the AI connects | One address for the whole organization. Endpoint: https://api.elaichi.ai/mcp | A server per member, created at sign-in. | An MCP endpoint per team, or an SDK. |
| Control over Codebeamer tools | Allow or restrict single Codebeamer tools, per role or user. | App and action restrictions on the account. | Role permissions, down to the action. |
| Record of calls | One audit entry per Codebeamer call. | A History tab of tool calls. | A log of every tool call. |
| Single sign-on | SAML or OIDC, plus SCIM, on Gold. | SAML on Enterprise. | SAML and OIDC on Enterprise. |
| Price | Free for one person; $15 per user per month on Gold. | 2 tasks per successful call. | Billed per tool call. |

Sources: Zapier MCP [docs](https://docs.zapier.com/mcp/get-started/quickstart), [security](https://docs.zapier.com/mcp/manage/security), [usage](https://docs.zapier.com/mcp/features/usage); Composio [docs](https://docs.composio.dev/docs/composio-connect), [gateway](https://composio.dev/mcp-gateway), [enterprise](https://composio.dev/enterprise), [pricing](https://composio.dev/pricing). Checked September 2026.

Longer take: [Zapier MCP alternative](/blog/zapier-mcp-alternative/) and [when you don't need an MCP gateway](/blog/when-you-dont-need-an-mcp-gateway/).

## Frequently asked questions

### How do I connect Codebeamer to Claude?

Connect Codebeamer in Elaichi by pasting the API key from your Codebeamer account; there is no OAuth application to register and no client ID or secret to generate. Then in Claude open Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp. Sign in with your Elaichi account and Codebeamer is ready to use in that chat.

### Does Codebeamer work with ChatGPT and Cursor as well as Claude?

Yes. Codebeamer is connected once in Elaichi and reached through the same endpoint, https://api.elaichi.ai/mcp, from Claude, ChatGPT, Cursor, Microsoft Copilot, any other MCP client and the Elaichi Agent. Nothing has to be set up again per client.

### What can an AI agent actually do with my Codebeamer data?

An agent can read and create traceability links between requirements, tests and work items in Codebeamer, fetch or attach files, create baselines, look at merge conflicts on a branch, and create deployments and their exports. It can also show the history of who changed a link or an attachment. Short, concrete asks such as "create a baseline for project X" work better than long paragraphs.

### Does connecting Codebeamer give the AI access to every project?

No. The connection to Codebeamer runs inside the access of the person who signed in, so projects, trackers and items they cannot see in Codebeamer stay out of reach. Elaichi can narrow that access further with roles and restrictions, but it can never widen it.

### Can my team share one Codebeamer connection?

Yes. One person connects Codebeamer in Elaichi and shares the connection with a team, and nobody else ever handles the API key. Each teammate still signs in to Elaichi as themselves, so the audit log names the actual person behind every call to Codebeamer.

### Can I stop an agent from deleting or changing things in Codebeamer?

Yes. Each Codebeamer action, such as deleting an attachment or updating an association, can be restricted on a role or on one person in Elaichi. A restricted action still shows up in Elaichi's tool search, flagged as restricted, but no client can run it, whatever the prompt says.

### What happens to a Codebeamer connection when someone leaves?

Offboarding a person in Elaichi ends their access to Codebeamer through every client at once. A shared Codebeamer connection keeps working for everyone else on the team. If you want the connection gone, disconnecting it once in Elaichi removes it from every client.

### Does the Codebeamer MCP connector work with Gemini, Codex, Claude Code or other MCP clients?

Yes. Codebeamer is reached over the same MCP endpoint every client uses, so anything that speaks MCP can call it — Gemini, Codex, Claude Code, Windsurf, Cline, Zed and OpenCode among them — alongside Claude, ChatGPT, Cursor, Microsoft Copilot, and the Elaichi Agent. The tools on offer and the access behind them are identical whichever client asks. Only the setup screen differs.

### Is Elaichi an alternative to Zapier MCP for Codebeamer?

Yes. Both let Claude, ChatGPT or Cursor use Codebeamer. Zapier MCP fits a team that already automates in Zapier, since each person signs in and acts as themselves in that account. Elaichi fits when IT wants one address for the whole company, per-tool rules by role, and a record of every Codebeamer call.

### How is Elaichi different from Composio for Codebeamer?

Composio gives AI agents tools and sign-in handling across 1,000+ apps, for developers building agents or people using an assistant, billed per tool call. Elaichi gives a company's own people governed access to Codebeamer: one address, restrictions per role or user, and $15 per user per month. Both have role permissions and a log of every call.

## All 215 Codebeamer tools

Every tool below is callable through https://api.elaichi.ai/mcp once Codebeamer is connected, subject to the toolbox it is in and the restrictions on the caller.

- **Codebeamer database master sync get current** (Sync). Get the sync time of master. Read-only.
- **Codebeamer database readonly sync get current** (Sync). Get the sync time of readonly. Read-only.
- **Create a Codebeamer association** (Create). Create a new association. Required: from.
- **Delete a Codebeamer association by ID** (Delete). Delete association. Required: id (associationId).
- **Get single Codebeamer association by ID** (Get). Get an association by id. Read-only. Required: id (associationId).
- **Update a Codebeamer association by ID** (Update). Update association settings. Required: id (associationId), from.
- **List all Codebeamer associations types** (List). Get available association types. Read-only.
- **Get single Codebeamer associations type by ID** (Get). Get association type by id. Read-only. Required: id (associationTypeId).
- **List all Codebeamer associations history** (List). Returns the change history of the specified association. Paginated (page / pageSize). Read-only. Required: association_id.
- **Delete a Codebeamer attachment by ID** (Delete). Deletes an attachment. Required: id (attachmentId).
- **Get single Codebeamer attachment by ID** (Get). Get attachment by id. Read-only. Required: id (attachmentId).
- **Get single Codebeamer attachments content by ID** (Get). Get content of an attachment by id. Read-only. Required: id (attachmentId).
- **Update a Codebeamer attachments content by ID** (Update). Update attachment. Multipart file upload: MCP clients cannot send files; use the proxy API. Required: id (attachmentId).
- **List all Codebeamer attachments history** (List). Returns the change history of the specified attachment. Paginated (page / pageSize). Read-only. Required: attachment_id.
- **Update a Codebeamer attachments restore by ID** (Update). Restore attachment to previous version. Required: id (attachmentId), version.
- **Create a Codebeamer baseline** (Create). Create a project or tracker baseline. Required: name, project.
- **Get single Codebeamer branches item by ID** (Get). Get tracker item on branch. API can be used for finding a tracker item by a branch id Read-only. Required: id (branchId), sourceItemId.
- **Create a Codebeamer changeobjects backlink** (Create). Creates backlinks for the Codebeamer child change objects to their corresponding Windchill parent change object. Required: backlinks.
- **Create a Codebeamer changeobjects child** (Create). Create local change object(s) from a remote change set. Required: description, name, oslcType, parentChangeObject, parentChangeObjectName, parentChangeObjectNumber, wcContainer, wcContainerClass, wcOrganization.
- **Create a Codebeamer deltamerge** (Create). Initiate a delta merge. Initiate a delta merge in the given project between the given source and the target stream Required: projectId, sourceStreamId, sourceToBaselineId, targetStreamId.
- **Get single Codebeamer deltamerge conflicts item by ID** (Get). Get the list of merge conflicts of an item. Read-only. Required: id (globalUniqueItemId).
- **Get single Codebeamer deltamerge conflicts stream by ID** (Get). Get the list of merge conflicts in a stream. Read-only. Required: id (streamId).
- **Create a Codebeamer deployment** (Create). Start a deployment process. Multipart file upload: MCP clients cannot send files; use the proxy API. Required: imports.
- **Create a Codebeamer deployment export** (Create). Export projects for deployment.
- **Create a Codebeamer export export to word** (Create). Exports items to Word. API can be used for exporting items to Word Required: currentItemId, exportTargetTrackerId, wordFilename.
- **List all Codebeamer export items** (List). Get tracker items. API can be used for fetching basic information of tracker items Read-only.
- **Create a Codebeamer export tracker item review** (Create). Get tracker item reviews by a list of tracker item IDs.
- **List all Codebeamer items attachments content** (List). Get attachments of tracker items matching the extension or mime type filters. Read-only.
- **Items attachments content get tracker item attachment contents** (Get). Get attachments of a tracker item. Read-only. Required: item_id.
- **Items attachments content get tracker item attachment content** (Get). Get content of an attachment of tracker item by id. Read-only. Required: item_id, attachment_id.
- **Update a Codebeamer items attachments content by ID** (Update). Update content of attachment of tracker item. Multipart file upload: MCP clients cannot send files; use the proxy API. Required: id (attachmentId), item_id.
- **Codebeamer items fields update current** (Update). Bulk update fields of a tracker item.
- **List all Codebeamer items fields** (List). Get fields of a tracker item. Read-only. Required: item_id (itemId).
- **Update a Codebeamer items field by ID** (Update). Update fields of a tracker item. Required: id (itemId).
- **Create a Codebeamer items move** (Create). Move Tracker Items from the Source Tracker to the Target Tracker. Move Tracker Items from the Source Tracker to the Target Tracker. The items are optional, if it is not provided all the Tracker Items will be moved from the Source Tracker. All the fields from the Source Tracker must be in the mapping. If you want to ignore one you set the targetField to null in the request. Required: fieldMapping, sourceTracker, targetTracker.
- **Codebeamer items move field mapping get current** (Move). Gets the default field mapping between two trackers. Read-only. Required: sourceTrackerId, targetTrackerId.
- **List all Codebeamer items query** (List). Get tracker items by cbQL query string. Paginated (page / pageSize). Read-only. Required: queryString.
- **Codebeamer items query search** (Search). Get tracker items by cbQL query string. API can be called with a complex cbQL string to find tracker items Paginated (page / pageSize). Read-only. Required: queryString.
- **Codebeamer items relations get baseline tracker items relations** (Get). Get tracker items related to some tracker items. Use this endpoint to fetch tracker items related to some specified tracker items. The relations include downstream references, upstream references, incoming associations and outgoing associations of the given items. Relations with entities that are not tracker items (e.g., trackers, projects, URLs, etc.) will not be included in the result.
- **Codebeamer items relations get baseline tracker item relations** (Get). Get tracker items related to a tracker item. Use this endpoint to fetch tracker items related to a specified tracker item. The relations include downstream references, upstream references, incoming associations and outgoing associations of the given item. Relations with entities that are not tracker items (e.g., trackers, projects, URLs, etc.) will not be included in the result. Read-only. Required: item_id.
- **Create a Codebeamer items review** (Create). Create review by tracker items. Required: reviewName, reviewSettings.
- **Delete a Codebeamer item by ID** (Delete). Move tracker item to trash. Required: id (itemId).
- **Get single Codebeamer item by ID** (Get). Get basic tracker item. API can be used for fetching basic information of a tracker item Read-only. Required: id (itemId).
- **Update a Codebeamer item by ID** (Update). Update tracker item. Required: id (itemId).
- **Codebeamer items attachments delete tracker item attachments** (Delete). Delete attachments of tracker item. Required: item_id.
- **Codebeamer items attachments get tracker item attachments** (Get). Get attachments of tracker item. Read-only. Required: item_id.
- **Create a Codebeamer items attachment** (Create). Upload an attachment to a tracker item. Multipart file upload: MCP clients cannot send files; use the proxy API. Required: item_id.
- **Codebeamer items attachments delete tracker item attachment** (Delete). Delete attachment of tracker item by id. Required: item_id, attachment_id.
- **Codebeamer items attachments get tracker item attachment** (Get). Get attachment of tracker item by id. Read-only. Required: item_id, attachment_id.
- **List all Codebeamer items children** (List). Get child items of a tracker item. Paginated (page / pageSize). Read-only. Required: item_id.
- ...and 165 more tools. Call `tools/list` via the MCP endpoint, or see the full catalog via the API, for the complete set.
