> For the complete documentation index, see [llms.txt](https://manual.dxable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.dxable.com/clickup/integrations-and-clickup-api/integrations/bitbucket-integration.md).
# Bitbucket インテグレーション
[Bitbucket ](https://clickup.com/bitbucket-integration)のコミット、ブランチ、プル リクエストをClickUpタスクと統合します。 これにより、次のことが可能になります。
* タスクに関連するすべての Bitbucket アクティビティをClickUpで直接表示します。
* オプションで、新しい Bitbucket アクティビティ項目がタスクに追加されたときに[ClickUp通知](https://help.clickup.com/hc/en-us/articles/6326004036887-Notifications-overview)を受信します。
* [ClickUpタスク](https://help.clickup.com/hc/en-us/articles/6309944875671-Task-Overview)に自動的 (または手動で) アタッチします。
* \#{taskID}\[status]という形式を使用してコミットにClickUpタスク ID を追加することで、Bitbucket アクションで[ステータス](https://help.clickup.com/hc/en-us/articles/6309452618647-Create-and-manage-custom-statuses)を自動的に変更します。例： #1abc2de\[closed]
### **必要なもの**
* Bitbucket 統合は[すべてのClickUpプラン](https://clickup.com/pricing)で利用できます。
* 統合を設定できるのは、ワークスペースの[オーナーと管理者のみ](https://help.clickup.com/hc/en-us/articles/6310033667223-User-Roles)です。
* [Guests](https://help.clickup.com/hc/en-us/articles/6310022323991-Guests-overview)はBitbucket 統合を使用できません。
### **ClickUp がBitbucket に接続することを承認する**
ClickUpと Bitbucket.org またはセルフホスト バージョンの Bitbucket を統合できます。 認証プロセスは、使用する Bitbucket のバージョンによって異なります。
* [オプション 1 ： Bitbucket.org アカウントを認証する](https://help.clickup.com/hc/en-us/articles/6305592182423-Bitbucket-integration#step-1-option-1-authorize-bitbucketcom-)
* [オプション 2 ：セルフホスト型 Bitbucket アカウントを承認する](https://help.clickup.com/hc/en-us/articles/6305592182423-Bitbucket-integration#step-1-option-2-authorize-self-hosted-bitbucket)
### **オプション 1 ：** [**Bitbucket.org**](http://bitbucket.org/)**アカウントを認証する**
{% hint style="info" %}
***注：***[*チームのスペース*](https://help.clickup.com/hc/en-us/articles/13856392825367-The-Hierarchy-overview)*にリポジトリを添付できるのはClickUp*[*管理者のみ*](https://help.clickup.com/hc/en-us/articles/6309225399703-Permissions-overview)*です。*
{% endhint %}
1. [App Center ](https://help.clickup.com/hc/en-us/articles/12580135233559-App-Center-overview)を開きます。
2. **\[Bitbucket]** をクリックします。
3. **\[Activate Bitbucket for Team]**をクリックします。
4. **\[+ Add Bitbucket]**をクリックします。
5. **\[No, I use bitbucket.com]**を選択し、**\[Link Bitbucket]**をクリックします。
6. ログインしていない場合は、Bitbucket.orgアカウントにログインするように求められます。
7. 必要な権限を確認し、**\[Grant access]**をクリックします
アカウントを承認したので、次の手順に進み、 [Bitbucket リポジトリをワークスペースに接続します](https://help.clickup.com/hc/en-us/articles/6305592182423-Bitbucket-integration#h_317574b18f)。
### **オプション 2 ：セルフホスト型**[**Bitbucket**](https://clickup.com/integrations/bitbucket)**アカウントを承認する**
セルフホスト版の Bitbucket を使用している場合は、HTTP アクセス トークンを作成してClickUpを承認できます。 [Bitbucket HTTP アクセス トークン](https://confluence.atlassian.com/bitbucketserver/personal-access-tokens-939515499.html)の詳細をご覧ください。
1. [App Center ](https://help.clickup.com/hc/en-us/articles/12580135233559-App-Center-overview)を開きます。
2. **\[Bitbucket]**をクリック
3. **\[Activate Bitbucket for Team]**をクリック
4. **\[+ Add Bitbucket]**をクリック
5. **\[Yes, I use a hosted version of Bitbucket]**を選択し、Bitbucket で次の手順に従います。
6. ホストされている Bitbucket で、右上にあるユーザー プロファイル アバターをクリックします。
7. **\[Manage account]**を選択します。
8. 左サイドバーの**\[HTTP** **access tokens]**を選択します**。**
9. **Projects**と**Repositories**の両方に対して**admin権限**を持つ新しいアクセス トークンを作成します。
10. **HTTP access token**をコピーします。
11. ClickUpに戻り、コピーしたトークンを**\[Access token]**フィールドに貼り付けます。
12. 以下の Bitbucket アカウントの詳細を入力：
* Host URL
* Canonical URL (オプション)
13. 設定を選択してください：
* ホストされたシークレットを使用しますか?
* 固定IP
14. **\[Link Bitbucket]**をクリックします。
アカウントを承認したので、次の手順に進み、 [Bitbucket リポジトリをワークスペースに接続します](https://help.clickup.com/hc/en-us/articles/6305592182423-Bitbucket-integration#h_317574b18f)。
### **Bitbucket リポジトリをワークスペースにアタッチする**
ClickUpでは[ワークスペース内で複数の人がBitbuckett認証することができ、](https://help.clickup.com/hc/en-us/articles/6309225399703-Permissions-overview)ワークスペースと共有するリポジトリをカスタマイズすることもできます。
つまり、すべてのリポジトリをアタッチしなくても個人アカウントを承認でき、アタッチするリポジトリをカスタマイズできます。
リポジトリをアタッチしても、ユーザーにリポジトリのコードベースへのアクセス権が付与されるわけでは**ありません**。 ユーザーは、指定した[スペース](https://help.clickup.com/hc/en-us/articles/6309390855319-How-to-Create-a-Space)にそのリポジトリの履歴項目を添付できるようになります。
{% hint style="info" %}
***注：**管理者アクセス権を持つ Bitbucket リポジトリのみを関連付けることができます。*
{% endhint %}
### **ステップ3 ：リポジトリに添付するスペースを選択する**
**Team Repos**の右側にあるドロップダウンを展開すると、リポジトリがアタッチされるスペースをカスタマイズできます。 Bitbucket アイテムをタスクに添付するには、スペースをリポジトリに添付する必要があります。
### **ClickUpで Bitbucket アクティビティを自動的に関連付ける**
ClickUp は新しいアクティビティを自動的に取得し、タスクに関連付けます。
これを有効にするには、次の操作を行う必要があります。
**プル リクエストのタイトル、ブランチ名、またはコミット メッセージの任意の部分に、次のいずれかの形式でClickUp**[**タスク ID**](https://help.clickup.com/hc/en-us/articles/6309890818071-Task-IDs-overview)**を追加します。**
\#{task\_id}
CU-{task\_id}
{custom\_task\_id}
例えば：
\#1abc2de
CU-1abc2de
prefix-1
### **Bitbucketアクティビティを手動で関連付ける**
1. 任意のタスクのBitbucketアイコンをクリックします
2. リポジトリを選択
3. Branchを選択
4. コミットを添付する
### **Bitbucket 経由でタスクのStatusを自動的に変更する**
コミットまたはプルリクエストからタスクのステータスを変更することもできます。\
これを行うには、次の手順を実行します。
コミット メッセージの任意の部分に\
ClickUp[タスク ID](https://help.clickup.com/hc/en-us/articles/6309890818071-Task-IDs-overview)を追加し、括弧内に希望するステータスを追加します。
例： **#ud5b\[ready]**
{% hint style="info" %}
**注**： Bitbucket からClickUpにタスク ID をリンクすることもできます。
{% endhint %}
1. リポジトリ設定に移動
2. **\[Links]**をクリック
3. 新しいリンクを追加
4. Link type：**Custom**
5. Link URL ： [app.clickup.com/t/\1](http://app.clickup.com/t/%5C1)
6. Link key： CU-(\w{3,10})(\\\[\w+\\])?
これはコミットとプルリクエストの両方で機能します。
### **Actions**
Quick actionsを使用して、 ClickUp内から新しいブランチをすばやく簡単に作成します。
1. **\[Bitbucket icon]**をクリックしてGitモーダルを開きます
2. 左側には、提案された名前、ローカルで新しいブランチをチェックアウトしてリンクするコマンド、単一のコミットをリンクするコマンド、プルリクエストを開くコマンドなど、自動生成されたさまざまなクイックコピーオプションがあります。
これらのオプションで使用される自動生成された名前は、Bitbucket 統合設定でカスタマイズできます。
### **プルリクエスト**
これで、 ClickUp内からプル リクエストを作成したり、既存のプル リクエストをリンクしたりできるようになりました。ClickUpで新しいプルリクエストを作成するには：
1. リンクするタスクの Bitbucket アイコンをクリックし、\[New Pull Request]ボタンをクリックします。
2. モーダルでは、提案されたプル リクエストのタイトルに、提案されたタイトルが事前に入力されます。 自動生成されたタイトルが気に入らない場合は、Bitbucket 統合設定で調整できます。
3. ターゲットブランチとソースブランチを選択する
4. descriptionを入力
5. プルリクエストを作成する
ClickUpでプル リクエストを作成するか、既存のプル リクエストをリンクするとすぐに、関連付けられたClickUpタスクへのリンクがプル リクエストに追加されます。
プル リクエストがリンクされると、リンクされた ClickUp タスク内から、誰がそれを開いたか、ClickUp担当者 (割り当てられている場合)、CI/CD ステータス、プル リクエスト ステータス (オープン、レビュー要求済み、レビュー中、マージ済み、クローズ済み) をすべて確認できるようになります。
### **Bitbucket で問題が発生していますか?**
[トラブルシューティングのドキュメント](https://help.clickup.com/hc/en-us/articles/6327889851287-Troubleshooting-Bitbucket)を読むか、Bitbucket カスタマー サポートに[こちら](https://support.atlassian.com/bitbucket/)からお問い合わせください。
### **Bitbucket統合をRemove**
統合を無効にできるのは、ワークスペースのオーナーと管理者のみです。
統合を削除するには、 App Centerから次の手順を実行します。
1. **\[Bitbucket]**を選択します。
2. 下にスクロールして、**\[authorization for my Bitbucket repositories]**をクリックします。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://manual.dxable.com/clickup/integrations-and-clickup-api/integrations/bitbucket-integration.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.