Qu’est-ce que Terraform MCP Server ?
Le serveur MCP Terraform relie les agents au Terraform Registry public, pour qu'ils puissent rechercher la documentation actuelle des providers, les modules et les politiques en écrivant du code d'infrastructure. Avec un jeton HCP Terraform ou Terraform Enterprise, il gère aussi les organisations, projets, équipes, espaces de travail, variables, tags, exécutions et versions d'état. La référence de HashiCorp liste 61 outils : 9 pour le Registry public, 4 pour les registres privés et 48 pour HCP Terraform.
Il tourne généralement comme image Docker (docker run -i --rm hashicorp/terraform-mcp-server) sur stdio, ou comme binaire Go. Un mode Streamable HTTP sert les déploiements partagés, avec un chart Helm, TLS, des limites de débit, un CORS strict, une liste d'autorisation d'organisation et le passthrough de jeton par utilisateur. La dernière version est 1.3.0, du 26 août 2026, sous MPL-2.0.
Installer Terraform MCP Server
docker run -i --rm hashicorp/terraform-mcp-serverTerraform MCP Server vaut-il le coup ?
L'échec le plus courant quand un modèle écrit du Terraform est d'utiliser des arguments de ressources anciens ou inventés. Les recherches en direct dans le Registry via neuf outils comme search_providers et get_provider_details corrigent une grande partie de cela, et cette partie n'a besoin d'aucun jeton ni compte HashiCorp.
Le côté HCP Terraform a besoin de plus de réflexion que le README ne l'implique. ENABLE_TF_OPERATIONS ne barre que cinq outils destructeurs (action_run, delete_workspace_safely, force_unlock_workspace, delete_project et delete_team) plus les options auto_approve et is_destroy sur create_run. create_run lui-même, update_workspace, que la documentation qualifie de potentiellement destructeur, les écritures de variables et grant_team_access restent disponibles à tout agent détenant un jeton. Le flag --tools, qui prend une liste d'autorisation explicite, est le vrai contrôle ; les propres permissions du jeton sont le second.
L'exposition des données est évidente d'après la liste d'outils. get_plan_json_output, get_plan_logs et get_state_version peuvent porter des attributs de ressources et des valeurs sensibles dans le contexte du modèle, et le README de HashiCorp vous dit de ne pas utiliser le serveur avec des clients ou modèles non fiables. Le mode HTTP est durci sensément : les clients ne peuvent pas outrepasser TFE_ADDRESS, ce qui empêche une requête de rediriger votre jeton vers un autre hôte, les jetons dans les chaînes de requête sont rejetés, et une ancienne gestion de X-Forwarded-For qui faisait confiance à des valeurs usurpables a été remplacée par un réglage explicite de sauts de confiance.
Le contexte est le coût plus discret. Sans flag --toolsets, le serveur active chaque toolset, et une fois qu'un jeton est présent, les 61 définitions d'outils se chargent dans chaque session. Les équipes qui ne veulent que des recherches de documentation peuvent lancer --toolsets=default et garder les neuf outils du Registry, ce qui est aussi la configuration la plus sûre qu'HashiCorp offre.
Là où il fait la différence
Un ingénieur plateforme qui écrit des modules AWS dans Claude Code
Empêcher l'agent d'inventer des arguments de ressources qui échouent au moment du plan
Faites tourner le conteneur avec --toolsets=default ; l'agent vérifie la documentation des providers et la dernière version du provider avant d'écrire du HCL. Pas de jeton, pas de compte, et neuf définitions d'outils au lieu de 61.
Un SRE sur HCP Terraform
Expliquer pourquoi l'exécution de la nuit dernière a échoué sans ouvrir la console
Avec un jeton à portée de lecture et --tools limité à list_runs, get_run_details et get_plan_logs, l'agent lit l'échec et propose un correctif. L'API HCP Terraform autorise 30 requêtes par seconde par utilisateur, qu'une boucle d'agent atteint rarement.
Une équipe plateforme dans une entreprise de 300 ing énieurs sur Terraform Enterprise
Offrir un seul endpoint MCP partagé tout en gardant les permissions de chaque ingénieur
Déployez le mode HTTP depuis le chart Helm avec TLS, MCP_ALLOWED_ORIGINS et une liste d'autorisation d'organisation ; chaque utilisateur envoie son propre jeton, si bien que le RBAC de Terraform Enterprise s'applique encore, et les métriques OpenTelemetry montrent le volume d'appels d'outils et les erreurs.
Avant de vous engager
- Mise en route
- claude mcp add terraform -s user -t stdio -- docker run -i --rm hashicorp/terraform-mcp-server, en ajoutant TFE_TOKEN et TFE_ADDRESS pour les fonctions HCP. HashiCorp documente VS Code, Cursor, Claude Desktop, Claude Code, Codex CLI, Amazon Q, Kiro, les extensions Gemini et IBM Bob.
- Intégrations
- 61 outils : 9 du Registry public, 4 de registre privé et 48 outils HCP Terraform couvrant les projets, équipes, espaces de travail, exécutions, plans, applies, versions d'état, ensembles de politiques, ensembles de variables, tags et Stacks (lecture seule). Les toolsets ou outils individuels peuvent être activés par flag.
- Données et confidentialité
- Tourne localement ou sur votre propre hôte ; rien ne passe par HashiCorp au-delà des appels normaux au Registry et à l'API HCP. Les permissions du jeton bornent ce que l'agent peut faire, et la sortie de plan et d'état peut exposer des valeurs sensibles au modèle.
- Coût à grande échelle
- Le serveur est gratuit sous MPL-2.0 ; HCP Terraform ou Terraform Enterprise est facturé sous votre offre HashiCorp, non couverte ici. L'API d'HCP autorise 30 requêtes par seconde par utilisateur quel que soit le nombre de jetons, et le mode HTTP ajoute ses propres défauts de 10 par seconde globalement (burst 20) et 5 par session (burst 10).
- Limites
- La référence n'étiquette pas les outils comme lecture ou écriture ; create_workspace et update_workspace sont marqués destructeurs mais pas barrés ; les certificats TLS sont requis pour tout déploiement HTTP non-localhost.
Les points forts
- Documentation de providers, modules et politiques en direct sans jeton
- Liste d'autorisation --tools à portée fine
- Mode HTTP durci avec jetons par utilisateur et liste d'autorisation d'org
- La plupart des opérations destructrices désactivées par défaut
Les points faibles
- Les exécutions, mises à jour d'espaces de travail et écritures de variables ne sont pas barrées
- Les outils de plan et d'état peuvent mettre des secrets dans le contexte du modèle
- 61 définitions d'outils se chargent par défaut avec un jeton
- Docker ou Go nécessaires ; l'inspection TLS d'entreprise a besoin d'un montage de CA
Idéal pour
Les équipes qui écrivent du Terraform avec l'aide de l'IA, surtout celles sur HCP Terraform ou Terraform Enterprise qui configureront une liste d'autorisation d'outils.
Alternatives à Terraform MCP Server
Terraform MCP Server : questions fréquentes
- Terraform MCP Server vaut-il le coup ?
- Les recherches dans le Registry justifient à elles seules son installation ; ne lui remettez un jeton HCP Terraform qu'après avoir décidé lesquels de ses 48 outils d'espace de travail un agent devrait détenir. Nous lui donnons 4.2 sur 5.
- Combien coûte Terraform MCP Server ?
- Gratuit sous MPL-2.0. Les fonctions HCP Terraform dépendent de votre offre HashiCorp.
- Quels sont les inconvénients de Terraform MCP Server ?
- Les exécutions, mises à jour d'espaces de travail et écritures de variables ne sont pas barrées; les outils de plan et d'état peuvent mettre des secrets dans le contexte du modèle; 61 définitions d'outils se chargent par défaut avec un jeton; docker ou Go nécessaires ; l'inspection TLS d'entreprise a besoin d'un montage de CA.
- À qui s’adresse Terraform MCP Server ?
- Les équipes qui écrivent du Terraform avec l'aide de l'IA, surtout celles sur HCP Terraform ou Terraform Enterprise qui configureront une liste d'autorisation d'outils.
- Combien coûte Terraform MCP Server pour une équipe ou en production ?
- Le serveur est gratuit sous MPL-2.0 ; HCP Terraform ou Terraform Enterprise est facturé sous votre offre HashiCorp, non couverte ici. L'API d'HCP autorise 30 requêtes par seconde par utilisateur quel que soit le nombre de jetons, et le mode HTTP ajoute ses propres défauts de 10 par seconde globalement (burst 20) et 5 par session (burst 10).
- Terraform MCP Server est-il sûr pour les données de l’entreprise ?
- Tourne localement ou sur votre propre hôte ; rien ne passe par HashiCorp au-delà des appels normaux au Registry et à l'API HCP. Les permissions du jeton bornent ce que l'agent peut faire, et la sortie de plan et d'état peut exposer des valeurs sensibles au modèle.
- Quelles sont les meilleures alternatives à Terraform MCP Server ?
- Les alternatives les plus proches que nous avons testées sont AWS MCP Server et Azure MCP Server.
Réponses vérifiées le 22 oct. 2026.