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

# Bitbucket Cloud

> This guide explains how to set up Qodo Context Engine with Bitbucket Cloud.

## Limitations

| **Capability**                   | **Status**    | **Notes**                                                                                                                                                                               |
| :------------------------------- | :------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Free/Standard tiers              | Not supported | workspace access tokens are only supported in Premium plan.                                                                                                                             |
| Choose individual repos to index | Not supported | Qodo Context Engine will index **all** repositories the token can see. If you need to limit scope, create a token tied to a workspace / user that has access only to the desired repos. |
| Webhooks / Marketplace app       | N/A           | Bitbucket Cloud integration is **token-only** – no webhooks or Atlassian Connect app is required.                                                                                       |

## 1. Generate an access token

Qodo Context Engine accepts **either** a *Workspace Access Token* **or** a *Personal App Password*.

Both must have **read-only** scopes.

### Workspace access token (recommended)

**Prerequisite** – you must be a *Workspace Administrator*.

<Steps>
  <Step title="In Bitbucket, open Workspace settings ▸ Access management ▸ Access tokens." />

  <Step title="Click Create access token.">
    * **Name** – something like “context-engine”.
    * **Permissions** – tick **Repositories: Read**, **Projects: Read**, **Pull requests: Read**.
  </Step>

  <Step title="Click Create and copy the raw token immediately – Bitbucket shows it only once." />
</Steps>

### **Personal app password (alternative)**

<Steps>
  <Step title="Click your avatar ▸ Personal settings ▸ App passwords." />

  <Step title="Click Create app password and give it a meaningful label." />

  <Step title="Enable the same read-only scopes listed above, and add Workspace: Read permission">
    (`read:workspace:bitbucket`).
  </Step>

  <Step title="Generate and copy the password (it will not be shown again)." />
</Steps>

## 2. Send relevant information to Qodo

```powershell theme={null}
[bitbucket_cloud]
[bitbucket_cloud.tokens]
# Option A – workspace token
"my-workspace-name" = "XXXXXXXXXXXXXXXXXXXXXXXX"

# Option B – personal app-password
"user@example.com" = "YYYYYYYYYYYYYYYYYYYYYY"
```

### Key

| **Token type**  | **Key (left-hand-side)** | **Value (right-hand-side)**   |
| :-------------- | :----------------------- | :---------------------------- |
| Workspace token | "\<WORKSPACE\_SLUG>"     | "\<WORKSPACE\_ACCESS\_TOKEN>" |
| App password    | "\<USER\_EMAIL>"         | "\<APP\_PASSWORD>"            |