Claude Code × MCP サーバーで外部ツール連携

MCP サーバーとは

MCP（Model Context Protocol）は、Anthropic が提唱する、AI と外部ツールをつなぐためのプロトコルです。サーバーが「ツール」「リソース」「プロンプト」を公開し、Claude Code 側はそれらを通常のツール呼び出しと同じ感覚で使えます。

つまり、Claude Code が GitHub にアクセスしたり、Backlog の課題を取得したり、Playwright でブラウザを操作したりが、すべて自然言語の対話の中で完結します。

私が常用している MCP サーバー

個人開発で常用しているのは以下です。

• Backlog MCP: バグ報告・要件管理。バグ票を取得して、すぐ修正コミットに繋げる
• App Store Connect MCP: ストアメタデータ・リリースノートの更新、TestFlight ビルドの確認
• Playwright MCP: Web 版アプリの動作確認、スクリーンショット撮影
• Serena MCP: コードベースのシンボル検索・参照解析
• Context7 MCP: ライブラリの最新ドキュメント取得

バグ報告→修正→ストア更新を 1 会話で

実際にやった流れを再現するとこんな感じです。

1. 「Backlog の最新バグ票 3 件を見せて」と聞く
2. Claude Code が mcp__backlog__get_issues で取得して要約
3. 1 件選んで「これを直して」と指示
4. Serena MCP で関連シンボルを検索、修正実装
5. テスト追加 → 実行 → コミット
6. 「リリースノートに今回の修正を追記して、App Store Connect に上げて」と指示
7. App Store Connect MCP 経由でメタデータ更新

以前は「Backlog 開く → 課題コピペ → IDE で修正 → ストア管理画面開く → メタデータ編集」と 5 つのツールを行き来していたのが、1 つの会話で完結します。

セットアップの注意点

MCP は強力な反面、認証情報を渡すので扱いには注意が必要です。

認証情報は環境変数で

設定ファイル（~/.claude/mcp.json など）に API キーを直書きせず、環境変数経由で渡します。

{
  "mcpServers": {
    "backlog": {
      "command": "backlog-mcp",
      "env": {
        "BACKLOG_API_KEY": "${BACKLOG_API_KEY}"
      }
    }
  }
}

シェルの .zshrc などで export BACKLOG_API_KEY=... しておけば、設定ファイル自体は Git に上げても安全です。

ローカルで MCP サーバーを起動する場合は、npx で公開パッケージを直接叩けます。デバッグ時は --port を変えて競合を避けるのが定石です。

# 事前に .zshrc などで export BACKLOG_API_KEY=xxxxx を済ませておく想定

# Backlog MCP サーバーをローカル起動
npx -y @modelcontextprotocol/server-backlog --port 3331

# Playwright MCP サーバーを別ポートで起動
npx -y @modelcontextprotocol/server-playwright --port 3332 --headless

権限の最小化

App Store Connect のように本番に直接影響する MCP は、可能なら閲覧専用キーから始めて、書き込み権限は段階的に付与するのが安全です。

MCP の停止スイッチを用意

何かおかしいときにすぐ無効化できるよう、設定ファイルとは別に「無効化用の代替設定」を用意しておくと安心です。mcp.json をシンボリックリンクにしておくと、ln -sf mcp.dev.json mcp.json のような切り替えが一瞬で済みます。

注意したいこと

• 自動化が強すぎると、意図しない更新が走る。リリース系操作は必ず確認プロンプトを挟む
• MCP サーバー側の障害で全体が止まることがある。普段使わない MCP は無効化しておく
• 認証トークンの有効期限切れに注意。期限を月初にカレンダー登録

まとめ

• MCP は AI と外部ツールをつなぐ標準プロトコル
• バグ管理・ストア管理・ブラウザ操作を 1 会話で連携できる
• 認証情報は環境変数経由、権限は最小化
• リリース系は確認プロンプトを必ず挟む

MCP の組み合わせで、個人開発者の「ツール往復」を相当減らせます。Claude Code 単体でも便利ですが、MCP まで揃えると、ようやく「全部つながった」感覚になります。