Terraform MCP ServerがHCP Terraformと連携できるようになったのでClaude CodeでHCP TerraformにWorkspaceを作ってみた
2025年5月にTerraform MCPサーバーがリリースされました。
HashiCorp at Microsoft Build 2025: New products to automate, secure, and scale on Azure
リリース当初は、HCP Terraform・Terraform Enterpriseとの連携はできませんでした。
そして、2025年9月に開催されたHashiConfでHCP Terraform・Terraform Enterpriseとの連携が発表されました。
Scale infrastructure with new Terraform and Packer features at HashiConf 2025
今回は、Claude CodeからTerraform MCPサーバーを使って、HCP Terraformの操作を試してみようと思います。
Claude CodeにTerraform MCPサーバーを追加する
ローカルでDockerを使ってMCPサーバーを追加します。
TFE_TOKEN
をセットする必要があるため、あらかじめ取得して控えておきます。
一度terraform login
したことがある場合は、ユーザー用のトークンがデフォルトで~/.terraform.d/credentials.tfrc.json
に保存されています。(Macの場合)
このトークンをTFE_TOKEN
にセットして利用することも可能です。
以下の手順を参考にMCPサーバーを追加します。
コマンドを実行します。
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
Terraform MCPサーバーが追加できたか確認します。
claude
/mcp
terraform
connected
になっていればOKです。
Terraform MCPサーバーを使ってHCP TerraformにWorkspaceを作成してみる
Terraform MCPサーバーでHCP Terraformにどんな操作ができるか知りたい場合は以下のドキュメントから確認できます。
Workspace、Project、Private Module、Policyと一通りの操作ができるツールが提供されています。
試しにWorkspaceの一覧を確認してみます。
sato-masaki-demo配下のWorkspace一覧を取得してください
今度はWorkspaceを作ってもらいます。
sato-masaki-demo配下にtest-mcp-sato Workspaceを作成してください
コンソール上からもWorkspaceが作成されていることを確認できました。
最後に作ったWorkspaceの削除をしてもらいます。
sato-masaki-demo配下のtest-mcp-sato Workspaceを削除してください
削除ができなかったようです。
ドキュメントを確認したところ、破壊的な変更にはENABLE_TF_OPERATIONS
環境変数をセットする必要があるようです。
Manage Terraform Cloud/Enterprise resources including workspaces, runs, variables, and private modules. Some tools require the ENABLE_TF_OPERATIONS environment variable for destructive operations.
一度MCPサーバーを削除して、再度追加します。
# 削除
claude mcp remove terraform
# ENABLE_TF_OPERATIONSをセットして再度追加
claude mcp add terraform -s user -t stdio \
-- docker run -i --rm \
-e "TFE_HOSTNAME=app.terraform.io" \
-e "TFE_TOKEN=<TFE_TOKEN>" \
-e "ENABLE_TF_OPERATIONS=true" \
hashicorp/terraform-mcp-server
もう一度削除を依頼します。
sato-masaki-demo配下のtest-mcp-sato Workspaceを削除してください
今度は削除に成功しました。
おわりに
Terraform MCPサーバーがHCP Terraformと連携したことで、できることの幅が増えました。
以前HCP Terraformと生成AIを使ったHCP Terraformワークフローを考えてみたのですが、今回のTerraform MCPサーバーを使うことでより便利なワークフローを作れそうです。