はじめに
Claude(Claude Desktop / Claude Code)にTerraformのMCP(Model Context Protocol)サーバーを連携すると、コード生成の精度がぐっと上がります。この記事では、
- 連携時にDockerイメージが自動で立ち上がる仕組み
- なぜこれで精度が上がるのか
- 導入時に気をつけたいポイント
を整理します。
連携すると何が起きるか
Terraform MCP ServerはHashiCorpが公式に提供しているMCPサーバーで、多くの導入手順ではDockerコンテナとして動かす構成が案内されています。ClaudeのMCP設定に以下のようなコマンドを登録すると、
"mcpServers": {
"terraform-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"hashicorp/terraform-mcp-server"
]
}
}
Claude起動時(もしくはMCPサーバー追加時)にこのコマンドが実行され、ローカルにイメージがなければDockerが自動でhashicorp/terraform-mcp-serverをpullしてからコンテナを起動し、標準入出力(stdio)経由でClaudeと通信を始めます。--rmオプションが付いているため、セッション終了後はコンテナが自動削除され、常駐はしません。
HCP Terraformと連携する場合は、環境変数としてTFE_HOSTNAMEとTFE_TOKENをコンテナに渡す構成になります。
claude mcp add terraform -s user -t stdio \
-- docker run -i --rm \
-e "TFE_HOSTNAME=app.terraform.io" \
-e "TFE_TOKEN=<TFE_TOKEN>" \
hashicorp/terraform-mcp-server
Dockerを使いたくない・DinD(Docker in Docker)ができない環境(CI/CDやPoC環境など)では、Goでソースからビルドしたバイナリを直接パスに登録してterraform-mcp-server stdioを叩く方法で回避できます。
なぜ精度が上がるのか
Claude単体でTerraformコードを書かせると、学習時点の知識に頼ることになるため、プロバイダーの仕様変更・新しい引数・非推奨フィールドなどに追随できず、実在しないプロパティを提案する「ハルシネーション」が起きがちです。
Terraform MCP Serverを経由すると、ClaudeがTerraform Registryの実データをその場で検索・取得できるようになります。主なツールは次の通りです。
-
search_providers/get_provider_details:サービス名からプロバイダーの完全なドキュメント(引数の型、必須/任意、ネストしたブロック構造、非推奨フィールドまで)をMarkdown形式で取得 -
get_latest_provider_version:記憶ではなく、Registryから実際の最新バージョンを取得 -
search_modules/get_module_details:モジュールの入出力や使用例を実データで確認 -
search_policies/get_policy_details:Sentinelポリシー(ガバナンス・コンプライアンス要件)も参照可能
つまりClaudeは「たぶんこの引数だろう」と推測でコードを書くのではなく、Terraformが内部で使っているのと同じスキーマ定義を都度クエリしてから生成するようになる、というのがポイントです。これにより「存在しない引数」「無効なブロック構造」「モジュール入力の不整合」といった典型的なミスが構造的に減ります。
実例
日本語の検証記事でも効果が報告されています。あるチームがGitHub CopilotにTerraform MCP Serverを導入したところ、導入前はAzureRMに存在しない架空のプロパティを提案していたのが、導入後はAzureRMの実仕様に基づいたコードを提案するようになったとのことです。別の検証では、Terraform MCPとAWS Knowledge MCPを併用することで、depends_onやlifecycleブロックの自動挿入といった依存関係解決の精度もLLM単体より安定したという報告があります。
注意点
HashiCorp自身は「具体的な精度向上の数値」を主張しているわけではなく、「期限切れ・ハードコードされた知識に依存する際の問題を軽減するのに役立つと推測するのが妥当」という慎重な立ち位置を取っています。公式ドキュメントにも「AIハルシネーションのリスクは完全には消えないため、インフラに変更を適用する前は必ずデータを検証すること」と明記されています。
つまりMCP経由でも、terraform planの結果を人間がレビューする工程は省略できません。あくまで「参照する情報が最新かつ正確になる」ことで生成の出発点が良くなる、という位置づけで理解しておくのが良さそうです。
まとめ
- Terraform MCP ServerはDockerコンテナとして動作し、Claude接続時に自動でイメージがpullされ、
--rm付きで都度使い捨てられる - Registryの実データ(プロバイダー仕様・モジュール・ポリシー)をリアルタイム参照できることが精度向上の本質
- とはいえハルシネーションのリスクがゼロになるわけではなく、
plan結果のレビューは引き続き必須