Servidor MCP do OpenTofu: o que é e como usar
Aprofundamento CEVIU
Aprofundamento
O servidor MCP do OpenTofu é um projeto oficial da organização OpenTofu que implementa o Model Context Protocol sobre o registry. Ele expõe sete ferramentas de consulta: search-opentofu-registry, get-provider-details, get-provider-versions, get-module-details, get-module-versions, get-resource-docs e get-datasource-docs. O objetivo é simples: o assistente de IA busca a documentação atual em vez de gerar HCL de memória, com argumentos que o provider já removeu.
O desenho é somente leitura. Segundo a Spacelift, o servidor não roda init, plan, apply nem destroy, não lê nem escreve state, não toca o filesystem, não lida com credenciais e só consulta o registry público (nada de registries privados). Quem lê e escreve a configuração é o assistente. Há duas formas de uso: o endpoint hospedado, que é o caminho recomendado pelo time do OpenTofu, ou a execução local com npx. Para pinagem de versão, get-provider-versions e get-module-versions devolvem as versões publicadas com a data de cada release.
A fonte compara com o servidor MCP da HashiCorp para Terraform, que consulta o registry da HashiCorp (incluindo políticas Sentinel) e também interage com HCP Terraform e Terraform Enterprise, criando workspaces e runs. Já projetos de terceiros, como o cloud-pilot-mcp, expõem operações de CLI, e aí a própria Spacelift defende controles fortes, porque agentes autônomos agem na velocidade da máquina.
Por que isso importa
Para quem opera pipelines com OpenTofu, o ganho prático está na revisão de código gerado por IA: menos plan quebrado por atributo depreciado ou versão inexistente. Como o servidor só devolve texto de documentação, o risco fica na configuração do agente e nas outras ferramentas que ele usa, não no MCP em si. Isso é uma leitura editorial: o raio de ação pequeno facilita liberar o servidor para o time, mas a governança de quem executa apply continua sendo o ponto crítico.
Perguntas frequentes
O servidor MCP do OpenTofu executa comandos tofu?
Não. Ele nunca invoca o binário tofu, então não roda init, plan, apply nem destroy. Também não lê o state nem acessa credenciais. Ele só consulta a documentação do registry público.
Como instalar o servidor MCP do OpenTofu?
Você pode apontar o cliente MCP para o endpoint hospedado, que é o caminho recomendado pelo time do OpenTofu. A alternativa é rodar localmente com npx @opentofu/opentofu-mcp-server. Também dá para instalar globalmente via npm.
Qual a diferença para o servidor MCP do Terraform?
O do Terraform consulta o registry da HashiCorp, inclusive políticas Sentinel. Ele também fala com HCP Terraform e Terraform Enterprise, criando workspaces e runs. O do OpenTofu consulta o registry do OpenTofu e é somente leitura.
Ele funciona com módulos e providers privados?
Não. Segundo a fonte, o servidor consulta apenas o registry público do OpenTofu. Registries privados ficam fora do alcance.
Fontes
- spacelift.iofonte original
- Categoria
- CEVIU DevOps
- Publicado
- 06 de novembro de 2026
- Editoria
- CEVIU DevOps

