O que é Terraform MCP Server?
O Terraform MCP Server conecta agentes ao Terraform Registry público, para que consultem a documentação atual de providers, módulos e políticas enquanto escrevem código de infraestrutura. Com um token do HCP Terraform ou do Terraform Enterprise, ele também gerencia organizações, projetos, equipes, workspaces, variáveis, tags, runs e state versions. A referência da HashiCorp lista 61 ferramentas: 9 para o Registry público, 4 para registries privados e 48 para o HCP Terraform.
Normalmente ele roda como imagem Docker (docker run -i --rm hashicorp/terraform-mcp-server) via stdio, ou como binário Go. Um modo Streamable HTTP atende implantações compartilhadas, com Helm chart, TLS, limites de taxa, CORS estrito, uma lista de organizações permitidas e repasse de token por usuário. A versão mais recente é a 1.3.0, de 26 de agosto de 2026, sob MPL-2.0.
Como instalar Terraform MCP Server
docker run -i --rm hashicorp/terraform-mcp-serverTerraform MCP Server vale a pena?
A falha mais comum quando um modelo escreve Terraform é usar argumentos de recursos antigos ou inventados. As consultas ao vivo ao Registry por nove ferramentas, como search_providers e get_provider_details, resolvem boa parte disso, e essa parte não exige token nem conta HashiCorp.
O lado do HCP Terraform exige mais reflexão do que o README dá a entender. ENABLE_TF_OPERATIONS controla só cinco ferramentas destrutivas (action_run, delete_workspace_safely, force_unlock_workspace, delete_project e delete_team), mais as opções auto_approve e is_destroy de create_run. O próprio create_run, update_workspace, que a documentação chama de potencialmente destrutivo, as escritas de variáveis e grant_team_access continuam disponíveis para qualquer agente que tenha um token. A flag --tools, que recebe uma lista explícita de ferramentas permitidas, é o controle real; as próprias permissões do token são o segundo.
A exposição de dados fica clara na lista de ferramentas. get_plan_json_output, get_plan_logs e get_state_version podem levar atributos de recursos e valores sensíveis para o contexto do modelo, e o README da HashiCorp diz para não usar o servidor com clientes ou modelos não confiáveis. O modo HTTP é reforçado de forma sensata: os clientes não podem sobrescrever TFE_ADDRESS, o que impede que uma requisição redirecione seu token para outro host, tokens em query strings são rejeitados, e um tratamento anterior de X-Forwarded-For que confiava em valores falsificáveis foi substituído por uma configuração explícita de trusted hops.
O contexto é o custo mais silencioso. Sem a flag --toolsets, o servidor ativa todos os toolsets e, quando há um token, todas as 61 definições de ferramentas são carregadas em cada sessão. Equipes que só querem consultas à documentação podem rodar --toolsets=default e manter as nove ferramentas do Registry, que é também a configuração mais segura que a HashiCorp oferece.
Onde ele se destaca
Um engenheiro de plataforma escrevendo módulos AWS no Claude Code
Impedir que o agente invente argumentos de recursos que falham na hora do plan
Rode o contêiner com --toolsets=default; o agente consulta a documentação do provider e a versão mais recente do provider antes de escrever HCL. Sem token, sem conta, e nove definições de ferramentas em vez de 61.
Um SRE no HCP Terraform
Explicar por que o run da noite passada falhou sem abrir o console
Com um token de leitura e --tools limitado a list_runs, get_run_details e get_plan_logs, o agente lê a falha e propõe uma correção. A API do HCP Terraform permite 30 requisições por segundo por usuário, o que um loop de agente raramente alcança.
Uma equipe de plataforma em uma empresa de 300 engenheiros no Terraform Enterprise
Oferecer um endpoint MCP compartilhado mantendo as permissões de cada engenheiro
Implante o modo HTTP pelo Helm chart com TLS, MCP_ALLOWED_ORIGINS e uma lista de organizações permitidas; cada usuário envia o próprio token, então o RBAC do Terraform Enterprise continua valendo, e métricas OpenTelemetry mostram o volume de chamadas de ferramentas e os erros.
Antes de decidir
- Configuração
- claude mcp add terraform -s user -t stdio -- docker run -i --rm hashicorp/terraform-mcp-server, acrescentando TFE_TOKEN e TFE_ADDRESS para os recursos do HCP. A HashiCorp documenta VS Code, Cursor, Claude Desktop, Claude Code, Codex CLI, Amazon Q, Kiro, extensões do Gemini e IBM Bob.
- Integrações
- 61 ferramentas: 9 do Registry público, 4 de registry privado e 48 do HCP Terraform, cobrindo projetos, equipes, workspaces, runs, plans, applies, state versions, policy sets, variable sets, tags e Stacks (somente leitura). Toolsets ou ferramentas individuais podem ser ativados por flag.
- Dados e privacidade
- Roda localmente ou no seu próprio host; nada passa pela HashiCorp além das chamadas normais às APIs do Registry e do HCP. As permissões do token limitam o que o agente pode fazer, e a saída de plan e state pode expor valores sensíveis ao modelo.
- Custo em escala
- O servidor é gratuito sob MPL-2.0; o HCP Terraform ou o Terraform Enterprise é cobrado no seu plano HashiCorp, não coberto aqui. A API do HCP permite 30 requisições por segundo por usuário, seja qual for o número de tokens, e o modo HTTP acrescenta seus próprios padrões de 10 por segundo no total (burst 20) e 5 por sessão (burst 10).
- Limites
- A referência não marca as ferramentas como de leitura ou escrita; create_workspace e update_workspace são sinalizados como destrutivos, mas não são controlados; certificados TLS são obrigatórios em qualquer implantação HTTP fora do localhost.
O que é bom
- Documentação ao vivo de providers, módulos e políticas sem token
- Lista de permissões --tools granular
- Modo HTTP reforçado, com tokens por usuário e lista de organizações permitidas
- A maioria das operações destrutivas desativada por padrão
O que não é
- Runs, atualizações de workspace e escritas de variáveis não são controladas
- Ferramentas de plan e state podem colocar segredos no contexto do modelo
- 61 definições de ferramentas carregadas por padrão com um token
- Exige Docker ou Go; inspeção TLS corporativa exige montar uma CA
Ideal para
Equipes que escrevem Terraform com ajuda de IA, especialmente as que estão no HCP Terraform ou no Terraform Enterprise e vão configurar uma lista de ferramentas permitidas.
Alternativas ao Terraform MCP Server
Terraform MCP Server: perguntas frequentes
- Terraform MCP Server vale a pena?
- As consultas ao Registry já justificam a instalação; entregue a ele um token do HCP Terraform só depois de decidir quais das 48 ferramentas de workspace um agente deve ter. Damos nota 4.2 de 5.
- Quanto custa Terraform MCP Server?
- Gratuito sob MPL-2.0. Os recursos do HCP Terraform dependem do seu plano HashiCorp.
- Quais são as desvantagens de Terraform MCP Server?
- Runs, atualizações de workspace e escritas de variáveis não são controladas; ferramentas de plan e state podem colocar segredos no contexto do modelo; 61 definições de ferramentas carregadas por padrão com um token; exige Docker ou Go; inspeção TLS corporativa exige montar uma CA.
- Para quem Terraform MCP Server é indicado?
- Equipes que escrevem Terraform com ajuda de IA, especialmente as que estão no HCP Terraform ou no Terraform Enterprise e vão configurar uma lista de ferramentas permitidas.
- Quanto custa Terraform MCP Server para uma equipe ou em produção?
- O servidor é gratuito sob MPL-2.0; o HCP Terraform ou o Terraform Enterprise é cobrado no seu plano HashiCorp, não coberto aqui. A API do HCP permite 30 requisições por segundo por usuário, seja qual for o número de tokens, e o modo HTTP acrescenta seus próprios padrões de 10 por segundo no total (burst 20) e 5 por sessão (burst 10).
- Terraform MCP Server é seguro para dados da empresa?
- Roda localmente ou no seu próprio host; nada passa pela HashiCorp além das chamadas normais às APIs do Registry e do HCP. As permissões do token limitam o que o agente pode fazer, e a saída de plan e state pode expor valores sensíveis ao modelo.
- Quais são as melhores alternativas ao Terraform MCP Server?
- As alternativas mais próximas que analisamos são AWS MCP Server e Azure MCP Server.
Respostas verificadas em 22 de out. de 2026.