Terraform MCP Server의 개요
Terraform MCP Server는 에이전트를 공개 Terraform Registry에 연결해, 인프라 코드를 쓰는 동안 최신 프로바이더 문서, 모듈, 정책을 찾아볼 수 있게 합니다. HCP Terraform이나 Terraform Enterprise 토큰이 있으면 조직, 프로젝트, 팀, 워크스페이스, 변수, 태그, 실행(run), 상태 버전도 관리합니다. HashiCorp의 레퍼런스에는 도구 61개가 있습니다. 공개 Registry용 9개, 비공개 레지스트리용 4개, HCP Terraform용 48개입니다.
보통은 Docker 이미지(docker run -i --rm hashicorp/terraform-mcp-server)로 stdio를 통해 실행하거나 Go 바이너리로 실행합니다. Streamable HTTP 모드는 공유 배포용이며, Helm 차트, TLS, 요청 한도, 엄격한 CORS, 조직 허용 목록, 사용자별 토큰 전달을 갖췄습니다. 최신 릴리스는 2026년 8월 26일의 1.3.0이고, 라이선스는 MPL-2.0입니다.
Terraform MCP Server 설치 방법
docker run -i --rm hashicorp/terraform-mcp-serverTerraform MCP Server, 쓸 만한 가치가 있습니까?
모델이 Terraform을 쓸 때 가장 흔한 실패는 오래됐거나 지어낸 리소스 인수를 쓰는 것입니다. search_providers와 get_provider_details 같은 도구 아홉 개를 통한 실시간 Registry 조회가 그 상당 부분을 바로잡으며, 이 부분에는 토큰도 HashiCorp 계정도 필요 없습니다.
HCP Terraform 쪽은 README가 암시하는 것보다 더 많은 고민이 필요합니다. ENABLE_TF_OPERATIONS가 막는 것은 파괴적인 도구 다섯 개(action_run, delete_workspace_safely, force_unlock_workspace, delete_project, delete_team)와 create_run의 auto_approve 및 is_destroy 옵션뿐입니다. create_run 자체, 문서가 잠재적으로 파괴적이라고 부르는 update_workspace, 변수 쓰기, grant_team_access는 토큰을 가진 어떤 에이전트에게나 열려 있습니다. 명시적인 허용 목록을 받는 --tools 플래그가 진짜 통제 수단이고, 토큰 자체의 권한이 두 번째 수단입니다.
데이터 노출은 도구 목록에서 분명히 보입니다. get_plan_json_output, get_plan_logs, get_state_version은 리소스 속성과 민감한 값을 모델의 컨텍스트로 가져올 수 있으며, HashiCorp의 README는 신뢰할 수 없는 클라이언트나 모델과 함께 이 서버를 쓰지 말라고 말합니다. HTTP 모드는 합리적으로 강화되어 있습니다. 클라이언트는 TFE_ADDRESS를 덮어쓸 수 없어 요청이 토큰을 다른 호스트로 돌리지 못하고, 쿼리 문자열에 담긴 토큰은 거부되며, 위조 가능한 값을 믿던 예전의 X-Forwarded-For 처리는 명시적인 신뢰 홉(trusted-hops) 설정으로 바뀌었습니다.
컨텍스트는 더 조용한 비용입니다. --toolsets 플래그가 없으면 서버는 모든 도구 묶음을 켜고, 토큰이 있으면 세션마다 도구 정의 61개가 모두 로드됩니다. 문서 조회만 원하는 팀은 --toolsets=default로 실행해 Registry 도구 아홉 개만 둘 수 있으며, 이것이 HashiCorp가 제공하는 가장 안전한 구성이기도 합니다.
제 역할을 하는 곳
Claude Code에서 AWS 모듈을 쓰는 플랫폼 엔지니어
에이전트가 plan 단계에서 실패하는 리소스 인수를 지어내지 못하게 하기
--toolsets=default로 컨테이너를 실행하면, 에이전트가 HCL을 쓰기 전에 프로바이더 문서와 최신 프로바이더 버전을 확인합니다. 토큰도 계정도 필요 없고, 도구 정의는 61개가 아니라 9개입니다.
HCP Terraform을 쓰는 SRE
콘솔을 열지 않고 어젯밤 실행이 왜 실패했는지 설명하기
읽기 범위로 제한한 토큰과 list_runs, get_run_details, get_plan_logs로 제한한 --tools를 쓰면, 에이전트가 실패 내용을 읽고 수정안을 제시합니다. HCP Terraform API는 사용자당 초당 30회 요청을 허용하며, 에이전트 루프가 여기에 도달하는 일은 드뭅니다.
Terraform Enterprise를 쓰는 엔지니어 300명 규모 회사의 플랫폼 팀
엔지니어 각자의 권한을 유지하면서 공유 MCP 엔드포인트 하나를 제공하기
TLS, MCP_ALLOWED_ORIGINS, 조직 허용 목록을 설정해 Helm 차트로 HTTP 모드를 배포합니다. 사용자마다 자기 토큰을 보내므로 Terraform Enterprise RBAC가 그대로 적용되고, OpenTelemetry 지표로 도구 호출량과 오류를 볼 수 있습니다.
도입 전 확인할 점
- 설정
- claude mcp add terraform -s user -t stdio -- docker run -i --rm hashicorp/terraform-mcp-server를 실행하고, HCP 기능을 쓰려면 TFE_TOKEN과 TFE_ADDRESS를 추가합니다. HashiCorp는 VS Code, Cursor, Claude Desktop, Claude Code, Codex CLI, Amazon Q, Kiro, Gemini 확장, IBM Bob용 문서를 제공합니다.
- 연동
- 도구는 61개입니다. 공개 Registry용 9개, 비공개 레지스트리용 4개, 그리고 프로젝트, 팀, 워크스페이스, 실행, plan, apply, 상태 버전, 정책 세트, 변수 세트, 태그, Stacks(읽기 전용)를 다루는 HCP Terraform용 48개입니다. 도구 묶음이나 개별 도구를 플래그로 켤 수 있습니다.
- 데이터와 개인정보
- 로컬이나 자체 호스트에서 실행됩니다. 일반적인 Registry와 HCP API 호출 외에는 HashiCorp를 거치는 것이 없습니다. 에이전트가 할 수 있는 일은 토큰의 권한으로 제한되며, plan과 state 출력은 민감한 값을 모델에 노출할 수 있습니다.
- 대규모 사용 시 비용
- 서버는 MPL-2.0으로 무료입니다. HCP Terraform이나 Terraform Enterprise는 HashiCorp 플랜에 따라 청구되며 여기서는 다루지 않습니다. HCP API는 토큰 수와 상관없이 사용자당 초당 30회 요청을 허용하고, HTTP 모드에는 자체 기본 한도로 전체 초당 10회(버스트 20)와 세션당 초당 5회(버스트 10)가 더해집니다.
- 제한
- 레퍼런스는 도구를 읽기용과 쓰기용으로 구분해 표시하지 않습니 다. create_workspace와 update_workspace는 파괴적이라고 표시되어 있지만 막혀 있지 않습니다. localhost가 아닌 HTTP 배포에는 TLS 인증서가 필요합니다.
좋은 점
- 토큰 없이 최신 프로바이더, 모듈, 정책 문서를 봅니다
- 세밀한 --tools 허용 목록이 있습니다
- 사용자별 토큰과 조직 허용 목록을 갖춘 강화된 HTTP 모드가 있습니다
- 대부분의 파괴적 작업은 기본으로 꺼져 있습니다
아쉬운 점
- 실행, 워크스페이스 수정, 변수 쓰기는 막혀 있지 않습니다
- plan과 state 도구가 비밀 값을 모델 컨텍스트에 넣을 수 있습니다
- 토큰이 있으면 기본으로 도구 정의 61개가 로드됩니다
- Docker나 Go가 필요하고, 사내 TLS 검사 환경에서는 CA 마운트가 필요합니다
추천 대상
AI의 도움을 받아 Terraform을 쓰는 팀, 특히 도구 허 용 목록을 설정할 HCP Terraform이나 Terraform Enterprise 사용 팀입니다.
Terraform MCP Server 대안
Terraform MCP Server: 자주 묻는 질문
- Terraform MCP Server, 쓸 만한 가치가 있습니까?
- Registry 조회만으로도 설치할 가치가 있습니다. HCP Terraform 토큰은 워크스페이스 도구 48개 중 무엇을 에이전트에 줄지 정한 다음에 넘기십시오. 평점은 5점 만점에 4.2점입니다.
- Terraform MCP Server의 가격은 얼마입니까?
- MPL-2.0 라이선스로 무료입니다. HCP Terraform 기능은 사용 중인 HashiCorp 플랜에 따라 다릅니다.
- Terraform MCP Server의 단점은 무엇입니까?
- 실행, 워크스페이스 수정, 변수 쓰기는 막혀 있지 않습니다; plan과 state 도구가 비밀 값을 모델 컨텍스트에 넣을 수 있습니다; 토큰이 있으면 기본으로 도구 정의 61개가 로드됩니다; Docker나 Go가 필요하고, 사내 TLS 검사 환경에서는 CA 마운트가 필요합니다.
- Terraform MCP Server에 적합한 사람은 누구입니까?
- AI의 도움을 받아 Terraform을 쓰는 팀, 특히 도구 허용 목록을 설정할 HCP Terraform이나 Terraform Enterprise 사용 팀입니다.
- 팀이나 프로덕션 환경에서 Terraform MCP Server의 비용은 얼마입니까?
- 서버는 MPL-2.0으로 무료입니다. HCP Terraform이나 Terraform Enterprise는 HashiCorp 플랜에 따라 청구되며 여기서는 다루지 않습니다. HCP API는 토큰 수와 상관없이 사용자당 초당 30회 요청을 허용하고, HTTP 모드에는 자체 기본 한도로 전체 초당 10회(버스트 20)와 세션당 초당 5회(버스트 10)가 더해집니다.
- Terraform MCP Server 에 회사 데이터를 맡겨도 안전합니까?
- 로컬이나 자체 호스트에서 실행됩니다. 일반적인 Registry와 HCP API 호출 외에는 HashiCorp를 거치는 것이 없습니다. 에이전트가 할 수 있는 일은 토큰의 권한으로 제한되며, plan과 state 출력은 민감한 값을 모델에 노출할 수 있습니다.
- Terraform MCP Server의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 AWS MCP Server 및 Azure MCP Server입니다.
답변 확인일: 2026년 10월 22일.
Terraform MCP Server 개발사입니까? 이 평점을 사이트에 표시하십시오
