Was ist Terraform MCP Server?
Der Terraform MCP Server verbindet Agenten mit der öffentlichen Terraform Registry, damit sie beim Schreiben von Infrastrukturcode aktuelle Provider-Dokumentation, Module und Policies nachschlagen können. Mit einem Token für HCP Terraform oder Terraform Enterprise verwaltet er außerdem Organisationen, Projekte, Teams, Workspaces, Variablen, Tags, Runs und State-Versionen. Die Referenz von HashiCorp listet 61 Tools: 9 für die öffentliche Registry, 4 für private Registries und 48 für HCP Terraform.
Meist läuft er als Docker-Image (docker run -i --rm hashicorp/terraform-mcp-server) über stdio oder als Go-Binary. Ein Streamable-HTTP-Modus bedient gemeinsam genutzte Deployments, mit Helm-Chart, TLS, Rate Limits, strengem CORS, einer Allowlist für Organisationen und Weiterreichen von Tokens pro Nutzer. Das neueste Release ist 1.3.0 vom 26. August 2026, unter MPL-2.0.
Terraform MCP Server installieren
docker run -i --rm hashicorp/terraform-mcp-serverLohnt sich Terraform MCP Server?
Der häufigste Fehler, wenn ein Modell Terraform schreibt, sind veraltete oder erfundene Ressourcenargumente. Aktuelle Registry-Abfragen über neun Tools wie search_providers und get_provider_details beheben vieles davon, und dieser Teil braucht weder Token noch HashiCorp-Konto.
Die Seite von HCP Terraform braucht mehr Überlegung, als das README andeutet. ENABLE_TF_OPERATIONS sperrt nur fünf destruktive Tools (action_run, delete_workspace_safely, force_unlock_workspace, delete_project und delete_team) sowie die Optionen auto_approve und is_destroy bei create_run. create_run selbst, update_workspace, das die Dokumentation als potenziell destruktiv bezeichnet, Schreibzugriffe auf Variablen und grant_team_access bleiben für jeden Agenten mit Token verfügbar. Das Flag --tools, das eine explizite Allowlist annimmt, ist die eigentliche Kontrolle; die Berechtigungen des Tokens selbst sind die zweite.
Welche Daten offenliegen, zeigt schon die Tool-Liste. get_plan_json_output, get_plan_logs und get_state_version können Ressourcenattribute und sensible Werte in den Kontext des Modells tragen, und das README von HashiCorp sagt, dass du den Server nicht mit nicht vertrauenswürdigen Clients oder Modellen nutzen sollst. Der HTTP-Modus ist vernünftig gehärtet: Clients können TFE_ADDRESS nicht überschreiben, was verhindert, dass eine Anfrage dein Token an einen anderen Host umleitet, Tokens in Query-Strings werden abgelehnt, und eine frühere Behandlung von X-Forwarded-For, die fälschbaren Werten vertraute, wurde durch eine explizite Einstellung für vertrauenswürdige Hops ersetzt.
Der Kontext ist der leisere Kostenfaktor. Ohne Flag --toolsets aktiviert der Server jedes Toolset, und sobald ein Token vorhanden ist, laden alle 61 Tool-Definitionen in jede Sitzung. Teams, die nur Dokumentation nachschlagen wollen, können --toolsets=default nutzen und die neun Registry-Tools behalten, was zugleich die sicherste Konfiguration ist, die HashiCorp anbietet.
Wo es sich lohnt
Ein Plattform-Engineer, der in Claude Code AWS-Module schreibt
Verhindern, dass der Agent Ressourcenargumente erfindet, die beim Plan scheitern
Den Container mit --toolsets=default starten; der Agent prüft Provider-Dokumentation und die neueste Provider-Version, bevor er HCL schreibt. Kein Token, kein Konto und neun Tool-Definitionen statt 61.
Eine SRE auf HCP Terraform
Erklären, warum der Run von letzter Nacht gescheitert ist, ohne die Konsole zu öffnen
Mit einem Token mit Leserechten und --tools beschränkt auf list_runs, get_run_details und get_plan_logs liest der Agent den Fehler und schlägt einen Fix vor. Die API von HCP Terraform erlaubt 30 Anfragen pro Sekunde und Nutzer, was eine Agent-Schleife selten erreicht.
Ein Plattformteam in einem Unternehmen mit 300 Engineers auf Terraform Enterprise
Einen gemeinsamen MCP-Endpunkt anbieten und dabei die Berechtigungen jedes Engineers wahren
Den HTTP-Modus aus dem Helm-Chart mit TLS, MCP_ALLOWED_ORIGINS und einer Allowlist für Organisationen deployen; jeder Nutzer schickt sein eigenes Token, sodass das RBAC von Terraform Enterprise weiter gilt, und OpenTelemetry-Metriken zeigen Volumen und Fehler der Tool-Aufrufe.
Bevor du dich festlegst
- Einrichtung
- claude mcp add terraform -s user -t stdio -- docker run -i --rm hashicorp/terraform-mcp-server, für HCP-Funktionen ergänzt um TFE_TOKEN und TFE_ADDRESS. HashiCorp dokumentiert VS Code, Cursor, Claude Desktop, Claude Code, Codex CLI, Amazon Q, Kiro, Gemini-Erweiterungen und IBM Bob.
- Integrationen
- 61 Tools: 9 für die öffentliche Registry, 4 für private Registries und 48 für HCP Terraform, die Projekte, Teams, Workspaces, Runs, Plans, Applies, State-Versionen, Policy-Sets, Variable-Sets, Tags und Stacks (nur lesend) abdecken. Toolsets oder einzelne Tools lassen sich per Flag aktivieren.
- Daten und Datenschutz
- Läuft lokal oder auf deinem eigenen Host; über HashiCorp läuft nichts außer den normalen Aufrufen der Registry- und HCP-API. Die Berechtigungen des Tokens begrenzen, was der Agent tun kann, und Plan- und State-Ausgaben können sensible Werte gegenüber dem Modell offenlegen.
- Kosten im großen Maßstab
- Der Server ist unter MPL-2.0 kostenlos; HCP Terraform oder Terraform Enterprise wird über deinen HashiCorp-Tarif abgerechnet, der hier nicht behandelt wird. Die HCP-API erlaubt 30 Anfragen pro Sekunde und Nutzer, unabhängig von der Zahl der Tokens, und der HTTP-Modus ergänzt eigene Voreinstellungen von 10 pro Sekunde global (Burst 20) und 5 pro Sitzung (Burst 10).
- Grenzen
- Die Referenz kennzeichnet Tools nicht als lesend oder schreibend; create_workspace und update_workspace gelten als destruktiv, sind aber nicht gesperrt; für jedes HTTP-Deployment außerhalb von localhost sind TLS-Zertifikate nötig.
Was gut ist
- Aktuelle Dokumentation zu Providern, Modulen und Policies ohne Token
- Feingranulare Allowlist über --tools
- Gehärteter HTTP-Modus mit Tokens pro Nutzer und Allowlist für Organisationen
- Die meisten destruktiven Operationen standardmäßig aus
Was nicht
- Runs, Workspace-Updates und Schreibzugriffe auf Variablen sind nicht gesperrt
- Plan- und State-Tools können Secrets in den Modellkontext bringen
- Mit Token laden standardmäßig 61 Tool-Definitionen
- Docker oder Go nötig; TLS-Inspektion im Unternehmen braucht ein CA-Mount
Am besten für
Teams, die Terraform mit KI-Hilfe schreiben, besonders auf HCP Terraform oder Terraform Enterprise, die eine Tool-Allowlist konfigurieren werden.
Alternativen zu Terraform MCP Server
Terraform MCP Server: häufige Fragen
- Lohnt sich Terraform MCP Server?
- Allein die Registry-Abfragen rechtfertigen die Installation; gib ihm ein HCP-Terraform-Token erst, wenn du entschieden hast, welche seiner 48 Workspace-Tools ein Agent haben soll. Wir bewerten es mit 4.2 von 5.
- Was kostet Terraform MCP Server?
- Kostenlos unter MPL-2.0. Die Funktionen von HCP Terraform hängen von deinem HashiCorp-Tarif ab.
- Welche Nachteile hat Terraform MCP Server?
- Runs, Workspace-Updates und Schreibzugriffe auf Variablen sind nicht gesperrt; Plan- und State-Tools können Secrets in den Modellkontext bringen; Mit Token laden standardmäßig 61 Tool-Definitionen; Docker oder Go nötig; TLS-Inspektion im Unternehmen braucht ein CA-Mount.
- Für wen eignet sich Terraform MCP Server?
- Teams, die Terraform mit KI-Hilfe schreiben, besonders auf HCP Terraform oder Terraform Enterprise, die eine Tool-Allowlist konfigurieren werden.
- Was kostet Terraform MCP Server für ein Team oder im Produktivbetrieb?
- Der Server ist unter MPL-2.0 kostenlos; HCP Terraform oder Terraform Enterprise wird über deinen HashiCorp-Tarif abgerechnet, der hier nicht behandelt wird. Die HCP-API erlaubt 30 Anfragen pro Sekunde und Nutzer, unabhängig von der Zahl der Tokens, und der HTTP-Modus ergänzt eigene Voreinstellungen von 10 pro Sekunde global (Burst 20) und 5 pro Sitzung (Burst 10).
- Ist Terraform MCP Server sicher für Firmendaten?
- Läuft lokal oder auf deinem eigenen Host; über HashiCorp läuft nichts außer den normalen Aufrufen der Registry- und HCP-API. Die Berechtigungen des Tokens begrenzen, was der Agent tun kann, und Plan- und State-Ausgaben können sensible Werte gegenüber dem Modell offenlegen.
- Was sind die besten Alternativen zu Terraform MCP Server?
- Die nächsten Alternativen, die wir getestet haben, sind AWS MCP Server und Azure MCP Server.
Antworten geprüft am 22. Okt. 2026.