Terraform - Документация и рабочие области Terraform

Когда звать

• Когда агент подбирает провайдер или модуль Terraform и должен свериться с первоисточником.
• Когда требуется отделить поиск в Registry от операций с рабочими пространствами и запусками HCP Terraform.

Terraform Registry и рабочие области

Terraform MCP Server выпускает HashiCorp в репозитории hashicorp/terraform-mcp-server. Он обращается к публичному Terraform Registry и API HCP Terraform либо Terraform Enterprise. Первая задача - получить документацию провайдера, модуля или политики. Вторая - работать с объектами аккаунта, включая рабочие области, переменные и запуски. Эти направления требуют разного уровня доверия.

Поиск документации удобен перед правкой конфигурации: агент может сначала найти описание аргумента и сопоставить его с нужным провайдером. Пример из реестра нельзя сразу считать подходящим для вашего окружения. Версия провайдера, существующие ресурсы и состояние проекта должны проверяться отдельно от ответа справочного инструмента.

Минимальное подключение

README описывает stdio по умолчанию и Streamable HTTP с точкой /mcp. Локальный запуск возможен через бинарный файл или контейнер. Для Claude Code и Codex автор приводит отдельные примеры подключения. Здесь они служат источником формы конфигурации: устанавливать сервер или выполнять команды мы не пробовали.

Для первого знакомства оставьте только группу registry, которая указана как группа по умолчанию. Публичная документация не требует выдавать агенту токен вашей организации. Для HCP Terraform и Terraform Enterprise используются TFE_TOKEN и серверный адрес TFE_ADDRESS. В HTTP-режиме клиент не может подменять этот адрес через заголовок или параметры URL: README связывает запрет с защитой токена от отправки чужому серверу.

Через --toolsets выбирают группы, а через --tools - отдельные инструменты. В этой реализации два флага нельзя использовать вместе. Не переносите на неё правила другого MCP, где списки могут складываться. Расширенные операции дополнительно управляются ENABLE_TF_OPERATIONS, но это не причина оставлять широкие права токена.

Проверка только по справочнику

Первый запрос: «Найди документацию выбранного провайдера и описание указанного ресурса. Покажи обязательные аргументы, ссылку и найденную версию. Не подключай рабочие области, не создавай запуски и не выполняй изменения инфраструктуры». В результате должны быть конкретные материалы реестра, а не ответ по общим знаниям о Terraform.

Для рабочего аккаунта дайте отдельный токен с минимальной областью. Сервер умеет создавать, изменять и удалять рабочие области, поэтому название «сервер документации» не описывает весь его потенциал. При центральном HTTP-размещении нужны TLS, ограничения источников запросов и разрешённых организаций. Токен не передают в параметрах URL.

Код MCP распространяется по MPL-2.0. Это отдельное условие от лицензии Terraform CLI, провайдеров и материалов модулей, а также от правил HCP Terraform. По состоянию на 23 октября 2026 года проверены README и LICENSE в полном коммите. Сборку, установку и вызовы сервера мы не выполняли.