MCP サーバーチュートリアル 2026:導入・設定・稼働まで

MCP とは何か

Model Context Protocol は Anthropic が 2024 年 11 月に公開した仕様です。言語モデルが外部ツールを呼び出すための、そして外部ツールがモデルに自身を公開するための、標準的な手段を定めています。MCP 以前は、AI ツール統合はすべて個別実装でした。MCP によって、統合は組み合わせ可能になります。

アーキテクチャは名前から想像するより素直です。MCP サーバーはマシン上(ホスト型サーバーの場合はリモート上)で動作するプロセスです。Claude Code が起動すると、設定された各 MCP サーバーを立ち上げ、そのサーバーが提供するツール一覧を受け取り、以降のセッションでツールを名前で呼び出せるようになります。すべての通信は stdin/stdout 上の JSON-RPC 2.0 で行われます。HTTP もポートも、ローカルサーバーにはネットワーク設定も不要です。

概念的により深く理解したい方は、MCP とは何かの入門解説をご覧ください。本記事は実用的な構築手順に集中します。

設定ファイルの所在

MCP サーバー設定は settings.json ファイルに置きます。場所は 2 つです。

• ~/.claude/settings.json — グローバル設定。このマシン上のすべての Claude Code セッションに適用されます
• .claude/settings.json(プロジェクトディレクトリ内) — プロジェクト単位の設定。Claude Code がそのディレクトリで起動されたときのみ適用され、同名キーについてはグローバル設定を上書きします

プロジェクト固有のサーバー(プロジェクトの接続文字列に紐づくデータベースサーバーなど)はプロジェクト単位ファイルに、どこでも使いたいサーバー(Fetch、GitHub)はグローバルファイルに置くのが基本です。

基本的な設定構造

settings.json の mcpServers キーは、サーバー名からサーバー設定への対応表です。各サーバー設定には、サーバープロセスの起動方法を指定します。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_fine_grained_token_here"
      }
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

この構造についていくつか補足します。

• npx の -y フラグは、未インストールのパッケージを自動でインストールします。セットアップ時には便利ですが、初回起動はやや遅くなります。バージョン固定で回避することも可能です:@modelcontextprotocol/server-filesystem@0.6.0。
• 認証情報は env オブジェクトに置き、コマンドライン引数では渡さないでください。args はログに残りますが、環境変数は(既定では)残りません。
• サーバー名(キー)は任意です。エラーメッセージや Claude のツール記述で参照されるだけです。

最初に入れるべき 5 つのサーバー

{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_TOKEN": "github_pat_..."
    }
  }
}

{
  "playwright": {
    "command": "npx",
    "args": ["-y", "@playwright/mcp@latest"]
  }
}

{
  "fetch": {
    "command": "uvx",
    "args": ["mcp-server-fetch"]
  }
}

サーバーの動作確認

settings.json を編集したあと、新しい Claude Code セッションを開始してください。プロンプトで、利用可能なツールを Claude に問い合わせます。

What MCP tools do you have access to?

Claude は設定したサーバーと利用可能なツールを一覧化するはずです。サーバーが見当たらない場合、原因はおおむね以下 3 つのいずれかです。

1. パッケージが未インストール。npx の -y フラグは自動インストールしますが、npm レジストリが遅い、あるいはネットワークにファイアウォールがあると、初回実行が失敗することがあります。npx コマンドをターミナルで手動実行し、エラーを確認してください。
2. パスが誤っている。Filesystem サーバーは絶対パスを取ります。相対パスやタイポのあるパスは起動失敗の原因になります。Claude Code は MCP サーバーエラーを ~/.claude/logs/ に記録するので、まずそこを確認してください。
3. 認証情報が無効。サーバーは起動するもののツールがエラーを返す場合、最も多いのは API キーの期限切れや設定ミスです。MCP 層をデバッグする前に、curl やプロバイダの API プレイグラウンドで認証情報を直接テストしてください。

プロジェクト単位 vs グローバル設定

Septim でよく使うパターンはこうです。グローバル設定には Fetch、Memory、Playwright — どのプロジェクトでも有用なサーバーを配置します。プロジェクト単位設定には Filesystem(プロジェクトルートを許可パスに)、プロジェクトのデータベースサーバー、GitHub(プロジェクトのリポジトリにスコープ)を配置します。

この構造なら、任意のプロジェクトディレクトリに移動するだけで、Claude Code が手動切替なしに適切なサーバーを自動的に拾ってくれます。プロジェクト単位ファイルは同名サーバーについてグローバル設定を上書きするため、プロジェクトごとに異なるデータベース接続を、互いに干渉させずに保てます。

リモート MCP サーバー

Anthropic は 2026 年初頭、リモート MCP サーバー(stdio ではなく SSE 経由)のサポートを追加しました。設定では command と args の代わりに url キーを使います。

{
  "mcpServers": {
    "stripe": {
      "url": "https://mcp.stripe.com",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

リモートサーバーは、自前のホスト型 MCP エンドポイントを運用するサービス(Stripe ほか複数あります)では便利です。トレードオフは、ツール呼び出しごとのネットワーク往復と、認証情報がネット越しに送られる点です。HTTPS 限定のリモートのみを使い、認証ヘッダは環境変数の API キーと同じ慎重さで扱ってください。

サーバーを増やす前に押さえるべきセキュリティ

追加するサーバーごとに、Claude Code セッションの攻撃面は広がります。MCP サーバー脆弱性チェックリストには 24 項目の評価フレームワークが載っています。チュートリアル向けの短縮版はこちらです。

• 活動的な組織メンテナーや支援企業のあるサーバーのみ導入する
• 導入前にソース内のツール記述を読む — ツールメタデータに埋め込まれた悪意ある指示は、文書化された攻撃ベクトルです(arXiv 2603.22489)
• 認証情報のスコープは最小に — 1 リポジトリの読み取り用 GitHub トークンに、全リポジトリへの書き込み権限を持たせない
• 認証情報を含む .claude/settings.json は git 管理から外す

運用に値するサーバーの厳選一覧と、それぞれのセキュリティ留意点は、2026 年版 best MCP serversにまとめてあります。