Claude Code で GitHubのMCP サーバーを使い始めた話

Claude Code の MCP(Model Context Protocol)サーバー機能を使って GitHub と連携した体験談です。設定方法から実際の使い方、ハマりポイントまでまとめました。

青白い光のノードとラインが黒背景に広がる、AIや通信プロトコルをイメージした抽象的なネットワークのビジュアル

🙌 結論から

Claude Code に MCP サーバーを追加すると、外部のサービスをターミナルから直接操作できるようになります!

私は GitHub MCP サーバーを導入してから、Claude Code のセッション内でイシューや PR の内容をそのまま参照できるようになりました。

「あのイシューの仕様、確認したいな」というときに、ブラウザに切り替えることなく会話の流れで確認できるのが、正直かなりありがたいです(^o^)/

導入自体は設定ファイルを数行書くだけなので、まだ試していない人にはぜひ読んでみてほしい内容です。

💡 MCP サーバーとはなにか

MCP は Model Context Protocol の略で、Anthropic が策定したオープンな仕様です。

簡単にいうと「Claude と外部ツールをつなぐ橋渡し役」で、GitHub・Slack・データベース・ファイルシステムなど、さまざまなサービスとのやりとりを Claude が直接できるようになります!

従来は「Claude にコードを聞いて、ブラウザで仕様を確認して、またターミナルに戻る」という行き来が必要でした。

MCP があると、その往復がかなり減ります(^^)

MCP サーバーは公式・サードパーティ含めて多数公開されており、Claude Code の設定ファイルに数行追記するだけで使えます。

👍 GitHub MCP サーバーを導入してみた

導入は .claude/settings.json に以下を追記するだけです。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxx"
      }
    }
  }
}

PAT(Personal Access Token)は GitHub の設定から発行して env に渡すだけで、Claude Code を再起動すればすぐに使えます!

私が特によく使うのは「特定のイシューの内容を読む」「PR のコメント一覧を確認する」といった操作です。

コードを書きながら仕様確認まで同一セッションで済むのは、思っていた以上に便利でした(`・ω・´)

✨ 使い始めてからの変化

一番変わったのは「コンテキストの分断が減った」ことです。

以前は「実装 → ブラウザでイシュー確認 → ターミナルに戻る」を繰り返していましたが、今は Claude Code の会話の流れで「このイシューを参照して実装して」と指示できます!

PR レビューのコメント内容を確認しながら修正する作業も、かなり速くなりました。

「どのファイルを直せばいいか」という判断を、イシューの文脈込みで Claude に頼めるのが相当楽です(^o^)/

久しぶりに触るコードベースや、複数ファイルにまたがる修正のときに、特に威力を感じています。

👀 気になった点とハマりポイント

一点だけ注意があります。

MCP ツールを積極的に使うと、Claude のコンテキストウィンドウをかなり消費します(・_・;)

GitHub のイシュー本文や PR のコメントは意外と長く、複数参照しているとトークンが増えていきます。

「必要なときだけ参照する」という意識で使うと、セッションが長持ちします。

また、PAT の権限は必要最小限にしておくことをおすすめします。

私は read:repo と issues の読み取り権限だけに絞っています。

MCP サーバーを繋ぐと基本なんでもできることになるので、慎重に設定しておきましょう!

友人のエンジニアは、検証環境のDBの1テーブルをトランケートしちゃった…という事象がありました💦

パパ系Webエンジニア〜愛用ガジェット一覧 🛍️

AI開発・執筆に使っている作業デスク環境を楽天ROOMにまとめています ✨ デスク周りの参考にどうぞ 🙌

🙌 まとめ

MCP サーバーを一度導入すると、Claude Code の使い方が一段階広がります!

GitHub 連携だけでも十分に価値があって、イシュー・PR・コメントを会話の流れで参照できるようになります。

あとは、必要最小限の権限で MCP サーバーを設定することが大切です!

…自分の会社のプロジェクトはビットバケットが主流なので、ビットバケット側にもMCPが早く用意されて欲しいですね✨

ドンドンAI駆動開発をしていきましょう!!!