1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

MCPサーバーに関して⑨:セキュリティと運用

1
Posted at

MCPサーバーに関して⑨:セキュリティと運用

⑧までで、ローカルでのサーバー作りからAWSへのデプロイとOAuth 2.1の認証まで進みました。今回は「作ったサーバーをどう守り、どう運用するか」です。

この記事はMCP仕様の最新版 2026-07-28 をもとに書いています。この版でプロトコルはステートレスになり、セッションはありません。

この記事で分かること

  • MCPサーバー特有のリスクと、多層防御の考え方
  • 最小権限の設計と、危険なツールの安全な作り方
  • AWSでのサンドボックスと、ログ・監視の組み立て方
  • ツールやプロトコルを変えるときの注意点

MCPサーバー特有のリスク像

MCPの3機能のうち、副作用を持つのがツールです。仕様は「ツールは任意のコード実行であり、適切な注意をもって扱わなければならない」と明記しています。リソースやプロンプトは読むだけですが、ツールはDBを書き換え、外部へ送信し、ファイルを消せます。

やっかいなのは、呼ぶのが人間ではなくモデルだという点です。モデルは会話の文脈から判断してツールを選び、引数も自分で決めます。仕様はサーバーに「すべてのツール入力を検証すること」を求めています。引数は信頼できない入力として扱うのが出発点です。

さらに、ツールの結果も入力になります。DBの行やWebページなど、ツールが返した内容に指示が紛れていることがあり、モデルがそれを読んで次のツール呼び出しを誤ります。いわゆる間接プロンプトインジェクションです。仕様はサーバーに「すべてのツール入力の検証」と「ツール出力のサニタイズ」を求め、クライアントにはツール結果をLLMへ渡す前の検証を求めています。読み取りツールで拾った秘密情報を、送信ツールで外に出す組み合わせが最も危険です。

注入そのものを完全に防ぐ方法はありません。だから対策は「被害を限定する」方向に寄せます。

権限管理:最小権限を設計に落とす

OAuth 2.1の復習(詳しくは⑧):サーバーはリソースサーバーで、トークンを発行するのではなく検証する側です。決まりは2つです。トークンは自分宛てのものだけ受け取り、ほかのサービス宛てのトークンは受け取らず、下流のAPIへ転送しないこと(トークンパススルー禁止)。クライアントは認可要求とトークン要求の両方でresourceパラメータを送り、トークンを「このサーバー宛て」にひも付けます。トークン検証の具体的な実装(CognitoのJWKS検証など)は、⑩で設計指針として整理します。

権限は「あとで絞る」のではなく、最初から小さくします。

  • スコープは最小限から:仕様のベストプラクティスは、最初は読み取りなどの低リスク操作だけのスコープを与え、権限が必要になったときにWWW-Authenticateのscopeチャレンジで段階的に昇格させる方法を勧めています。*のような包括スコープは避けます。
  • ツールごとに返すものを変える:仕様では、tools/listで返すツール集合は、提示された認可(スコープ)によって変えてよいとされています。読み取り専用スコープの呼び出し元には、読み取りツールだけを見せる設計ができます。
  • 読み取り専用はDB側で担保する:⑤のrun_queryのように、接続そのものを読み取り専用にし、許可する文をSELECT(WITHで始まるものを含む)だけに絞ります。ツールに付けられるreadOnlyHintは、あくまでクライアントへのヒントです。付けなければ「破壊的かもしれない」扱いになり、付けてもサーバー側の制御にはなりません。制御はDBの権限と接続方法で行います。

危険なツールの扱い

書き込み・削除・外部送信を伴うツールは、次の3つをセットで設計します。

観点 指針
対象の限定 操作できる対象を許可リストで絞る(テーブル名、送信先など)
引数の検証 型・範囲・形式をサーバー側で検証する。SQLは組み立てず、パラメータで渡す
承認 破壊的な操作は、実行前に人間の承認を挟む

承認にはエリシテーションが使えます。サーバーがツール実行の途中で、クライアント経由でユーザーに追加情報を求める仕組みで、承認の確認にも使えます。フォーム形式は入力内容がクライアントに露出するため、パスワードやAPIキーなどの機密情報の収集には使わず、クライアントを通さないURL形式(ブラウザで開く別ページ)で行います(仕様は機密情報にはURL形式を必須としています)。ユーザーが拒否・キャンセルした場合の扱いも実装します。

from mcp.server import MCPServer
from mcp.server.mcpserver.exceptions import ToolError
from mcp.types import ToolAnnotations

mcp = MCPServer("handbook")

ALLOWED_TABLES = {"audit_log", "temp_cache"}

@mcp.tool(
    title="古い行の削除",
    annotations=ToolAnnotations(
        read_only_hint=False, destructive_hint=True, idempotent_hint=True
    ),
)
def purge_old_rows(table: str, days: int) -> str:
    """許可されたテーブルの古い行だけを削除する。"""
    if table not in ALLOWED_TABLES:
        raise ToolError(
            "このテーブルは削除できません。削除できるのは audit_log と temp_cache です。"
        )
    if not 1 <= days <= 90:
        raise ToolError("days は 1〜90 の範囲で指定してください。")
    # ここで DELETE ... を実行する(実行部分は省略)
    return f"削除対象:{table}、{days} 日より古い行"

危ない条件をツールの外に置かず、中に埋め込むのがポイントです。削除できるテーブルは集合で決め打ちし、期間には上限を付けます。モデルがdays=99999や別のテーブル名を渡しても、サーバー側ではねます。destructive_hint=Trueを付けて、クライアントに「破壊的なツールだ」と伝えるのも忘れずに。なお、このコードは実行部分を省略した骨組みです。実際に使うときは、ここにDELETE文の実行と削除件数の確認を書き足します。検証に失敗したときは、⑥で紹介したToolErrorを投げて、モデルに直し方を伝えます。

