HashiCorp Terraform（HCP Terraform）

Claude Codeに、どこまで権限を渡せるか

読み取り専用で渡せるか あり

公式の記載を2ページ合わせると、チームのワークスペース権限を Read に限ったチームのトークンで読み取り中心にできる。①API tokens ページ：チームトークンは、そのチームがアクセスできるワークスペースに対して「チームと同じアクセスレベル」。②ワークスペース権限ページ：Read は実行履歴・状態・変数値などの閲覧のみで、plan/apply、変数の編集、状態バージョンの作成、設定の変更、ロックは含まれない。注意：「読み取り専用トークン」という名前の種別は公式に記載なし。Read でも状態ファイル（機密を含み得ると公式が注記）と変数値は読める。チームのorganization・プロジェクト単位の権限が別に必要になるかは今回確かめていない。

権限（スコープ）を選べるか あり

MCP側は --toolsets（registry／registry-private／terraform／all／default）と --tools で使えるツールを絞れる。HCP Terraform側のトークンはユーザー・チーム・組織の3種（ほかに監査・メトリクス・エージェント用）。ユーザートークンは本人の権限、チームトークンはそのチームのアクセス、組織トークンは組織全体のCRUD（ただしrunの開始や構成バージョンの作成はできない）と記載。読み取り専用トークンという種類の記載はない（https://developer.hashicorp.com/terraform/cloud-docs/users-teams-organizations/api-tokens ）。get_token_permissions ツールでTFE_TOKENの権限を取得できる。リモート運用では組織の許可リストで組織を限定できる。

危険な操作の既定

ENABLE_TF_OPERATIONS の既定は false。リファレンスの記載では、これが次をゲートする: action_run（apply／discard／cancel）、delete_workspace_safely、force_unlock_workspace、delete_project、delete_team、create_runの auto_approve と is_destroy。一方 create_workspace（「destructive」）・update_workspace（「potentially destructive」）はゲート対象外と読める。delete_variable_in_variable_set もゲート対象の記載なし。READMEはENABLE_TF_OPERATIONSを「Enable tools that require explicit approval」、リファレンスは「Enable destructive Terraform operations」と書き、表現が異なる。「有効にすると永続的にインフラを変更・破壊しうる」との警告、READMEに「信頼できないMCPクライアントやLLMと使わない」とある。

削除ができるか できる

【MCP・ENABLE_TF_OPERATIONS=trueが必要】delete_workspace_safely（リソースを管理していないワークスペースのみ）、delete_project（ワークスペースやStacksが残っていると失敗）、delete_team（永続削除）。create_runのis_destroyで破棄runを作成し、action_runで適用できる。【MCP・ゲートの記載なし】delete_variable_in_variable_set（変数セット内の変数の削除）。【CLI】-destroyによる破棄計画とapply。

取り消し方（キー・接続）

HCP Terraformのトークン（公式 api-tokens ページ）: チームトークンは Team tokens タブの Actions から Delete（一括削除も可）。組織トークン・監査トークン・メトリクストークンは組織オーナーが Organization settings > API Token で生成・取り消し（組織トークンは1組織に有効な1つ）。ユーザートークンの削除手順は同ページに記載なし（Usersのドキュメント参照とのみ）。組織オーナーは Settings > API tokens > User Tokens でユーザートークンを組織に対して無効にできる。user／team／organizationトークンは期限があり作成後に変更不可。

根拠のページ

つなぎ方（公式の資料にある範囲）

できる操作

読み取りでできる操作

• 【MCP】registry: プロバイダー・モジュール・ポリシーの検索と詳細、最新バージョン（トークン不要）。terraform: 組織・プロジェクト・チーム・ワークスペース・run・プラン／適用のログ・状態バージョン・ポリシーセット・変数・タグ・stacksの一覧と詳細、トークンの権限の取得
• 【CLI】terraform plan／showでの計画確認（applyのページで言及）

書き込みでできる操作

• 【MCP】プロジェクト・チーム・ワークスペースの作成、ワークスペースの更新、チームメンバー追加・アクセス付与、ポリシーセットのワークスペースへの取り付け、変数・タグの変更、run の作成（create_run）
• 【CLI】terraform apply（既定で承認の確認あり）

管理者操作（削除・課金・設定変更など）

• 【MCP】ENABLE_TF_OPERATIONS=true のときに、action_runでrunのapply／discard／cancel、delete_workspace_safelyでワークスペース削除（リソースを管理していない場合のみ）、force_unlock_workspaceで強制アンロック、delete_projectでプロジェクト削除、delete_teamでチームの永続削除。create_runでauto_approve・is_destroy（破棄run）を使うにも有効化が必要。ENABLE_TF_OPERATIONSの記載がない delete_variable_in_variable_set（変数セット内の変数の削除）や各種の作成・更新・権限付与ツールは、falseのままでも使える
• 【CLI】terraform apply -auto-approve は確認を省略、保存済みプランの適用も確認なし。-destroyは破棄計画のモード

制限

• ENABLE_TF_OPERATIONS=false が既定。有効化するとapply・discard・cancel・ワークスペース削除・プロジェクト削除・チーム削除が使える。falseのままでも、記載のない書き込み系ツール（変数の削除を含む）は使える
• MCPサーバーの配布形態はdockerイメージ（hashicorp/terraform-mcp-server）などで、READMEにベータの記載はない。リリース日はREADMEのReleases欄が空で未確認
• HCP Terraformのプラン別機能・MCPの対象プランは今回の取得ページに記載なし

認証・料金・日本語・実機検証

認証方式

【MCP】TFE_TOKEN（HCP Terraform／Terraform Enterpriseのトークン）とTFE_ADDRESS。レジストリの認証にはMCP v0.3.0以上が必要、プライベートレジストリにはHCP Terraform／Terraform Enterpriseのトークンが必要と記載。TFE_ADDRESSはクライアントからは設定できず、サーバー側の環境変数のみ。HCP Terraformのトークンはユーザー・チーム・組織の3種（APIドキュメント: ユーザートークンは本人の代わり、チームトークンはCI/CD向け、組織トークンはチーム・メンバー・ワークスペースの自動化用でplan・applyは不可。api-tokensページ: 組織トークンは組織全体のCRUDだがrunの開始や構成バージョンの作成はできない）。

公表されている料金（2026年10月17日確認）

従量課金（PAYG・月次請求）。IBMの料金ページに『IBM Terraform』として掲載、管理対象リソース（RUM）1時間あたり、Essentials USD 0.00013／Standard USD 0.00064／Premium USD 0.00135。同時実行アドオン（Standard・Premiumのみ）は Remote USD 0.32877／Agent USD 0.16438（同時実行1つ・1時間あたり）。ページに『Prices shown are indicative』、税・関税別。新規向けのUSD 500クレジットは割引扱いで基本価格に含めない。HashiCorp側ページには金額なし（2026年10月確認）。 料金ページ

日本語対応

未確認。ドキュメント（developer.hashicorp.com）と管理画面の日本語対応は今回確認できていない。

Claude Code実機検証

未検証（この台帳は、動かして確かめた記録ではありません。Akiraが試したときは、検証日つきで書き換えます）