Connect Jira to Test Companion

In Visual Studio Code, Test Companion searches, reads, creates, and updates Jira issues through the Atlassian MCP server. You name the issue in chat. Test Companion asks for your approval before it fetches the issue.

Prerequisites for the MCP server

Ensure you have the following:

• Test Companion is installed in Visual Studio Code and you are signed in.
• An Atlassian account with access to the Jira projects you want to use.

Connect the Atlassian MCP server

To connect the server:

1. Click ... (more options) on the Test Companion panel, then select MCP Servers.

2. Select the Catalog tab, then click Connect on the Atlassian card.

   

3. Sign in with your Atlassian account in the browser and grant the requested access, then return to your IDE. The Installed tab shows the server with a green dot and its tool count.

For the controls of a connected server, see Atlassian in Connect an MCP server to Test Companion.

Use Jira issues in chat

To work with an issue:

1. Describe the task and name the issue by its key. For example: Get Jira issue SHOP-231 and generate test cases for its acceptance criteria.
2. When the approval card appears, click Approve.

Test Companion reads the issue and continues the task. Your Jira permissions apply, so it reaches only the projects your account can open.

You can also paste a Jira ticket link in chat. A pasted link uses the BrowserStack integration described in the Other IDEs tab, not the MCP server.

Raise Jira issues in chat

Describe the bug and ask for the issue. For example: Create a bug in the SHOP project for each failed test in this run. Test Companion drafts the issue and shows an approval card for the create call. Nothing reaches Jira until you approve.

In JetBrains IDEs, Visual Studio, and Eclipse, Test Companion reaches Jira through the BrowserStack integration. You paste a ticket link in chat, and Test Companion raises Jira issues for the bugs it finds. This route also works in Visual Studio Code.

Prerequisites for the integration

Ensure you have the following:

• Test Companion is installed in your IDE and you are signed in.
• Your Jira account is connected through the Jira integration flow.
• You have access to the Jira ticket in your browser.

Use Jira ticket links in Test Companion chat

After you connect Jira, use Jira links directly in the Test Companion chat:

1. Open Test Companion in your IDE.

2. Paste one or more Jira ticket links in the chat message.

   

3. Enter your prompt, and state what you want Test Companion to do with the tickets.

   For tips on writing an effective prompt, see the Prompt guide.

4. Click Send message.

If the task stopped because Jira was not connected, complete the Jira integration flow and send the same prompt again.

Fields Test Companion reads from Jira

Share a ticket by pasting its link in the chat, or by typing its issue key. Test Companion then reads these fields:

Custom fields

Your organization can add its own fields to Jira, beyond the standard fields. These are called custom fields. Test Companion reads the standard fields on every ticket. It also reads the custom fields you select. Custom fields matter when the user story, the acceptance criteria, or the scope sits in a custom field and the standard Description is empty. The Jira Key details panel holds fields like these.

Test Companion asks which fields to include and remembers your choice for that project:

1. Share a ticket in the chat and send your prompt.

2. In the card that appears, select each field you want Test Companion to read.

   To find a field by name, enter the name in the Search fields box. Click Select all to select every field, or Clear to start again.

   

3. Click Save.

Test Companion confirms your choice in the chat, such as 4 of 53 fields added, and then continues with your prompt. The next ticket from that project uses the same fields, so the card does not appear again.

Raise Jira issues from Test Companion

When you find a bug, turn it into a Jira issue without leaving your IDE. Test Companion writes the draft from the details it already has, so the card opens with the title, the description, and the priority filled in. You review that draft. Test Companion then files the issue in the project you choose. Nothing reaches Jira until you confirm.

Start a draft

There are two ways to start:

• Ask in the chat. Describe the bug and ask Test Companion to file it, for example, Raise a Jira issue for this failure. Ask for more than one issue in the same message when you need to.
• Accept the offer. Test Companion tracks the defects it finds while it runs a task, such as failure analysis, exploratory testing, or an accessibility scan. When the task finishes, it offers to raise those findings.

Either way, you get the same review card.

Review and file the issue

Test Companion shows a Raise Jira issue card with a drafted issue on each tab, such as Issue #1 and Issue #2.

To change a draft without editing the card, ask for the change in the chat.

After the last tab, Test Companion lists every issue it created. Each entry shows the issue key, a link that opens the issue in Jira, and a Copy button.

Fields the project requires

Some projects mark extra fields as mandatory, including custom fields such as Severity, Components, or Sprint. Test Companion fills in the values it already has and asks you for the rest. Where a field has fixed choices, you select from the allowed values instead of typing.

Test Companion checks these fields before it files the issue. That way you do not hit a missing-field error after you submit. If your account lacks permission to create issues in that project, Test Companion tells you on the card.

Details in the filed issue

Test Companion fills the standard Jira fields and puts the rest of the context in the description:

Turn off the offer to raise issues

To stop the offer when a task finishes, click Do not show this again on the card. To raise an issue after that, ask for one in the chat. Asking turns the offer back on.