【MCP】VSCodeでAWS MCPサーバを設定する（Amazon Q Developer for IDEでの設定を含む）

Last updated at 2025-11-03Posted at 2025-10-27

遅ればせながら、MCPサーバを設定してAWSの公式ドキュメントやベストプラクティスを参照しながら作業したい！と思い立ったので、自分の環境にもMCPを設定みます。

環境

macOS：Tahoe 26.0.1
VSCode：1.105.1 (Universal)

環境準備

AWSのMCPサーバを使用するために以下が必要とのことなので、準備していきます。

Installation Requirements

Install uv from Astral or the GitHub README

Install Python 3.10 or newer using uv python install 3.10 (or a more recent version)

uvのインストール・設定

以下のサイトを参照いただければと思います。

Installation | uv

pythonのインストール

執筆時点（2025/10/27）の最新は3.14.0だったので、そちらをインストールしてます。

uv python install 3.14.0

MCPサーバの設定

VSCodeにMCPサーバを設定していきます。

VSCodeのエージェントモード有効化

設定画面から chat.agent.enabled と検索すると設定項目が出てきますので、チェックを入れます。

settiong.jsonにMCPサーバ設定を記述する（NGパターン）

setting.jsonは複数種類があって、編集可能なもので以下の2つがあります。

User Settings (ユーザー設定)
ユーザー設定は、VSCode全体に適用される設定です。全体で一括設定したい場合や、複数のプロジェクトにまたがって適用したいときはこちらを設定します。
Workspace Settings (ワークスペース設定)
特定のプロジェクト（ワークスペース）にのみ適用される設定です。プロジェクトごとに異なる設定を行いたい場合はこちらを使うと良いです。

今回は「User Settiongs（ユーザー設定）」を設定していきます。

コマンドパレットを開いて**「Preferences: Open User Settings (JSON)」**を選択します。

setting.json にMCPサーバの設定を追記して完了！と思っていたのですが、「MCP サーバーは、ユーザー設定で構成しないでください。代わりに専用の MCP 構成を使用してください。」という警告が出ました。

mcp.jsonにMCPサーバ設定を記述する（OKパターン）

settings.json に記述せずに、mcp.json に記述するのが正解のようです。

VSCodeの公式ドキュメント貼っておきます。

MCP 構成の自動検出のファイルの場所

Visual Studio では、他の開発環境が設定した MCP 構成もチェックされます。 MCP サーバー構成は、次のディレクトリから次の順序で読み取られます。

%USERPROFILE%\.mcp.json特定のユーザーのグローバル MCP サーバー構成として機能します。ここに MCP サーバーを追加すると、すべての Visual Studio ソリューションに対して読み込まれます。

<SOLUTIONDIR>\.vs\mcp.jsonVisual Studio に固有で、指定したソリューションの特定のユーザーに対してのみ、指定された MCP サーバーを読み込みます。

<SOLUTIONDIR>\.mcp.jsonリポジトリのソース管理で追跡できる MCP 構成を探している場合に適しています。

<SOLUTIONDIR>\.vscode\mcp.jsonリポジトリ/ソリューションにスコープが設定され、通常はソース管理されません。

<SOLUTIONDIR>\.cursor\mcp.jsonリポジトリ/ソリューションにスコープが設定され、通常はソース管理されません。

これらの場所には .mcp.jsonが必要な場所もあれば、 mcp.jsonが必要な場所もあります。

2025/11/03　追記
Microsoftの公式ドキュメントに、VSCodeのmcp.jsonに対する記載方法が載っていたので、そちらを追記。

ちなみにmacOSだと ~/Library/Application Support/Code/User に保存されています。

mcp.json にMCPサーバを記述していきます。
”servers” の枠内にMCPサーバを複数記述していけるような感じですね。

{
	"servers": {
		"awslabs.aws-documentation-mcp-server": {
			"command": "/Users/{ユーザ名}/.local/bin/uvx",
			"args": [
				"awslabs.aws-documentation-mcp-server@latest"
			],
			"env": {
				"FASTMCP_LOG_LEVEL": "ERROR"
			},
			"disabled": false,
			"autoApprove": [],
			"type": "stdio"
		}
	},
	"inputs": []
}

複数サーバを記述するときはこんな感じ。

{
	"servers": {
		"awslabs.aws-documentation-mcp-server": {
			"command": "/Users/{ユーザ名}/.local/bin/uvx",
			"args": [
				"awslabs.aws-documentation-mcp-server@latest"
			],
			"env": {
				"FASTMCP_LOG_LEVEL": "ERROR"
			},
			"disabled": false,
			"autoApprove": [],
			"type": "stdio"
		},
		"awslabs.cdk-mcp-server": {
			"command": "/Users/{ユーザ名}/.local/bin/uvx",
			"args": [
				"awslabs.cdk-mcp-server@latest"
			],
			"env": {
				"FASTMCP_LOG_LEVEL": "ERROR"
			},
			"disabled": false,
			"autoApprove": []
		}
	},
	"inputs": []
}