> ## 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.

# Bitbucket Cloud on Overcut Cloud (Forge app)

> Connect Bitbucket 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
Bitbucket is **Atlassian-hosted Bitbucket Cloud** (`bitbucket.org`). You install
the Overcut Forge app; there are no credentials to manage.

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

## Prerequisites

* A **Bitbucket Cloud** workspace
* Admin permissions in your Bitbucket workspace
* An active Overcut Cloud workspace

## Connect

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

  <Step title="Install the Overcut App in Bitbucket">
    Click **Install Overcut App** to be redirected to your Bitbucket workspace. 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 Bitbucket workspace name (e.g., `my-org`). Enter your workspace name 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 consumer to create, no callback URL to configure, and no
webhook to register.

## Permissions

The Overcut Forge app requests access to your repositories, pull requests, and
pipelines, and the ability to manage webhooks. You grant these when you install
the app.

## Troubleshooting

* **App not installed**: complete the Marketplace install in Bitbucket first,
  then click **I've Installed the App** in Overcut.
* **Wrong workspace name**: make sure the workspace name you enter matches your
  workspace slug exactly (for example `my-org`).
* **Missing repositories**: the integration only shows repositories the app can
  access. Check the app's grant in your workspace settings.

For concepts shared across all Bitbucket setups (pull request operations, webhook
behavior, ticket links), see the [Bitbucket overview](/docs/integrations/bitbucket).