【2026年版】Claude CodeとMCPの始め方｜導入から自作サーバー構築まで完全ガイド

AIエージェントによる自動開発が当たり前になった今、Claude Codeを使いこなす鍵はMCP（Model Context Protocol）にある。MCPはAIと外部ツールを繋ぐ共通規格だ。これを導入すれば、GitHubやNotionなどのデータを手動でコピペする作業から解放される。今日から始められる導入手順と、自作サーバー構築の落とし穴をすべて解説する。

MCPがもたらす開発の劇的な変化

MCPはAIのための「USB端子」のようなものだ。対応するサーバーをClaude Codeに接続するだけで、AIが直接外部ツールを読み書きできるようになる。導入の合図は「別のツールからClaudeにデータをコピペしている自分に気づいたとき」だ。Issueの内容や監視ダッシュボードのエラーログをわざわざ貼る必要はない。AIが直接そのシステムを見に行く世界を構築する。

Claude CodeへのMCPサーバー追加方法

サーバーの追加には「claude mcp add」コマンドを使う。クラウドサービスにはHTTPトランスポート、ローカルのスクリプトにはstdioトランスポートを利用する。ここで重要なのは「--（ダブルダッシュ）」の扱いだ。これより後ろはサーバー起動コマンドとして認識される。

サーバー追加の基本構文は以下の通りだ。

* HTTP方式：claude mcp add --transport http サーバー名 URL

* stdio方式：claude mcp add --transport stdio サーバー名 -- 起動コマンド

stdio方式で「--」を忘れると、Claude Code自身のオプションとサーバーの起動引数が混ざり合い、エラーが発生する。この区切り記号は必須のルールだ。

あわせて読みたいClaude Codeの使い方完全ガイド｜インストールから実践まで2年運用の開発者が解説 →

スコープ管理で安全に運用する

MCPサーバーは「どの範囲で有効にするか」を--scopeオプションで指定する。チーム開発での共有ならproject、自分専用ならuser、実験用ならlocalだ。同じ名前のサーバーが複数ある場合、local、project、userの順で優先される。

チーム共有を目的とするprojectスコープでは、設定ファイルである.mcp.jsonをリポジトリにコミットする。ただし、勝手な実行を防ぐため、初回の使用時には必ず承認プロンプトが出る。セキュリティを考慮し、APIキーなどの機密情報は直接書かず、環境変数を展開して利用する仕様が推奨されている。

Python SDK 2.0による自作サーバーの構築

最新のSDK 2.0では、MCPServerクラスと@server.toolデコレータを使う。以前のようにlist_toolsやcall_toolを自前で定義する必要はない。型ヒントからスキーマが自動生成されるため、実装は非常に簡潔だ。

注意すべきはデコレータの使い方だ。エラー処理を共通化しようと@handle_errorsのようなデコレータで関数を包むと、元の型ヒントが失われる。結果として、引数が認識されない壊れたスキーマが生成される。必ずfunctools.wrapsを使い、関数のメタデータを引き継ぐのが鉄則だ。

MCP仕様変更への対応と本番運用

2026年7月以降、MCPの通信モデルはステートレスな設計へと刷新された。かつてのセッション管理は廃止され、リクエストごとにメタデータを付与する方式に変わっている。本番運用を行う際は、冪等性を担保することが何よりも重要だ。

しんたろー：
Claude Codeで毎日コードを書いている身からすると、MCPの導入は必須だ。
画面を行き来する無駄な時間が消え、AIが直接コンテキストを読み取ってくれるだけで生産性は段違いになる。

しんたろーのイチ推しTips

環境変数による設定管理が重要だ。APIキーを直書きせず、${API_KEY}のように記述することで、セキュアな状態で設定を共有できる。また、自作サーバーを作る際は、必ず公式のConformance TestをGitHub Actionsに組み込む。これが通れば、本番環境でも安定して動作するはずだ。

しんたろー：
自作サーバーで詰まる人の多くは、デコレータの書き方で型ヒントを潰している。
functools.wrapsを使うだけで解決するから、まずはそこをチェックしてみてほしい。

あわせて読みたい【2026年版】AI活用1人SaaS開発の完全ロードマップ｜5ステップで始める個人開発 →

FAQ

Q1: MCPサーバーを追加する際、--（ダブルダッシュ）は何のためにあるのか。

A1: Claude Codeのコマンドオプションと、サーバーを起動するためのコマンドを明確に分離するためだ。これがないとサーバー側の引数をClaude Code自身のオプションとして誤解釈し、エラーになる。サーバー起動コマンドの直前に置くのがルールだ。

Q2: 自作サーバーでツールが認識されない場合、どこを確認すべきか。

A2: まずデコレータにfunctools.wrapsを付けているか確認する。デコレータで関数をラップすると型ヒントが失われ、引数が正しく認識されなくなる。inspect.signatureでシグネチャが正しく生成されているか自己診断コードを組み込むといい。

Q3: チームでMCP設定を安全に共有する方法はあるのか。

A3: プロジェクトスコープ（--scope project）を使い、.mcp.jsonをリポジトリにコミットするのが定石だ。機密情報は直接書かず、環境変数を展開して利用する。これにより、設定ファイルは共有しつつ、認証情報は各自の環境で安全に注入できる。

Q4: MCPの仕様変更は、古いサーバーに影響するのか。

A4: 2026年7月以降の仕様変更は通信モデルの再設計を伴うため、古い実装では動作しない可能性が高い。特にセッション管理に依存している場合は、リクエストごとに状態を完結させる設計への移行が必要だ。最新のSDKドキュメントを参照する。

Q5: MCPサーバーを本番環境で動かす際の注意点は何か。

A5: 冪等性（同じ操作を繰り返しても結果が変わらないこと）の担保が最重要だ。また、公式のConformance TestをCIに組み込み、トークン失効や分散トレーシングが機能するかを検証してからデプロイする。

まとめ

MCPを導入すれば、Claude Codeは単なるコーディング補助ツールから、外部システムを自在に操るエージェントへと進化する。まずは既存のサーバーを1つ導入し、その便利さを体感する。自作サーバーを作る際は、型ヒントの管理と冪等性を意識すれば、堅牢なAI開発環境が構築できるはずだ。