【小ネタ】AWS Documentation MCP Server を使ってAWS認定試験のサンプル問題を作ってみた

【小ネタ】AWS Documentation MCP Server を使ってAWS認定試験のサンプル問題を作ってみた

Clock Icon2025.04.09

先日AWS MCP Servers が公開されました。

https://awslabs.github.io/mcp/

https://aws.amazon.com/jp/blogs/machine-learning/introducing-aws-mcp-servers-for-code-assistants-part-1/

そのうちの1つに AWS Documentation MCP Server があります。
AWSドキュメントの検索や推奨事項の取得が可能です。

このMCPサーバーを使って AWS認定試験のサンプル を作ってみようと思います。
(ちょうど私が AWS Certified DevOps Engineer - Professional : DOP を受験予定であることがモチベーションです)

なおMCPサーバー構築手順は割愛します。 以下ブログを参考ください。

https://dev.classmethod.jp/articles/aws-documentation-mcp-integrate-cline/

今回は Claude Code を MCPクライアントとして使いました。

(参考)Claude Code にてMCPサーバーを登録するコマンド
mcp_json=$(cat <<EOF
{
  "command": "uvx",
  "args": ["awslabs.aws-documentation-mcp-server@latest"],
  "env": {
    "FASTMCP_LOG_LEVEL": "ERROR"
  },
  "disabled": false,
  "autoApprove": []
}
EOF
)

claude mcp add-json aws-documentation-mcp-server "${mcp_json}"
# Added stdio MCP server aws-documentation-mcp-server to local config

AWS CodeBuildのサンプル問題(トラブルシューティング系)

だいたいのユーザーガイドには「トラブルシューティング」ページがあります。

認定試験にも 問題が発生 → 解決策はどれ? パターンを よく見るので、 トラブルシューティングページをベースに問題を作ってみます。

以下依頼を投げました。

AWSドキュメントの「CodeBuildのトラブルシューティング」をベースに AWS Certified DevOps Engineer - Professional のサンプル問題を1つ作ってほしい。

- 問題文を Q01.md に保存してください
- 回答/解説を A01.md に保存してください
    - A01.md には参照したドキュメントリンクを付与してください

問題作成までのやりとりを一部載せます。

sc_2025-04-09_10-33-23_6585
aws-documentation-mcp-server:search_documentation 実行の承認

sc_2025-04-09_10-33-43_11191
aws-documentation-mcp-server:read_doc 実行の承認

sc_2025-04-09_10-35-01_31027
問題の作成

sc_2025-04-09_10-36-10_1262
回答と解説の作成

生成された問題と回答がこちら。

Q01.md
# AWS Certified DevOps Engineer - Professional サンプル問題

## 質問 01
あなたはチームの DevOps エンジニアで、AWS CodeBuild を使用して Docker ベースのアプリケーション向けの CI/CD パイプラインを構築しています。
開発者から、ビルド中に Docker イメージをビルドするとエラーが発生していると報告があり、
ビルドログには次のエラーメッセージが表示されています:

```
Cannot connect to the Docker daemon at unix:/var/run/docker.sock. Is the docker daemon running?
```

このエラーを修正し、CodeBuild プロジェクトで Docker イメージの構築を成功させるために、あなたがとるべき最適な対応策は何ですか?

A. S3 バケットから SSL 証明書をインストールするように CodeBuild プロジェクトを設定する

B. イメージビルドに使用する環境変数 `HTTP_PROXY` および `HTTPS_PROXY` の設定をクリアする

C. CodeBuild プロジェクトを VPC 内に配置し、Docker レジストリにアクセスできるようにネットワーク設定を構成する

D. CodeBuild プロジェクトの特権モードを有効にし、buildspec にて Docker デーモンを起動するコマンドを追加する

E. Amazon ECR にあるカスタムビルドイメージに切り替え、Docker デーモンがプリインストールされたイメージを使用する
回答と解説
A01.md
# AWS Certified DevOps Engineer - Professional サンプル問題の解答

## 質問 01の解答
**正解: D. CodeBuild プロジェクトの特権モードを有効にし、buildspec にて Docker デーモンを起動するコマンドを追加する**

### 解説
この問題は AWS CodeBuild を使用して Docker イメージをビルドする際に発生する一般的な問題に関するものです。
「Cannot connect to the Docker daemon」というエラーメッセージは、Docker デーモンに接続できないことを示しています。

選択肢の分析:

