Claude Code MCP 実践：GitHub・CodeGraph・API の全体像

MCP 三連結とは

Claude Code MCP は MCP プロトコルで GitHub（issue と意図）、CodeGraph（リポジトリ構造と影響範囲）、API（環境と実データ）を Claude Code に入れ、エージェントが「何をするか・どこを変えるか・合っているか」を同時に見られるようにする——それを三連結と呼びます。

このページは Cloud Mac AI Stack における MCP の概要です。全体像は一枚の図、手順と深掘りはセットアップ・設計・CodeGraph の各記事へ。L2 の前編：並列メモリスケジューリング。

なぜ 1 本にまとめず、記事を分けたか

読者の状況はさまざまです。今すぐ環境を通したい人、GitHub と CodeGraph を一緒に繋ぐ理由を知りたい人、token や権限を絞りたい人。インストール手順・設計・権限チェックリストを 1 URL に詰めると、設定をコピーしたい人は長い mcpServers ブロックの間を往復し、まず地図だけ欲しい人の流れは途中で切れます。

だから作業ごとに分けました。このページで三連結の役割を一枚の図で把握し、配線するときはセットアップ手順、チームに設計を説明するときは設計解説へ。ここを入口に、次の記事を選んでください。

シリーズの中での役割

MCP 三連結の目次ページと考えてください。部品の関係をここで掴み、作業に合う専題へ進みます。インストールの代行や、CodeGraph・Runner 専用ガイドの代替にはなりません。

このページでは扱いません：

• Claude Code MCP の手順付きインストール（コピペ用コマンド一覧なし）
• 長いアーキテクチャ論や Context Engineering 理論
• CodeGraph 単体のデプロイ・運用（CodeGraph 5 分 を参照）

このページでできること：目的や症状から、次に読む記事（セットアップ・設計・グラフ・Runner・実行環境・権限）を選ぶこと。

ここにはない：読むべき記事

左の列の内容が必要なら「読む」から専題へ。概要ページで手順を探さないでください。

クイックナビ：次に読む記事

目的に合う専題を 1 つ選んでください。シーン別・症状別の表は下にあります。

push 後に CI を緑にしたい？ GitHub Runner ガイド. 蓋を閉じると MCP が切れる・索引が古くなる？ Cloud Mac とローカル Mac の選び方

やりたいことは？

検索語は違っても、目的はだいたい次の 4 類型です。当てはまるものを選ぶと早いです。

① まず環境を通す

例：Claude Code MCP setup · install MCP server · configure GitHub MCP · connect Claude Code to GitHub

目標：ツールチェーンを動かし、Claude Code で mcp__* ツールが見えること。
おすすめ セットアップ手順

② 全体設計を理解する

例：MCP architecture explained · Context Diff Fact · why MCP needed

目標：層の分け方を理解し、チームと認識を揃える。
おすすめ 設計解説

③ リポジトリグラフ / 影響分析だけ

例：CodeGraph MCP · codegraph_impact · repo graph Claude Code

目標：まずグラフを接続。GitHub issue フローは後回しでよい。
おすすめ CodeGraph 5 分；三連結の全体はあとで セットアップ手順

④ 権限と安全

例：MCP permissions · token scope · read-only API MCP

目標：token 範囲の管理、書き込みツールの分離、staging は読み取り専用。
おすすめ 権限ガイド。まず最小構成で通すならセットアップ手順のあとで権限を絞る

まだ迷う？ クイックナビ か下の 症状対照表 を使ってください。

よくあるシーンから入る

同じ三連結でも入り口は違います。自分に近い行からどうぞ。

• MCP が初めて：この図をざっと見る → セットアップ手順
• CodeGraph は済み、GitHub だけ足す → セットアップ手順 の GitHub 章；グラフは CodeGraph 5 分
• CI：push 後に緑チェック → GitHub Runner ガイド；MCP と Runner の違い → 設計解説
• token / 環境変数 / 読み取り専用 API を絞る → 権限ガイド；暫定は セットアップ手順 で最小接続
• 入れたがツールが出ない・不安定 → セットアップ手順 · トラブルシュート
• まだ入れず、設計だけ知りたい → 設計解説

うまくいかない？症状で選ぶ

症状ごとに、まず開く記事を示します。原因の詳細とコマンドは専題記事にあります。

よくある読み方 3 パターン

MCP に初めて触れる

Claude Code を開く → この概要（三連結）→ セットアップ手順 で mcpServers を入れチャットでツール確認 → push 後のチェックは GitHub Runner ガイド。

グラフは済み、GitHub だけ

CodeGraph 5 分 完了 → ここで GitHub の位置を確認 → セットアップ手順 で GitHub MCP のみ → 境界は 設計解説。

チームで AI 支援 CI を入れる

この概要 → セットアップ手順（三連結）→ Runner ガイド（自動チェック）→ 設計解説（チーム合意）→ 権限ガイドで token を絞る。

一枚の図で役割を把握

GitHub      = intent
CodeGraph   = context
API         = truth
Claude Code = diff
Runner      = fact

よくある質問

MCP 三連結の入口としてブックマーク推奨。英語版スラッグ：claude-code-mcp-github-files-api-chain。