¿Qué es Terraform MCP Server?
El Terraform MCP Server conecta los agentes con el Terraform Registry público, para que puedan consultar la documentación actual de proveedores, módulos y políticas mientras escriben código de infraestructura. Con un token de HCP Terraform o Terraform Enterprise también gestiona organizaciones, proyectos, equipos, workspaces, variables, etiquetas, ejecuciones y versiones de estado. La referencia de HashiCorp enumera 61 herramientas: 9 para el Registry público, 4 para registros privados y 48 para HCP Terraform.
Suele ejecutarse como imagen de Docker (docker run -i --rm hashicorp/terraform-mcp-server) por stdio, o como binario de Go. Un modo Streamable HTTP sirve para despliegues compartidos, con un chart de Helm, TLS, límites de peticiones, CORS estricto, una lista de organizaciones permitidas y paso del token de cada usuario. La última versión es la 1.3.0, del 26 de agosto de 2026, con licencia MPL-2.0.
Cómo instalar Terraform MCP Server
docker run -i --rm hashicorp/terraform-mcp-server¿Merece la pena Terraform MCP Server?
El fallo más habitual cuando un modelo escribe Terraform es usar argumentos de recursos antiguos o inventados. Las consultas en directo al Registry mediante nueve herramientas como search_providers y get_provider_details resuelven buena parte de eso, y esta parte no necesita token ni cuenta de HashiCorp.
La parte de HCP Terraform requiere más reflexión de la que da a entender el README. ENABLE_TF_OPERATIONS solo controla cinco herramientas destructivas (action_run, delete_workspace_safely, force_unlock_workspace, delete_project y delete_team) más las opciones auto_approve e is_destroy de create_run. El propio create_run, update_workspace, que la documentación califica de potencialmente destructiva, las escrituras de variables y grant_team_access siguen disponibles para cualquier agente que tenga un token. El flag --tools, que acepta una lista explícita de herramientas permitidas, es el control real; los permisos del propio token son el segundo.
La exposición de datos se ve claramente en la lista de herramientas. get_plan_json_output, get_plan_logs y get_state_version pueden llevar atributos de recursos y valores sensibles al contexto del modelo, y el README de HashiCorp pide que no se use el servidor con clientes o modelos no fiables. El modo HTTP está reforzado con sensatez: los clientes no pueden sobrescribir TFE_ADDRESS, lo que impide que una petición redirija tu token a otro host, se rechazan los tokens en query strings, y un tratamiento anterior de X-Forwarded-For que confiaba en valores falsificables se ha sustituido por un ajuste explícito de saltos de confianza.
El contexto es el coste más discreto. Sin un flag --toolsets, el servidor activa todos los conjuntos de herramientas, y en cuanto hay un token se cargan las 61 definiciones de herramientas en cada sesión. Los equipos que solo quieren consultar documentación pueden ejecutar --toolsets=default y quedarse con las nueve herramientas del Registry, que es además la configuración más segura que ofrece HashiCorp.
Dónde se gana su sitio
Una ingeniera de plataforma que escribe módulos de AWS en Claude Code
Evitar que el agente invente argumentos de recursos que fallan al hacer el plan
Ejecuta el contenedor con --toolsets=default; el agente consulta la documentación del proveedor y su última versión antes de escribir HCL. Sin token, sin cuenta y con nueve definiciones de herramientas en lugar de 61.
Un SRE con HCP Terraform
Explicar por qué falló la ejecución de anoche sin abrir la consola
Con un token de solo lectura y --tools limitado a list_runs, get_run_details y get_plan_logs, el agente lee el fallo y propone una corrección. La API de HCP Terraform permite 30 peticiones por segundo por usuario, algo que un bucle de agente rara vez alcanza.
Un equipo de plataforma en una empresa de 300 ingenieros con Terraform Enterprise
Ofrecer un único endpoint MCP compartido manteniendo los permisos de cada ingeniero
Despliega el modo HTTP desde el chart de Helm con TLS, MCP_ALLOWED_ORIGINS y una lista de organizaciones permitidas; cada usuario envía su propio token, así que el RBAC de Terraform Enterprise sigue aplicándose, y las métricas de OpenTelemetry muestran el volumen de llamadas a herramientas y los errores.
Antes de decidirte
- Puesta en marcha
- claude mcp add terraform -s user -t stdio -- docker run -i --rm hashicorp/terraform-mcp-server, añadiendo TFE_TOKEN y TFE_ADDRESS para las funciones de HCP. HashiCorp documenta VS Code, Cursor, Claude Desktop, Claude Code, Codex CLI, Amazon Q, Kiro, las extensiones de Gemini e IBM Bob.
- Integraciones
- 61 herramientas: 9 del Registry público, 4 de registros privados y 48 de HCP Terraform que cubren proyectos, equipos, workspaces, ejecuciones, planes, applies, versiones de estado, conjuntos de políticas, conjuntos de variables, etiquetas y Stacks (solo lectura). Los conjuntos de herramientas o las herramientas sueltas se activan con flags.
- Datos y privacidad
- Se ejecuta en local o en tu propio host; nada pasa por HashiCorp aparte de las llamadas normales al Registry y a la API de HCP. Los permisos del token delimitan lo que puede hacer el agente, y la salida de planes y estados puede exponer valores sensibles al modelo.
- Coste a escala
- El servidor es gratuito con licencia MPL-2.0; HCP Terraform o Terraform Enterprise se facturan según tu plan de HashiCorp, que no se trata aquí. La API de HCP permite 30 peticiones por segundo por usuario sea cual sea el número de tokens, y el modo HTTP añade sus propios valores por defecto de 10 por segundo en global (ráfaga de 20) y 5 por sesión (ráfaga de 10).
- Límites
- La referencia no marca las herramientas como de lectura o escritura; create_workspace y update_workspace se señalan como destructivas pero no están controladas; hacen falta certificados TLS para cualquier despliegue HTTP que no sea en localhost.
Lo bueno
- Documentación en directo de proveedores, módulos y políticas sin token
- Lista detallada de herramientas permitidas con --tools
- Modo HTTP reforzado con tokens por usuario y lista de organizaciones permitidas
- La mayoría de las operaciones destructivas, desactivadas por defecto
Lo malo
- Las ejecuciones, las actualizaciones de workspaces y las escrituras de variables no están controladas
- Las herramientas de plan y de estado pueden poner secretos en el contexto del modelo
- Con un token se cargan por defecto 61 definiciones de herramientas
- Necesita Docker o Go; la inspección TLS corporativa requiere montar una CA
Ideal para
Equipos que escriben Terraform con ayuda de IA, sobre todo los que usan HCP Terraform o Terraform Enterprise y van a configurar una lista de herramientas permitidas.
Alternativas a Terraform MCP Server
Terraform MCP Server: preguntas frecuentes
- ¿Merece la pena Terraform MCP Server?
- Solo las consultas al Registry ya justifican instalarlo; dale un token de HCP Terraform únicamente después de decidir cuáles de sus 48 herramientas de workspaces debe tener un agente. Le damos un 4.2 sobre 5.
- ¿Cuánto cuesta Terraform MCP Server?
- Gratuito con licencia MPL-2.0. Las funciones de HCP Terraform dependen de tu plan de HashiCorp.
- ¿Qué inconvenientes tiene Terraform MCP Server?
- Las ejecuciones, las actualizaciones de workspaces y las escrituras de variables no están controladas; las herramientas de plan y de estado pueden poner secretos en el contexto del modelo; con un token se cargan por defecto 61 definiciones de herramientas; necesita Docker o Go; la inspección TLS corporativa requiere montar una CA.
- ¿Para quién es Terraform MCP Server?
- Equipos que escriben Terraform con ayuda de IA, sobre todo los que usan HCP Terraform o Terraform Enterprise y van a configurar una lista de herramientas permitidas.
- ¿Cuánto cuesta Terraform MCP Server para un equipo o en producción?
- El servidor es gratuito con licencia MPL-2.0; HCP Terraform o Terraform Enterprise se facturan según tu plan de HashiCorp, que no se trata aquí. La API de HCP permite 30 peticiones por segundo por usuario sea cual sea el número de tokens, y el modo HTTP añade sus propios valores por defecto de 10 por segundo en global (ráfaga de 20) y 5 por sesión (ráfaga de 10).
- ¿Es Terraform MCP Server seguro para los datos de la empresa?
- Se ejecuta en local o en tu propio host; nada pasa por HashiCorp aparte de las llamadas normales al Registry y a la API de HCP. Los permisos del token delimitan lo que puede hacer el agente, y la salida de planes y estados puede exponer valores sensibles al modelo.
- ¿Cuáles son las mejores alternativas a Terraform MCP Server?
- Las alternativas más cercanas que hemos analizado son AWS MCP Server y Azure MCP Server.
Respuestas comprobadas el 22 oct 2026.