**A. S3 バケットから SSL 証明書をインストールするように CodeBuild プロジェクトを設定する**
- この選択肢は不適切です。SSL 証明書のインストールは、自己署名証明書を使用している
  プライベートリポジトリに接続する際の問題を解決するためのものであり、Docker デーモンの接続問題とは関係ありません。

**B. イメージビルドに使用する環境変数 `HTTP_PROXY` および `HTTPS_PROXY` の設定をクリアする**
- この選択肢も不適切です。プロキシ設定は主にネットワーク接続の問題に関連しており、
  Docker デーモンへの接続問題を解決するものではありません。

**C. CodeBuild プロジェクトを VPC 内に配置し、Docker レジストリにアクセスできるようにネットワーク設定を構成する**
- この選択肢は不適切です。VPC 設定は外部リソースへのアクセスに関する問題を解決するためのものであり、
  Docker デーモンの実行に関する問題とは直接関係ありません。

**D. CodeBuild プロジェクトの特権モードを有効にし、buildspec にて Docker デーモンを起動するコマンドを追加する**
- これが正解です。Docker イメージをビルドするには、CodeBuild プロジェクトで特権モードを有効にする必要があります。
  これにより Docker デーモンの起動と操作が可能になります。
  そして buildspec ファイルの install フェーズで Docker デーモンを起動するコマンドを追加する必要があります。

**E. Amazon ECR にあるカスタムビルドイメージに切り替え、Docker デーモンがプリインストールされたイメージを使用する**
- この選択肢は不適切です。カスタムビルドイメージに Docker デーモンがプリインストールされていても、
  Docker コンテナ内で Docker を実行するには特権モードが必要です。また、デーモンを起動するコマンドも必要となります。

実装手順:
1. CodeBuild コンソールでビルドプロジェクトを編集し、「環境」セクションの「追加設定」から「特権モード」を有効にします。
2. buildspec ファイルの install フェーズに以下のようなコマンドを追加して Docker デーモンを起動します:

```yaml
phases:
  install:
    commands:
      - nohup /usr/local/bin/dockerd --host=unix:///var/run/docker.sock --host=tcp://127.0.0.1:2375 --storage-driver=overlay2 &
      - timeout 15 sh -c "until docker info; do echo .; sleep 1; done"
```

このアプローチは、CodeBuild 環境内で Docker デーモンを実行し、Docker コンテナのビルドと実行を可能にします。

