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

https://dev.classmethod.jp/articles/terraform-mcp-server-hashicorp/

リリース当初は、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にセットして利用することも可能です。

https://developer.hashicorp.com/terraform/enterprise/users-teams-organizations/api-tokens

以下の手順を参考にMCPサーバーを追加します。

https://github.com/hashicorp/terraform-mcp-server?tab=readme-ov-file#usage-with-claude-code

コマンドを実行します。

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にどんな操作ができるか知りたい場合は以下のドキュメントから確認できます。

https://developer.hashicorp.com/terraform/docs/tools/mcp-server/reference#available-tools

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.

https://developer.hashicorp.com/terraform/docs/tools/mcp-server/reference#terraform-cloud-enterprise-tools

一度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サーバーを使うことでより便利なワークフローを作れそうです。

https://dev.classmethod.jp/articles/terraform-workflow-hcptf-claudecode-study-group/