GitHub統合(issue/PR検索 + 読み取り + コメント)

GitHubアカウントを接続すると、あなたのAI社員はissueとpull requestを検索し、全文を読み、コメントを投稿できるようになります。DuDuClawは GitHub REST APIにネイティブに接続するため、サードパーティのMCP server をインストールする必要はありません。アクセストークンはDuDuClawの暗号化されたOAuth vaultに保存されます。

何が使えるようになるか

2つのスコープ(github:read / github:write)で管理される、5個のエージェント向けMCPツールです。

ツール	分類	内容
`github_status`	read	接続状態の診断: 接続済みか、付与されたスコープ。ローカルの状態のみを読み取る。
`github_search_issues`	read	GitHubの検索構文(`repo:owner/name is:open label:bug`)でissueとPRを検索する。repo／number／title／state／is_pr／updated／urlを返す。
`github_issue_read`	read	1件のissueを読み取る: タイトル、状態、作者、本文(長い場合は切り詰め)、直近10件のコメント。
`github_pr_read`	read	1件のPRを読み取る: メタデータ(base／head／state／merged／mergeable)と変更ファイル一覧(filename／status／additions／deletions、最大50ファイル)。diffの内容は取得しない。
`github_issue_comment`	write	issueまたはPRにコメントを投稿する。公開される。

安全設計

コメントは公開されます。 github_issue_commentは誰でも見える発言を投稿します。対外的なコミュニケーションとして扱ってください。承認の後ろにゲートすることを推奨します:
```
[capabilities]
approval_required_tools = ["github_issue_comment"]
```
読み取りは読み取りのままです。 read分類のツールはGitHub上の何も変更できません。
diff本体は含みません。 github_pr_readは変更ファイルと増減行数を一覧表示しますが、diffの内容を取得することは決してなく、応答サイズを一定の範囲に保ちます。
最小権限。 要求するのはrepoスコープのみです(プライベート repositoryの読み取り／コメントに必要)。公開repoのみの利用でも問題なく動作し、このスコープは付与された場合にプライベートrepoも合わせてカバーするだけです。

前提条件: GitHub OAuth Appを作成する

自分自身のGitHub OAuth Appを用意する必要があります(DuDuClawは共有の認証情報を同梱しません)。初回セットアップ:

GitHub → Settings → Developer settings を開く。
OAuth Appsの下でNew OAuth Appをクリックする。
Authorization callback URLを正確に次の値に設定する:
```
http://localhost:18789/api/mcp/oauth/callback
```
appを登録し、Client IDをコピーする。続けてGenerate a new client secretをクリックしてClient secretを取得する。

要求されるscopeは以下のとおりです:

repo

repoは、そのアカウントから見える公開・プライベート両方のrepository 上のissueとpull requestに対する読み取り + コメント権限を付与します。公開repoしか必要ない場合でもrepoで接続して構いません。これはプライベートrepoも同時に解放する最小のscopeです。

ダッシュボードから接続する

Manage → Integrations → Tool servers(/manage/integrations)に移動する。
Services that need authorizationまでスクロールし、GitHub カードを探す。
カードのConfigureをクリックする。Client IDとClient secretを貼り付ける。ダイアログには登録すべき正確なcallback URLも表示されるので、上の手順3で入力した値と一致している必要がある。
GitHubの同意ウィンドウが開く。アクセスを承認すると、カードは Authenticatedに切り替わる。

client認証情報は永続化されます(secretは保存時に暗号化)。これにより、後で再認可する際にsecretを再入力する必要はありません。

トークンについて

従来型のGitHub OAuth Appのトークンには有効期限がありません (expires_atは空、これが正常かつ健全なデフォルトです)。もしあなたの OAuth Appでtoken expirationを有効にしている場合、GitHubは refresh_tokenを発行します。DuDuClawはトークンが期限切れになると、保存されているclient認証情報を使ってその場でトークンを更新します。どちらの形態も自動的に処理されます。

トークン交換の詳細(気になる方向け)

GitHubのtoken endpointはデフォルトでform-encoded形式を返します。 DuDuClawはAccept: application/jsonを送ることで、代わりにJSONを返させます。これはOAuth層で処理済みで、こちら側で設定する必要はありません。

トラブルシューティング

「GitHub is not connected.」: トークンが保存されていません。ダッシュボードから接続してください。
401 Unauthorized: 認可が取り消された、または無効です。再接続してください。
403: 多くはプライベートrepositoryに対してrepoスコープが不足しているか、rate limitに達しています。repoが付与されていない場合github_statusに注記が表示されるので、再接続して付与してください。
404「not found」: owner／repo／numberを確認するか、プライベートrepositoryに対してrepoを付与してください。
同意時にcallback URLが一致しない: OAuth AppのAuthorization callback URLは正確にhttp://localhost:18789/api/mcp/oauth/callback である必要があります。

いつでもgithub_statusを実行すれば、その場で診断結果を確認できます。