> ## Documentation Index
> Fetch the complete documentation index at: https://docs.overcut.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira Cloud on Overcut Cloud (Forge app)

> Connect Jira Cloud to Overcut's managed service by installing the Overcut Forge app.

Use this path when you use **Overcut's managed service** (Overcut Cloud) and your
Jira is **Atlassian-hosted Jira Cloud** (`https://<your-company>.atlassian.net`).
You install the Overcut Forge app from the Atlassian Marketplace; there are no
credentials to manage.

<Note>
  Not your setup? See [Which setup do I need?](/docs/integrations/jira#which-setup-do-i-need)
  to choose between Overcut Cloud, self-hosted Overcut, and Jira Server / Data
  Center.
</Note>

## Prerequisites

* An **Atlassian Jira Cloud** workspace (`https://<your-company>.atlassian.net`)
* Admin permissions in your Jira workspace
* An active Overcut Cloud workspace

## Connect

<Steps>
  <Step title="Start Jira Connection">
    In your Overcut workspace, go to **Integrations** and click **Connect Jira**.
  </Step>

  <Step title="Install the Overcut App in Jira">
    Click **Install Overcut App** to be redirected to your Jira instance. Install the app and grant the necessary permissions. If you've already installed the app, click **I've Installed the App** to proceed.
  </Step>

  <Step title="Complete the Setup">
    After installing the app, you'll be prompted to enter your Jira site domain (e.g., `my-org.atlassian.net`). Enter your domain and click **Complete Install** to finalize the connection.
  </Step>
</Steps>

The Forge app manages authentication, permissions, and event delivery for you.
There is no OAuth app to create, no callback URL to configure, and no webhook to
register.

## Permissions

The Overcut Forge app requests read and write access to projects, issues, and
comments, and permission to add comments to existing issues. You grant these when
you install the app.

## Troubleshooting

* **App not installed**: complete the Marketplace install in Jira first, then
  click **I've Installed the App** in Overcut.
* **Wrong site domain**: make sure the domain you enter matches your site exactly
  (`my-org.atlassian.net`, no `https://` prefix and no trailing path).
* **Missing projects**: the integration only shows projects your Jira account can
  access. Check your Jira user permissions for the specific projects.

For concepts shared across all Jira setups (issue operations, status-name rules,
ticket links), see the [Jira overview](/docs/integrations/jira).