[2026-03-03] CCA for Jira [1P Solution]: [Public Preview] (#59843)

Co-authored-by: Siara <108543037+SiaraMist@users.noreply.github.com>

Author: vgrl

content/copilot/how-tos/use-copilot-agents/coding-agent/index.md

@@ -14,6 +14,7 @@ children:
   - /test-custom-agents
   - /create-skills
   - /extend-coding-agent-with-mcp
+  - /integrate-coding-agent-with-jira
   - /integrate-coding-agent-with-slack
   - /integrate-coding-agent-with-teams
   - /integrate-coding-agent-with-linear

content/copilot/how-tos/use-copilot-agents/coding-agent/integrate-coding-agent-with-jira.md

@@ -0,0 +1,117 @@
+---
+title: Integrating Copilot coding agent with Jira
+shortTitle: Integrate coding agent with Jira
+intro: 'You can use the {% data variables.product.github %} integration in Jira to provide context and open pull requests, all from within your Jira workspace.'
+versions:
+  feature: copilot
+redirect_from:
+  - /early-access/copilot/integrate-coding-agent-with-jira
+contentType: how-tos
+category:
+  - Integrate Copilot with your tools
+---
+
+> [!NOTE]
+> This feature is currently in {% data variables.release-phases.public_preview %} and subject to change.
+
+The {% data variables.product.prodname_copilot %} integration in Jira allows you to invoke {% data variables.copilot.copilot_coding_agent %} without leaving your Jira workspace. From within a Jira work item you can initiate {% data variables.copilot.copilot_coding_agent_short %} sessions and open pull requests, using the context of the work item's title, description, labels, and comments.
+
+## Prerequisites
+
+* You must have a {% data variables.product.github %} account with access to {% data variables.product.prodname_copilot_short %} through {% data variables.copilot.copilot_pro_short %}, {% data variables.copilot.copilot_pro_plus_short %}, {% data variables.copilot.copilot_business_short %}, or {% data variables.copilot.copilot_enterprise_short %}.
+* You must have a Jira Cloud account with [AI features enabled](https://support.atlassian.com/organization-administration/docs/activate-atlassian-intelligence-for-products).
+* Installation and authentication must be completed for both Jira and {% data variables.product.github %}.
+
+## Installation
+
+To install the {% data variables.product.prodname_copilot %} for Jira app and authorize it for your {% data variables.product.github %} organization or enterprise account, you need:
+
+* Administrator permission for your Jira site.
+* Owner or {% data variables.product.github %} App manager permissions for your {% data variables.product.github %} organization.
+
+This integration relies on an Atlassian Forge application and a {% data variables.product.github %} application. Both are required for the integration. Once successfully installed, authorized users of the Jira workspace with **write** access to a {% data variables.product.github %} repository will be able to trigger the agent from Jira.
+
+### Installing the {% data variables.product.prodname_copilot %} for Jira app for {% data variables.product.prodname_dotcom_the_website %}
+
+1. Navigate to the [{% data variables.product.prodname_copilot %} for Jira installation page](https://marketplace.atlassian.com/apps/1582455624?ref_product=copilot&ref_type=engagement&ref_style=text) on the Atlassian Marketplace.
+1. Click **Get app**.
+1. Select the Atlassian instance you want to install the {% data variables.product.github %} application in.
+1. Click **Install**.
+1. If you are not automatically redirected, go to the [{% data variables.product.prodname_copilot %} for Jira installation page](https://github.com/apps/github-copilot-for-jira?ref_product=copilot&ref_type=engagement&ref_style=text) on the {% data variables.product.prodname_marketplace %} and click **Install**.
+1. In the **Install {% data variables.product.prodname_copilot %} for Jira** page, select the organization and repositories you would like to give the application access to.
+    * You can add additional organizations after the app is installed, see [Adding an organization to the {% data variables.product.prodname_copilot %} for Jira app](#adding-an-organization).
+1. Click **Install**.
+
+### Installing the {% data variables.product.prodname_copilot %} for Jira app for {% data variables.enterprise.data_residency_site %}
+
+1. Navigate to the [{% data variables.product.prodname_copilot %} for Jira (GHEC with Data Residency) installation page](https://marketplace.atlassian.com/apps/3637796809?ref_product=copilot&ref_type=engagement&ref_style=text) on the Atlassian Marketplace.
+1. To the right of the app name, click {% octicon "kebab-horizontal" aria-label="Configure" %}, and enter your `SUBDOMAIN.ghe.com` in the text box. Replace SUBDOMAIN with your enterprise's subdomain of {% data variables.enterprise.data_residency_site %}.
+1. Click **Save configuration**.
+1. Click **Get app**.
+1. Select the Atlassian instance you want to install the {% data variables.product.github %} application in.
+1. Click **Install**.
+1. If you are not automatically redirected, find the {% data variables.product.prodname_copilot %} for Jira app in the list of apps available to your enterprise at `SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira`.
+1. Click **Install**.
+1. In the **Install {% data variables.product.prodname_copilot %} for Jira** page, select the organization and repositories you would like to give the application access to.
+    * You can add additional organizations after the app is installed, see [Adding an organization to the {% data variables.product.prodname_copilot %} for Jira app](#adding-an-organization).
+1. Click **Install**.
+
+## Adding an organization to the {% data variables.product.prodname_copilot %} for Jira app
+
+Once the {% data variables.product.prodname_copilot %} for Jira app has been installed, a Jira administrator and {% data variables.product.github %} organization owner can enable additional organizations to use the app. This allows any member of the organization to connect their {% data variables.product.github %} account to the app and start using it in Jira.
+
+To enable the {% data variables.product.prodname_copilot %} for Jira app for an organization:
+
+1. In Jira, go to the settings page for your space.
+1. Go to the applications setting page for the {% data variables.product.prodname_copilot %} app.
+1. Optionally, click **Connect More {% data variables.product.github %} Organizations** to add new organizations to the list.
+1. Enable the {% data variables.product.prodname_copilot_short %} app for one or more of the listed organizations.
+
+## Using the {% data variables.product.prodname_copilot %} app in Jira
+
+The {% data variables.product.prodname_copilot_short %} app must be enabled for a {% data variables.product.github %} organization you are a member of, before you can start using it.
+
+The first time you use {% data variables.copilot.copilot_coding_agent %} in Jira, you will need to connect it to your {% data variables.product.github %} account.
+
+Only users with **write** access to a repository can trigger {% data variables.copilot.copilot_coding_agent %} to work in that repository.
+
+> [!NOTE]
+> When you assign {% data variables.product.prodname_copilot_short %} to a Jira work item, the context the agent captures from Jira will be added to the pull request and **visible to everyone** if the repository is public.
+
+1. In Jira, open or create a work item that contains clear requirements you want to delegate to {% data variables.copilot.copilot_coding_agent %}.
+1. To specify a repository you want {% data variables.product.prodname_copilot_short %} to work in, mention it in the work item description or in a comment.
+1. Assign `{% data variables.product.prodname_copilot %}` to the work item, or mention `@{% data variables.product.prodname_copilot %}` in a comment. For example:
+
+    ```text
+   @{% data variables.product.prodname_copilot %} create a new API endpoint for user authentication in octo-org/octorepo
+    ```
+
+1. If you have not previously connected the {% data variables.product.github %} application in Jira to your {% data variables.product.github %} account, follow the prompts to authorize the application for both {% data variables.product.github %} and Atlassian.
+1. Once {% data variables.copilot.copilot_coding_agent %} has started working on the pull request, a comment will appear in the Jira work item. The user who initiated the agent session can view progress updates for the agent.
+1. You can follow up with further instructions for {% data variables.product.prodname_copilot_short %} in a work item:
+    * Mention `@{% data variables.product.prodname_copilot %}` in a comment.
+    * Use the **Continue in Chat** button under the **Agents** heading to chat directly with {% data variables.product.prodname_copilot_short %}.
+
+> [!TIP]
+> If you have not received confirmation of triggering {% data variables.copilot.copilot_coding_agent %} after 1 minute, refresh the Jira work item page.
+
+## Usage costs
+
+{% data variables.copilot.copilot_coding_agent %} uses {% data variables.product.prodname_actions %} minutes and {% data variables.product.prodname_copilot_short %} premium requests.
+
+Within your monthly usage allowance for {% data variables.product.prodname_actions %} and premium requests, you can ask {% data variables.copilot.copilot_coding_agent %} to work on coding tasks without incurring any additional costs.
+
+For more information, see [AUTOTITLE](/billing/concepts/product-billing/github-copilot-premium-requests#usage-by-copilot-coding-agent).
+
+## Troubleshooting
+
+### {% data variables.product.prodname_copilot %} is not responding
+
+* Check {% data variables.product.github %}'s [Status page](https://githubstatus.com) for any active incidents.
+* Verify that {% data variables.copilot.copilot_coding_agent %} has access to the repository by testing if you can assign {% data variables.product.prodname_copilot_short %} to an issue on {% data variables.product.github %}. See [AUTOTITLE](/copilot/concepts/agents/coding-agent/access-management).
+* Verify that the {% data variables.product.prodname_copilot %} for Jira application has access to the repository. See [AUTOTITLE](/apps/using-github-apps/reviewing-and-modifying-installed-github-apps#modifying-repository-access).
+
+## Further reading
+
+* [AUTOTITLE](/copilot/concepts/coding-agent/coding-agent)
+* [AUTOTITLE](/copilot/concepts/coding-agent/enable-coding-agent)

content/copilot/responsible-use/copilot-coding-agent.md

@@ -9,7 +9,7 @@ redirect_from:
   - /copilot/responsible-use-of-github-copilot-features/responsible-use-of-copilot-coding-agent-on-githubcom
   - /copilot/responsible-use-of-github-copilot-features/copilot-coding-agent
 contentType: rai
-category: 
+category:
   - Responsible use
 ---
 
@@ -167,7 +167,7 @@ Users need to evaluate potential specific legal and regulatory obligations when
 
 ## External integrations with Copilot coding agent
 
-{% data variables.copilot.copilot_coding_agent %} can receive information and context from external applications like Microsoft Teams, Linear, and Slack. When you mention the external application in these platforms or assign a task to the coding agent via a connected workflow, it can access relevant context, such as conversation history in threads where it’s mentioned or issue details and activity timelines. This allows the coding agent to better understand your development needs and provide more relevant assistance. These integrations enable teams to collaborate on code, assign tasks, and track progress directly within their existing workflows, without switching tools. Ensure your team understands what information is being shared and configure integrations according to your organization’s privacy and data handling policies.
+{% data variables.copilot.copilot_coding_agent %} can receive information and context from external applications like Microsoft Teams, Linear, Slack, and Jira. When you mention the external application in these platforms or assign a task to the coding agent via a connected workflow, it can access relevant context, such as conversation history in threads where it’s mentioned or issue details and activity timelines. This allows the coding agent to better understand your development needs and provide more relevant assistance. These integrations enable teams to collaborate on code, assign tasks, and track progress directly within their existing workflows, without switching tools. Ensure your team understands what information is being shared and configure integrations according to your organization’s privacy and data handling policies.
 
 For more information about external integrations with {% data variables.copilot.copilot_coding_agent %}, see:
 * [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/integrate-coding-agent-with-teams)