サンドボックス:実行環境の分離

ツールが悪用されても被害が広がらないよう、実行環境を分けます。仕様も、ローカルサーバーはクライアントと同じ権限で動くため、サンドボックス化や権限の最小化を求めています。

AWSでECS on Fargateに載せる場合の分け方は次のとおりです。

層 方法
プロセス タスク単位で分離する。ほかのタスクと権限を共有しない
AWSの権限 タスク実行ロール(イメージ取得・秘密情報の取得)とタスクロール(アプリがAWS APIを呼ぶ権限)を分ける。それぞれ必要最小限だけを付ける
秘密情報 DBのパスワードなどはSecrets Managerに入れ、タスク定義からはARNで参照する。平文の環境変数には置かない
ネットワーク セキュリティグループとVPCで、外向きの通信先を必要なものだけに絞る

Lambdaで動かす場合も考え方は同じで、関数に付ける実行ロールを、その関数が必要な操作だけに絞ります。共通の原則は「サーバーのプロセスに与える権限=被害の上限」です。

ログと監視:何を残し、何を見るか

仕様はクライアントに「監査のためにツール利用をログすること」を求めています。サーバー側でも、呼び出しの記録は運用の土台です。

残すもの:ツール名、引数、結果の要約、エラー、呼び出したユーザー(トークンのsubクレーム)、時刻。あとから「誰が、いつ、どのツールで、何をしたか」を追えることが目的です。

残してはいけないもの:トークンやAPIキー、パスワードなどの秘密情報です。仕様も、サーバーに記録されたトークンが漏れると不正利用につながると警告しています。引数をそのままログに出すのではなく、秘密情報に当たる項目はマスクしてから残します。

AWSでの組み立ては次のとおりです。

役割 サービス 使い方
アプリログ CloudWatch Logs ツール呼び出しの記録を集約し、検索やアラームの材料にする
APIの監査 CloudTrail AWS APIの呼び出しを記録する。イベント履歴では過去90日分を確認でき、長期保存にはトレイルを作りS3へ送る
異常の検知 CloudWatch アラーム 破壊的なツールの呼び出し回数の急増、認証失敗の連続など、見るべき兆候にアラームを付ける。CloudTrailのログをCloudWatch Logsへ送ると、メトリクスフィルタで自動検知できる

バージョン管理:変えるときの考え方

  • プロトコルバージョン:Streamable HTTPでは、リクエストにMCP-Protocol-Versionヘッダーが付き、本文のバージョンと一致しないと400エラーになります。サーバーが対応していないバージョンにも400で応答します。対応するバージョンを明示し、古いクライアントをいきなり切らないようにします。
  • ツール定義の変更:ツールの説明文やスキーマを変えると、モデルの呼び方が変わります。仕様はtools/listを決まった順序で返すことを推奨しており、ツール一覧の安定性が前提になっています。ツール名の変更や削除、引数の必須化は破壊的変更として扱い、事前に知らせ、移行期間を置きます。
  • サーバーのバージョン:デプロイするたびにバージョンを上げ、どのバージョンで何が変わったかを記録します。問題が起きたときに、ログの時刻とバージョンを突き合わせて切り戻せるようにしておきます。

まとめ

  • ツールはモデルが呼べる任意のコード実行です。引数も結果も信頼できない入力として扱い、被害を限定する設計にします。
  • 権限は最小限から始め、トークンは自分宛てのものだけを受け取り、下流へ転送しません。
  • 危険なツールは許可リストと引数検証で縛り、破壊的な操作には人間の承認を挟みます。
  • 実行環境は分けます。AWSではタスクロールと実行ロールを分け、秘密情報はSecrets Managerに置きます。
  • ログは「誰が・いつ・何をしたか」を追える形で残し、秘密情報はマスクします。CloudWatch LogsとCloudTrailで異常を検知します。
  • ツール定義の変更は破壊的変更として扱い、バージョンを上げて記録します。

関連記事

参考リンク

用語集

  • 最小権限の原則:必要な権限だけを与え、それ以上は与えない設計の考え方。
  • トークンパススルー:クライアントから受け取ったトークンを検証せずに下流のAPIへ転送すること。仕様で禁止されている。
  • リソースサーバー:OAuthで、保護されたリソースを持ち、トークンを検証する側。MCPサーバーがこれに当たる。
  • スコープ:トークンに与えられる権限の範囲。「読み取りだけ」「削除まで」などを表す。
  • 間接プロンプトインジェクション:ツールが返した文章などに紛れた指示を、モデルが誤って実行してしまう攻撃。
  • エリシテーション:サーバーがツール実行の途中で、クライアント経由でユーザーに確認や追加の入力を求める仕組み。
  • サンドボックス:影響範囲を限定するために用意された、分離された実行環境。
  • タスクロール/タスク実行ロール:ECSのタスクで使う2つのIAMロール。前者はアプリがAWS APIを呼ぶ権限、後者は起動時のイメージ取得や秘密情報の取得を担う。
  • CloudWatch Logs:AWSのログ収集サービス。アプリのログを集めて検索やアラームに使える。
  • CloudTrail:AWS APIの呼び出しを記録するサービス。誰が・いつ・何をしたかの監査に使う。
  • ステートレス:リクエストごとに完結し、サーバー側でセッション状態を持たない設計。
  • 破壊的変更:既存の利用方法を壊す変更。ツール名の変更や引数の必須化などが該当する。
1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?