Terraform — MCP-сервер для Claude Code: реестр и HCP Terraform
Подключает ИИ-ассистента к Terraform Registry и HCP Terraform: поиск провайдеров и модулей, работа с воркспейсами.
claude mcp add terraform -- docker run -i --rm docker.io/hashicorp/terraform-mcp-server:1.4.1Что делает Terraform
Сервер связывает ассистента с публичным Terraform Registry и API HCP Terraform и Terraform Enterprise. Из чата можно искать провайдеров, модули и политики, а также управлять воркспейсами: создавать, менять, удалять, задавать переменные и теги, запускать runs. Есть доступ к приватному реестру организации.
Запускается в контейнере, поэтому Docker должен быть установлен и запущен. Транспорт по умолчанию — stdio, есть режим streamable-http с настраиваемыми хостом, портом и путём /mcp. В HTTP-режиме адрес HCP Terraform задаётся только переменной TFE_ADDRESS, клиент не может передать его заголовком. Для приватного реестра и воркспейсов нужен токен TFE_TOKEN.
В streamable-http-режиме доступны метрики OpenTelemetry: объём вызовов инструментов, задержки и ошибки. В README отдельно предупреждают: в зависимости от запроса сервер может отдать данные Terraform клиенту и модели, поэтому с недоверенными клиентами его использовать не стоит.
Какие задачи решает
- найти актуальную версию провайдера в реестре
- собрать модуль из готовых блоков вместо ручного поиска
- создать воркспейс с переменными и тегами
- запустить run и посмотреть его статус
- вытащить политики из приватного реестра организации
Примеры запросов агенту
- Найди в Terraform Registry провайдер для AWS и покажи последнюю версию
- Создай воркспейс
stagingв организации и добавь переменнуюregion - Какие модули в реестре подходят для VPC в GCP?
Как установить Terraform
Командой платформы
claude mcp add terraform -- docker run -i --rm docker.io/hashicorp/terraform-mcp-server:1.4.1Командой платформы
codex mcp add terraform -- docker run -i --rm docker.io/hashicorp/terraform-mcp-server:1.4.1Файл настроек
{
"mcpServers": {
"terraform": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/hashicorp/terraform-mcp-server:1.4.1"
]
}
}
}Файл настроек
{
"servers": {
"terraform": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/hashicorp/terraform-mcp-server:1.4.1"
]
}
}
}Командой платформы
gemini mcp add terraform docker run -i --rm docker.io/hashicorp/terraform-mcp-server:1.4.1По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Terraform
Как установить Terraform MCP-сервер в Claude Code?
Одной командой: claude mcp add terraform -- docker run -i --rm docker.io/hashicorp/terraform-mcp-server:1.4.1. Docker должен быть установлен и запущен.
Что делает Terraform MCP-сервер?
Даёт ассистенту доступ к Terraform Registry и API HCP Terraform: поиск провайдеров, модулей и политик, управление воркспейсами, переменными, тегами и запусками.
Что нужно для работы с HCP Terraform и приватным реестром?
Токен в переменной TFE_TOKEN. Адрес задаётся через TFE_ADDRESS с протоколом, например https://app.terraform.io.
