GitHub
GitHubをSquadbaseに接続するための手順と必要情報の取得方法
このコネクターは、リポジトリ・Issue・Pull Request などの GitHub データを Squadbase AI が取得し、分析やダッシュボード作成に活用するためのものです。開発者設定にある GitHub 連携（Squadbase のプロジェクトコードをリポジトリに push したり、既存リポジトリをインポートするためのソースコード管理機能）とは異なります。
必要情報
| 項目 | 説明 |
|---|---|
| GitHub Personal Access Token | アクセスしたいデータに必要なスコープを持つ Personal Access Token です（Fine-grained: github_pat_...、または Classic: ghp_...）。 |
| GitHub API Base URL（任意） | GitHub Enterprise Server の API ベース URL を指定します（例：https://github.example.com/api/v3）。パブリック GitHub を使用する場合は空欄のままにしてください。 |
取得方法
GitHub Personal Access Token
Fine-grained と Classic の 2 種類のトークンに対応しています。どちらも GitHub アカウントの設定から生成します。
Fine-grained トークン（github_pat_...）
Fine-grained トークンを使うと、アクセスを許可するリポジトリや権限をより細かく制御できます。
- GitHub にログインし、右上のプロフィールアイコンをクリックする
- Settings → Developer settings → Personal access tokens → Fine-grained tokens に移動する
- 右上の Generate new token ドロップダウンボタンをクリックする
- Generate new token を選択する
- Token name にトークン名を入力し、必要に応じて Description を入力、有効期限を設定する
- Repository access でアクセスを許可するリポジトリを選択する
- Permissions でユースケースに必要なリポジトリ権限とアカウント権限を有効にする
- Generate token をクリックし、表示されたトークンをコピーする（再表示されません）
Fine-grained トークンは最大 1 年の有効期限が設定でき、特定のリポジトリのみに制限できます。本番環境では Classic トークンよりも安全です。
Classic トークン（ghp_...）
- GitHub にログインし、右上のプロフィールアイコンをクリックする
- Settings → Developer settings → Personal access tokens → Tokens (classic) に移動する
- 右上の Generate new token ドロップダウンボタンをクリックする
- Generate new token (classic) を選択する
- Note にトークンの用途を入力し、有効期限を設定する
- 必要なスコープを選択する：
| スコープ | 説明 |
|---|---|
repo | プライベートリポジトリのフルコントロール |
public_repo | パブリックリポジトリへのアクセス |
read:org | Organization・チームのメンバーシップの読み取り、Organization プロジェクトの読み取り |
read:user | ユーザープロフィールデータの読み取り |
read:packages | GitHub Package Registry からのパッケージのダウンロード |
read:discussion | チームディスカッションの読み取り |
read:project | プロジェクトへの読み取りアクセス |
notifications | 通知へのアクセス |
workflow | GitHub Actions ワークフローの更新 |
read:audit_log | 監査ログへの読み取りアクセス |
- Generate token をクリックし、表示されたトークンをコピーする（再表示されません）
トークンは生成直後にコピーしてください。GitHub は再表示しません。紛失した場合は新しいトークンを生成し直す必要があります。
GitHub API Base URL（任意）
パブリック GitHub（https://api.github.com）に接続する場合は、このフィールドを空欄のままにしてください。
GitHub Enterprise Server を使用している場合は、インスタンスの API ベース URL を入力します：
https://HOSTNAME/api/v3HOSTNAME は GitHub Enterprise Server のホスト名に置き換えてください（例：github.example.com）。