### 参考ドキュメント
- [AWS CodeBuild のトラブルシューティング - Docker デーモンに接続できない場合のエラー](https://docs.aws.amazon.com/codebuild/latest/userguide/troubleshooting.html#troubleshooting-cannot-connect-to-docker-daemon)
- [Docker を使用するための CodeBuild のサンプル](https://docs.aws.amazon.com/codebuild/latest/userguide/sample-docker-custom-image.html)

良い感じですね! トラブルシューティングページの以下部分を問題にしてくれました。

sc_2025-04-09_10-45-56_29273
画像: AWS CodeBuild のトラブルシューティング - Docker デーモンに接続できない場合のエラー

AWS Organizationsのサンプル問題(ベストプラクティス系)

同じく、いくつかのユーザーガイドには「ベストプラクティス(やユースケース)」ページがあります。

ベストプラクティスを問うような問題を作ってみます。 以下依頼を投げました。

AWSドキュメントの「AWS Organizations のベストプラクティス」をベースに AWS Certified DevOps Engineer - Professional のサンプル問題を1つ作ってほしい。

- 問題文を Q02.md に保存してください
- 回答/解説を A02.md に保存してください
    - A02.md には参照したドキュメントリンクを付与してください

Claude Code とのやりとりの流れはこんな感じです。

⏺ まず、AWSドキュメントの「AWS Organizations のベストプラクティス」を検索して内容を確認します。
⏺ aws-documentation-mcp-server:search_documentation (MCP(search_phrase: "AWS Organizations …
                                                        ベストプラクティス")
# ...略...

⏺ 「Best practices for managing organizational units (OUs) with AWS Organizations」のドキュメントを確認します。

⏺ aws-documentation-mcp-server:read_doc(url: "https://docs.aws.amazon.com/organizations/latest/userguide/orgs_…a
  umentation (MCP)                     nage_ous_best_practices.html")

# ...略...

⏺ また、一般的なOrganizationsのベストプラクティスについても確認します。
⏺ aws-documentation-mcp-server:search_documentation (MCP)(search_phrase: "AWS Organizations best practices")…
⏺ aws-documentation-mcp-server:read_docume(url: "https://docs.aws.amazon.com/organizations/latest/userguide/or…s
  ntation (MCP)                           _best-practices.html")

# ...略...

⏺ さらにOrganizationsのSCPに関する情報も確認します。
⏺ aws-documentation-mcp-server:read_docu(url: "https://docs.aws.amazon.com/organizations/latest/userguide/org…
  entation (MCP)                        _manage_policies_scps.html")

# ...略...

⏺ これらの情報を元に、DevOps Engineer - Professional のサンプル問題を作成します。
  まず、問題文をQ02.mdに作成します。

⏺ Write(file_path: Q02.md)# ...略...

⏺ 次に、回答と解説をA02.mdに作成します。
⏺ Write(file_path: A02.md)# ...略...

⏺ 問題と解答を作成しました。

  AWS Organizations のベストプラクティスに基づいた AWS Certified DevOps Engineer - Professional
  のサンプル問題を作成し、Q02.md に問題文を、A02.md に解答と解説を保存しました。

  この問題では、複数アカウントを持つ企業環境で、AWS Organizations と SCP
  を使用して本番環境と開発環境の権限管理を適切に設定する方法を問うています。また、解答では AWS Organizations
  のベストプラクティスに沿った説明と、参照したドキュメントへのリンクを含めています。

生成された問題と回答がこちら。

Q02.md
# AWS Certified DevOps Engineer - Professional サンプル問題

あなたは、大規模な金融サービス企業の DevOps エンジニアとして、AWS Organizations を使用してクラウド環境を構築しています。
組織は急速に成長しており、現在は 150 以上の AWS アカウントが存在します。
セキュリティチームは、本番環境でのリソースの削除を制限するためのコントロールを求めています。
また、すべての開発者が必要に応じてテスト環境でリソースを自由に作成・削除できるようにしたいと考えています。

現在の AWS Organizations の構造は次のとおりです:

- Root
  - Security OU
    - Security Tooling アカウント
    - Log Archive アカウント
  - Infrastructure OU
    - Shared Services アカウント
    - Network アカウント
  - Workloads OU
    - Production OU
      - Banking App アカウント
      - Payment Processing アカウント
      - Customer Portal アカウント
    - Development OU
      - Dev アカウント
      - Test アカウント
      - Staging アカウント

既存のサービスコントロールポリシー (SCP) は、すべてのアカウントに `FullAWSAccess` ポリシーのみを適用しています。

セキュリティ要件を満たし、AWS Organizations のベストプラクティスに従うために、次の施策を実施する必要があります:

1. 本番環境のすべてのアカウントにおいて、特定の承認された IAM ロールを除き、
   EC2、RDS、Lambda、S3 などの重要なサービスのリソース削除を防止する。
2. 開発環境では、開発者が自由にリソースを作成・削除できるようにする。
3. すべての環境において、IAM ユーザーの作成を禁止し、代わりに IAM ロールを使用するように強制する。

**質問**: この要件を満たすために、AWS Organizations の構成として最も効果的な方法はどれですか?

A. `FullAWSAccess` ポリシーを削除し、代わりに明示的に許可されたアクションのみを列挙した単一の SCP を組織のルートに適用する。
   承認された IAM ロールには、リソース ARN ベースの条件を使用してアクセス許可を付与する。

B. `FullAWSAccess` ポリシーを保持し、Production OU に対して重要なサービスの削除アクションを拒否する SCP を追加する。
   拒否ステートメントには、承認された IAM ロールの ARN を条件として「NotPrincipal」要素を含める。また、すべての OU に IAM ユーザー作成を拒否する別の SCP を適用する。

C. 組織のルートに `FullAWSAccess` ポリシーを保持し、AWS CloudFormation と AWS Service Catalog のみを使用して
   リソース管理を行うよう強制する SCP を Production OU に適用する。Development OU には制限を適用しない。

D. Production OU に、重要なリソースの削除アクションを拒否し、承認された IAM ロールに例外を設ける SCP を適用する。
   組織のルートに、IAM ユーザー作成を拒否する SCP を適用する。`FullAWSAccess` ポリシーはすべてのアカウントに対して保持する。
回答と解説
A02.md
# AWS Certified DevOps Engineer - Professional サンプル問題 解答・解説

## 正解: D

Production OU に、重要なリソースの削除アクションを拒否し、承認された IAM ロールに例外を設ける SCP を適用する。
組織のルートに、IAM ユーザー作成を拒否する SCP を適用する。`FullAWSAccess` ポリシーはすべてのアカウントに対して保持する。

## 解説

この問題は AWS Organizations のサービスコントロールポリシー (SCP) の効果的な使用方法と、OU (組織単位) の階層構造を活用した権限管理に関するものです。
AWS Organizations のベストプラクティスに基づいて各選択肢を評価します。

### 選択肢 A が不正解である理由:

`FullAWSAccess` ポリシーを削除し、明示的に許可されたアクションのみを列挙した単一の SCP を組織のルートに適用するというアプローチは、
「許可リスト」アプローチと呼ばれます。このアプローチには以下の問題があります:

- 組織全体の全サービスに対する許可アクションをすべて列挙する必要があり、管理が非常に複雑になります。
- 新しい AWS サービスが導入された場合、SCP を更新しないとそのサービスにアクセスできなくなります。
- 本番環境と開発環境で異なるポリシーを適用することが困難です。

また、AWS の公式ドキュメントでは、SCP の管理を簡素化するために「拒否リスト」アプローチを推奨しています。

### 選択肢 B が不正解である理由:

この選択肢では SCP の「NotPrincipal」要素を使用していますが、SCP では IAM ポリシーとは異なり、
Principal または NotPrincipal 要素を使用できません。
SCP は IAM ユーザーやロールに直接アクセス権を付与するものではなく、
アカウント内で IAM ポリシーによって付与できる許可の最大範囲を定義するものです。

### 選択肢 C が不正解である理由:

CloudFormation と Service Catalog のみを使用してリソース管理を強制するというアプローチは、
リソース削除の問題に間接的に対処しますが、特定のユースケースでは制限が厳しすぎる可能性があります。
また、この方法では開発環境に制限を適用しないことで IAM ユーザー作成を禁止するという要件が満たされません。

### 選択肢 D が正解である理由:

この選択肢は AWS Organizations のベストプラクティスに沿った最適な解決策です:

1. **階層構造を活用した権限管理**: Production OU レベルで特定のリソース削除アクションを拒否することで、
   その OU 内のすべてのアカウントに制限が適用されます。これはOU構造を基に共通のコントロールを適用するというベストプラクティスに準拠しています。

2. **最小特権の原則の適用**: 承認された IAM ロールのみがリソース削除を実行できるという例外条件を設けることで、必要な権限のみを付与しています。

3. **拒否リストアプローチの採用**: `FullAWSAccess` ポリシーを保持し、特定のアクションのみを拒否することで、管理が容易になります。これは AWS が推奨するアプローチです。

4. **IAM ユーザー作成の禁止**: 組織のルートレベルで IAM ユーザー作成を拒否する SCP を適用することで、すべての OU とアカウントに適用されます。

5. **異なる環境に対する差別化された制御**: Production OU にのみ削除制限を適用し、Development OU には適用しないことで、
   開発者が開発環境で自由にリソースを作成・削除できるようにしています。

AWS Organizations では、複数の SCP がアカウントに適用される場合、アクションが許可されるためにはすべての適用可能な SCP で許可される必要があります。
拒否ステートメントが一つでもあれば、そのアクションは拒否されます。この挙動を理解することで、OU 階層の異なるレベルに SCP を適用する戦略を効果的に立てることができます。

## 参考ドキュメント

- [Best practices for managing organizational units (OUs) with AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_ous_best_practices.html)
- [Best practices for a multi-account environment](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_best-practices.html)
- [Service control policies (SCPs)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html)

ボリューミーな問題が生成されましたね。 SCPが対応していない要素 をピックアップした 「引っ掛かりやすい設問」がすごく良いと感じました。

おわりに

AWS Documentation MCP Server を使ってみました。 とても便利です。

問題と回答の質がとても良いように感じました。 何よりも公式ドキュメントへのリンクがあるため、 間違えた部分の深堀りもはかどります。

以上、参考になれば幸いです。

参考

https://awslabs.github.io/mcp/

https://aws.amazon.com/jp/blogs/machine-learning/introducing-aws-mcp-servers-for-code-assistants-part-1/

https://dev.classmethod.jp/articles/aws-documentation-mcp-integrate-cline/

Share this article

facebook logohatena logotwitter logo

© Classmethod, Inc. All rights reserved.