> 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/github-integration.md).
# GitHub 統合
GitHub をClickUpと統合して、 ClickUpタスクを GitHub のアクティビティにリンクします。
ワークスペースの所有者または管理者は、[スペース](https://help.clickup.com/hc/en-us/articles/6309466958103-Intro-to-Spaces)をリポジトリに接続して、メンバーが Github の作業をタスクに追加できるようにすることができます。
リポジトリが接続されたスペース内のタスクは、コミット、ブランチ、プル リクエストにリンクできます。
### **必要なもの**
* GitHub 統合は[すべてのClickUpプラン](https://clickup.com/pricing)で利用できます。
* リポジトリ管理者だけが GitHub リポジトリをClickUpに追加できます。 追加されると、ワークスペース管理者はそれらのリポジトリをClickUp Spaces に追加できます。
* ワークスペースの[所有者と管理者](https://help.clickup.com/hc/en-us/articles/6310033667223-User-roles)だけが、[ ](https://help.clickup.com/hc/en-us/articles/6310033667223-User-roles)[App Center](https://help.clickup.com/hc/en-us/articles/12580135233559-Intro-to-App-Center)でワークスペースSettingsを更新できます。
* ワークスペースの所有者と管理者だけが、リポジトリをスペースに追加してリンクできます。
* 共有接続を作成できるのは、ワークスペースの所有者と管理者のみです。 複数の共有接続が許可されます。
* [メンバー以上の方](https://help.clickup.com/hc/en-us/articles/6310033667223-User-Roles)はプライベート接続を作成できます。
* [Guestsは](https://help.clickup.com/hc/en-us/articles/6310022323991-Guests-overview)GitHub 統合を使用できません。
### **実際の例**
モバイル アプリのエンジニアリング チームと Web サイト開発チームは、同じ GitHub 組織とClickUpワークスペース内の異なるリポジトリと別のスペースで作業します。
統合を開始するには：
1. ワークスペースの所有者または管理者が共有 GitHub 接続を作成します。
2. モバイル アプリ マネージャーは、**\[app-mobile]** GitHub リポジトリを**\[mobile app development]**スペースに接続します。
3. ウェブサイト管理者は**\[website]**のGitHubリポジトリを**\[marketing website]**スペースに接続します。
4. **\[mobile app development]**および**\[marketing website]**SpacesのタスクにGitHub アイコンが表示されるようになり、両チームがタスクを GitHub コミット、ブランチ、プル リクエストにリンクできるようになります。
### **Private接続と共有接続**
プライベート接続と共有接続については、 [App Center ](https://help.clickup.com/hc/en-us/articles/12580135233559-Intro-to-App-Center)の記事をご覧ください。
GitHub 統合の場合、プライベート接続を使用してClickUpからプル リクエストとブランチを作成します。 Private接続を使用して、既存のプル リクエスト、ブランチ、コミットをClickUpタスクから直接リンクすることもできます。
### **統合をSet up**
ClickUpで GitHub 統合を設定するには、次の 4 つの手順があります。
1. GitHub を承認します。
2. GitHub リポジトリをワークスペースにアタッチします。
3. GitHub リポジトリをClickUp Spaces にリンクします。
4. 必要に応じて、カスタム ブランチ名の形式を設定できます。
### **ステップ1 ： GitHubを承認する**
ClickUpワークスペースに対して GitHub を承認するには、ワークスペースの所有者または管理者である必要があります。
[App Center](https://help.clickup.com/hc/en-us/articles/12580135233559-App-Center-overview)から GitHub を承認するには：
1. **\[Development]**カテゴリを使用するか、 GitHub の**\[All Apps]**を検索してください。
2. **\[GitHub]**を選択します。
3. **\[Shared]**タブをクリックします。
4. **\[Connect]**をクリックします。
5. GitHub にサインインしてClickUpを承認します。
### **ステップ2 ： GitHubリポジトリをワークスペースにアタッチする**
ワークスペースの所有者と管理者は、 ClickUpワークスペースにリンクする GitHub リポジトリを選択できます。 所有者または管理者は、GitHub リポジトリ管理者でもある必要があります。
注
リポジトリを添付しても、ClickUpユーザーはあなたのリポジトリのコードベースにアクセスすることはできません。
ワークスペースにリポジトリを追加するには：
1. App Centerで GitHub を開きます。
2. **\[Workspace Settings]**をクリックします。
3. **\[Connect Repositories to ClickUp]**の横にある**\[Add repo]**をクリックします。
4. 追加するリポジトリをすべて選択します。
ヒント
正しいリポジトリが表示されない場合は、間違った GitHub アカウントでサインインしている可能性があります。
### **ステップ3 ： GitHubリポジトリをClickUp Spacesにリンクする**
ワークスペースにリポジトリを追加した後、各リポジトリを 1 つ以上のスペースに追加できます。
注
いつでもSpacesにリポジトリを追加したり削除したりできます。
リポジトリをスペースにリンクするには：
1. App Centerで GitHub を開きます。
2. **\[Workspace Settings]**をクリックします。
3. リンクするリポジトリの名前をクリックします。
4. **\[+ Add Space]**をクリックします。
5. リンクする追加のスペースについて繰り返します。
### **ステップ4 ：ブランチ名の形式を設定する**
組織でブランチ名に特定の形式を使用している場合は、 App Centerの GitHub ページから設定できます。 ClickUpタスクからブランチを作成する場合、この形式が使用されます。
デフォルトの形式は次のとおりです： **： taskId ：\_ ： taskName ：\_ ： username ：**
例： **CU-ae27de\_Auto-generated-naming\_John-smith**
利用可能なオプションは次の表に示されています。
| 価値 | 説明 |
| -------------- | ----------------------------------------------------- |
| **:username:** | ブランチを作成したClickUpユーザー アカウントのユーザー名。 スペースはダッシュに置き換えられます。 |
| **:taskId:** | ブランチが作成されるClickUpタスクの ID。 必要なプレフィックスが含まれます。 |
| **:taskName:** | ブランチが作成されるタスクの名前。 スペースはダッシュに置き換えられます。 |
App Centerで**\[GitHub]**からデフォルトの名前形式を設定するには:
1. **\[Workspace Settings]**をクリックします。
2. **\[Auto-generated branch name]**の下に、希望するブランチ名の形式を入力します。
3. **\[Save]**をクリックします。
### **GitHub からタスクをリンクする**
プル リクエストのタイトル、プル リクエストの説明、ブランチ名、またはコミット メッセージのいずれかの部分に有効な ClickUp[タスク ID](https://help.clickup.com/hc/en-us/articles/6309890818071-Task-IDs-overview)を含めると、 ClickUp は新しい GitHub アクティビティをタスクに自動的に関連付けます。
プル リクエストにClickUpタスク ID が含まれている場合、プル リクエストにClickUpタスクへのリンクを含むコメントが投稿されます。 プル リクエストをClickUpタスクに手動で貼り付けると、リンクは表示されません。
コメントは、リポジトリとスペース マッピングを設定した人の GitHub アカウントを使用して投稿されます。
タスク ID は、次のいずれかのオプションを使用してフォーマットする必要があります。
\#{task\_id}
CU-{task\_id}
{custom\_task\_id}
\#{custom\_task\_id}
例えば：
\#1abc2de
CU-1abc2de
eng-123
\#eng-123
### **ClickUpからタスクをリンクする**
また、 ClickUpタスクを、 ClickUpタスクからの GitHub コミット、ブランチ、プル リクエストに手動でリンクすることもできます。 タスクがリポジトリにリンクされたスペースに配置されていることを確認します。
タスクをリンクするには：
1. タスクを開き、 **\[GitHub]**アイコンをクリックします。
ヒント
右側には、クリップボードにコピーできるブランチ名とコミット メッセージの候補が表示されます。 ここからタスク ID をコピーすることもできます。
1. 右下隅にある**\[Add GitHub link]**をクリックします。
2. リンクを貼り付けます。
3. 右下隅にある**\[Add]**をクリックします。
### **ClickUpからGitHubの問題、ブランチ、プルリクエストを作成する**
タスクから直接、新しい問題、ブランチ、プル リクエストを作成することもできます。 タスクがリポジトリにリンクされたスペースに配置されていることを確認します。
問題、ブランチ、またはプルリクエストを作成するには：
1. タスクを開き、 **\[GitHub]**アイコンをクリックします。\
右側に、クリップボードにコピーできるブランチ名とコミット メッセージの候補が表示されます。 ここからタスク ID をコピーすることもできます。
2. 右下隅にある**\[Add GitHub link]**をクリックします。
3. 次のいずれかのオプションを選択します。
* 新しい GitHub の問題
* 新しい GitHub ブランチ
* 新しい GitHub プルリクエスト
4. 問題、ブランチ、またはプル リクエストに名前を付けます。
5. リポジトリを選択し、情報を入力します。 該当する場合は、ソース ブランチとターゲット ブランチを追加します。
6. **\[Create]**をクリックします。
### **ClickUpでGitHubのアクティビティを見る**
タスクの全てのGitHubアクティビティを表示するには、タスクの右側にある**\[GitHub]**アイコンをクリックします。
GitHub タスク アクティビティでは、ユーザーのClickUpユーザー名が使用されます。ユーザーがClickUpアカウントを持っていない場合は、GitHub ユーザー名が使用されます。
### **GitHubからタスクのステータスを更新する**
コミットをリンクしたり、コミットをプッシュしたり、プル リクエストを作成したりするときに、 ClickUpタスクの[ステータス](https://help.clickup.com/hc/en-us/articles/6309452618647-Create-and-manage-custom-statuses)を更新できます。 プル リクエストのタイトル、プル リクエストの説明、ブランチ名、またはコミット メッセージのいずれかの部分に有効なタスク ID を含めると、 ClickUp は新しい GitHub アクティビティを自動的に取得し、それをタスクに関連付けます。
タスク ID は、次のいずれかのオプションを使用してフォーマットする必要があります。
**#{task\_id}\[status]**
**CU-{task\_id}\[status]**
**{custom\_task\_id}\[status]**
**#{custom\_task\_id}\[status]**
タスクのステータスを更新するには：
1. コミットまたはプル リクエスト メッセージの任意の部分にClickUp[タスク ID](https://help.clickup.com/hc/en-us/articles/6309890818071-Task-IDs-overview)を追加します。
2. 更新されたタスクのステータスを角括弧で囲みます。
例： **#ud5b\[ready]**
ヒント
この記事の「GitHub からタスクをリンクする」セクションにリストされているすべての形式を使用できます。 適切なフォーマットを確保するために、タスク ID とステータス情報の間にスペースを追加しないでください。
### **ClickUpからGitHubの問題、ブランチ、プルリクエスト、コミットを管理する**
**\[GitHub]**アイコンをクリックすると、タスクの右側に表示されます。 リンクをコピーするか、アイテムを削除するには、**省略記号の...メニュー**を使用します。
### **発行情報**
問題がリンクされると、次の詳細が表示されます。
* 問題を提起した人（著者）
* 割り当てられたレビュー担当者
* リンクを作成しました
* リポジトリ
* 問題のステータス。
* URL
### **ブランチ情報**
ブランチがリンクされると、次の詳細が表示されます。
* ブランチを作成した人（著者）
* リンク作成者
* リポジトリ
* URL
### **プルリクエスト情報**
プルリクエストがリンクされると、次の詳細が表示されます。
* プルリクエストを開いた人（著者）
* 割り当てられたレビュー担当者
* 担当者
* ラインの変更
* リンクを作成しました
* リポジトリ
* ソースブランチ
* ターゲットブランチ
* プルリクエストのステータス
* URL
### **コミット情報**
コミットがリンクされると、次の詳細が表示されます。
* コミットを作成した人（著者）
* 変更されたファイル
* ラインの変更
* リンクを作成しました
* リポジトリ
* URL
### **ClickUpにGitHubアカウントを追加する**
ワークスペースのメンバーは、事前に、またはブランチやプルリクエストを作成するときに、GitHub アカウントをClickUpアカウントにリンクできます。
App Centerから GitHub アカウントを追加するには：
1. **\[Development]**カテゴリを使用するか、 GitHub の**\[All Apps]**を検索してください。
2. **\[GitHub]**を選択します。
3. **\[Private]** タブをクリックします。
4. **\[Create a private connection]**の横にある**\[Connect]**をクリックします。
5. GitHub にサインインしてClickUpを承認します。
### **ClickUpからGitHubアカウントをRemove**
App Centerから GitHub アカウントを削除するには：
1. **\[Development]**カテゴリを使用するか、 GitHub の**\[All Apps]**を検索してください。
2. **\[GitHub]**を選択します。
3. **\[Private]** タブをクリックします。
4. **［Connected］**の横にある**省略記号の...アイコン**をクリックします。
5. **［Disconnect］**をクリックします。
注
GitHub アカウントを切断しても、GitHub とClickUp Workspace の統合には影響しません。
### **ワークスペースからGitHubインテグレーションを削除する**
ワークスペースの所有者と管理者だけが、ワークスペースから GitHub 統合を削除できます。
App Centerの\[**GitHub]**からGitHub統合を削除するには:
1. **［Shared］**タブをクリックします。
2. **［Connected］**の横にある**省略記号の...アイコン**をクリックします。
3. **［Disconnect］**をクリックします。
---
# 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/github-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.