Terraform MCP Serverとは？
Terraform MCP Server はエージェントを公開の Terraform Registry につなぎ、インフラのコードを書きながら、最新のプロバイダーのドキュメント、モ ジュール、ポリシーを調べられるようにします。HCP Terraform または Terraform Enterprise のトークンがあれば、組織、プロジェクト、チーム、ワークスペース、変数、タグ、実行、ステートのバージョンも管理できます。HashiCorp のリファレンスには 61 個のツールが挙がっています。公開 Registry 向けが 9 個、プライベートレジストリ向けが 4 個、HCP Terraform 向けが 48 個です。
通常は Docker イメージ（docker run -i --rm hashicorp/terraform-mcp-server）として stdio で動かすか、Go のバイナリとして動かします。Streamable HTTP モードは共有のデプロイに対応し、Helm チャート、TLS、レート制限、厳格な CORS、組織の許可リスト、ユーザーごとのトークンの受け渡しを備えています。最新リリースは 2026年8月26日の 1.3.0 で、ライセンスは MPL-2.0 です。
Terraform MCP Serverのインストール方法
docker run -i --rm hashicorp/terraform-mcp-serverTerraform MCP Serverは使う価値があるか？
モデルが Terraform を書くときに最もよくある失敗は、古いリソース引数や存在しない引数を使うことです。search_providers や get_provider_details などの 9 つのツールによる Registry のライブ検索でその多くが解決し、この部分にはトークンも HashiCorp のアカウントも不要です。
HCP Terraform の側は、README から受ける印象以上に検討が必要です。ENABLE_TF_OPERATIONS が制御するのは、5 つの破壊的なツール（action_run、delete_workspace_safely、force_unlock_workspace、delete_project、delete_team）と、create_run の auto_approve と is_destroy のオプションだけです。create_run そのもの、ドキュメントが破壊的になりうるとしている update_workspace、変数の書き込み、grant_team_access は、トークンを持つどのエージェントでも使えるままです。本当の制御手段は、明示的な許可リストを受け取る --tools フラグで、2 番目がトークン自体の権限です。
データの露出はツール一覧を見れば明らかです。get_plan_json_output、get_plan_logs、get_state_version は、リソースの属性や機密値をモデルのコンテキストに持ち込むことがあり、HashiCorp の README は、信頼できないクライアントやモデルでこのサーバーを使わないよう求めています。HTTP モードは妥当に強化されています。クライアントは TFE_ADDRESS を上書きできないため、リクエストがトークンを別のホストに向けることはできません。クエリ文字列に含まれるトークンは拒否されます。また、偽装可能な値を信頼していた以前の X-Forwarded-For の処理は、信頼するホップ数を明示する設定に置き換えられました。
コンテキストは目立たないコストです。--toolsets フラグを指定しないとサーバーはすべてのツールセットを有効にし、トークンがあると 61 個のツール定義がすべてセッションごとに読み込まれます。ドキュメントの検索だけが必要なチームは --toolsets=default で 9 つの Registry ツールだけを残せます。これは HashiCorp が提供する最も安全な構成でもあります。
真価を発揮する場面
Claude Code で AWS のモジュールを書くプラットフォームエンジニア
plan の時点で失敗するリソース引数をエージェントがでっち上げないようにする
--toolsets=default でコンテナを動かします。エージェントは HCL を書く前に、プロバイダーのドキュメントと最新のプロバイダーバージョンを確認します。トークンもアカウントも不要で、ツール定義は 61 個ではなく 9 個です。
HCP Terraform を使う SRE
コンソールを開かずに、昨夜の実行が失敗した理由を説明する
読み取り範囲のトークンと、list_runs、get_run_details、get_plan_logs に限定した --tools を使えば、エージェントが失敗内容を読んで修正を提案します。HCP Terraform の API はユーザーごとに毎秒 30 リクエストまで許可しており、エージェントのループがこれに達することはまずありません。
Terraform Enterprise を使うエンジニア 300 人の企業のプラットフォームチーム
各エンジニアの権限を保ったまま、共有の MCP エンドポイントを 1 つ提供する
Helm チャートから HTTP モードを TLS、MCP_ALLOWED_ORIGINS、組織の許可リスト付きでデプロイします。各ユーザーは自分のトークンを送るので Terraform Enterprise の RBAC は引き続き適用され、OpenTelemetry のメトリクスでツール呼び出しの量とエラーがわかります。
導入前に確認すること
- 導入
- claude mcp add terraform -s user -t stdio -- docker run -i --rm hashicorp/terraform-mcp-server を実行し、HCP の機能を使うなら TFE_TOKEN と TFE_ADDRESS を追加します。HashiCorp は VS Code、Cursor、Claude Desktop、Claude Code、Codex CLI、Amazon Q、Kiro、Gemini の拡張機能、IBM Bob の手順を載せています。
- 連携
- 61 個のツールです。公開 Registry 向けが 9 個、プライベートレジストリ向けが 4 個、HCP Terraform 向けが 48 個で、プロジェクト、チーム、ワークスペース、実行、plan、apply、ステートのバージョン、ポリシーセット、変数セット、タグ、Stacks（読み取り専用）をカバーします。ツールセットや個々のツールをフラグで有効にできます。
- データとプライバシー
- ローカルか自分のホストで動きます。通常の Registry と HCP の API 呼び出し以外に、HashiCorp を経由するものはありません。エージェントにできることはトークンの権限で制限され、plan とステートの出力はモデルに機密値をさらすことがあります。
- 大規模利用時のコスト
- サーバーは MPL-2.0 で無料です。HCP Terraform や Terraform Enterprise は HashiCorp のプランに基づ いて課金され、ここでは扱いません。HCP の API は、トークンの数にかかわらずユーザーごとに毎秒 30 リクエストまでです。HTTP モードは独自の既定値として、全体で毎秒 10（バースト 20）、セッションごとに毎秒 5（バースト 10）の制限を加えます。
- 制限
- リファレンスはツールを読み取りと書き込みに分類していません。create_workspace と update_workspace は破壊的とされていますが、制御の対象外です。localhost 以外への HTTP デプロイには TLS 証明書が必要です。
良い点
- トークンなしで最新のプロバイダー、モジュール、ポリシーのドキュメント
- きめ細かな --tools の許可リスト
- ユーザーごとのトークンと組織の許可リストを備えた、強化された HTTP モード
- 破壊的な操作の大半は既定で無効
気になる点
- 実行、ワークスペースの更新、変数の書き込みは制御されない
- plan とステートのツールがモデルのコンテキストにシークレットを入れることがある
- トークンがあると既定で 61 個のツール定義が読み込まれる
- Docker か Go が必要で、企業の TLS インスペクション環境では CA のマウントが必要
おすすめの人
AI の助けを借りて Terraform を書くチーム。特に、ツールの許可リストを設定する HCP Terraform や Terraform Enterprise のチーム。
Terraform MCP Serverの代替
Terraform MCP Server：よくある質問
- Terraform MCP Serverは使う価値があるか？
- Registry の検索だけでもインストールする価値があります。HCP Terraform のトークンを渡すのは、48 個のワークスペース用ツールのうちどれをエージェントに持たせるかを決めてからにしてください。 評価は5点満点中4.2点です。
- Terraform MCP Serverの料金は？
- MPL-2.0 で無料です。HCP Terraform の機能は HashiCorp のプランによります。
- Terraform MCP Serverの欠点は？
- 実行、ワークスペースの更新、変数の書き込みは制御されない; plan とステートのツールがモデルのコンテキストにシークレットを入れることがある; トークンがあると既定で 61 個のツール定義が読み込まれる; Docker か Go が必要で、企業の TLS インスペクション環境では CA のマウントが必要.
- Terraform MCP Serverは誰に向いているか？
- AI の助けを借りて Terraform を書くチーム。特に、ツールの許可リストを設定する HCP Terraform や Terraform Enterprise のチーム。
- チームや本番 環境でTerraform MCP Serverを使うと費用はいくらか？
- サーバーは MPL-2.0 で無料です。HCP Terraform や Terraform Enterprise は HashiCorp のプランに基づいて課金され、ここでは扱いません。HCP の API は、トークンの数にかかわらずユーザーごとに毎秒 30 リクエストまでです。HTTP モードは独自の既定値として、全体で毎秒 10（バースト 20）、セッションごとに毎秒 5（バースト 10）の制限を加えます。
- Terraform MCP Serverは企業データを扱っても安全か？
- ローカルか自分のホストで動きます。通常の Registry と HCP の API 呼び出し以外に、HashiCorp を経由するものはありません。エージェントにできることはトークンの権限で制限され、plan とステートの出力はモデルに機密値をさらすことがあります。
- Terraform MCP Serverの代わりになるものは？
- 当サイトでレビューした中で最も近い代替はAWS MCP Server 、 Azure MCP Serverです。
回答確認日：2026年10月22日