Vault Radar MCP 서버 배포

Vault Radar MCP 서버 배포

로컬 워크스테이션의 Docker 컨테이너에 Vault Radar MCP(Model Context Protocol) 서버를 배포해요. Vault Radar MCP 서버는 클라이언트에 연결되어 LLM이 HCP Vault Radar 인스턴스의 데이터를 사용해 질문에 답할 수 있게 해줘요. Vault Radar MCP 서버에 대한 추가 정보는 overview를 참고하세요.

출처: 문서

본문

개요

Vault Radar MCP 서버를 배포하려면 다음 단계를 완료하세요.

  • Docker 이미지 가져오기
  • 클라이언트를 MCP 서버에 연결하기
  • 클라이언트 구성하기

사전 요구 사항

  • Docker Engine v20.10.21+ 또는 Docker Desktop v4.14.0+

인증

MCP 서버는 HCP Vault Radar API에 접근하려면 인증이 필요해요. HCP 프로젝트에 viewer 역할이 있는 서비스 주체를 만들고 서비스 주체 키를 생성하세요.

클라이언트에서 MCP 활성화

클라이언트에서 MCP를 활성화하는 방법은 클라이언트의 문서를 참고하세요.

서버 설치

Vault Radar MCP 서버는 Docker 이미지로 제공돼요. Docker Hub 저장소에서 이미지를 가져올 수 있어요. 또는 바이너리를 다운로드해서 서버를 수동으로 실행할 수 있어요.

로컬 워크스페이스의 .vscode 또는 .cursor 디렉터리에 mcp.json 파일을 만들고 다음 구성을 추가하세요.

{
    "mcp": {
        "servers": {
            "vault-radar": {
                "command": "docker",
                "args": [
                    "run",
                    "--rm",
                    "-i",
                    "-e", "HCP_PROJECT_ID=<HCP Project ID>",
                    "-e", "HCP_CLIENT_ID=<HCP Service Principal Client ID>",
                    "-e", "HCP_CLIENT_SECRET=<HCP Service Principal Client Secret>",
                    "hashicorp/vault-radar-mcp-server:<tag>",
                ]
            }
        }
    }
}

사용자 설정을 업데이트하고 settings.json 파일에 다음 구성을 추가하면 모든 워크스페이스에 대해 MCP 서버를 구성할 수 있어요.

{
    "mcp": {
        "servers": {
            "vault-radar": {
                "command": "docker",
                "args": [
                    "run",
                    "--rm",
                    "-i",
                    "-e", "HCP_PROJECT_ID=<HCP Project ID>",
                    "-e", "HCP_CLIENT_ID=<HCP Service Principal Client ID>",
                    "-e", "HCP_CLIENT_SECRET=<HCP Service Principal Client Secret>",
                    "hashicorp/vault-radar-mcp-server:<tag>",
                ]
            }
        }
    }
}

자세한 내용은 VS Code MCP 서버 문서를 참고하세요.

mcp.json 파일을 만들고 다음 구성을 추가하세요.

{
    "mcpServers": {
        "vault-radar": {
            "command": "docker",
            "args": [
                    "run",
                    "--rm",
                    "-i",
                    "-e", "HCP_PROJECT_ID=<HCP Project ID>",
                    "-e", "HCP_CLIENT_ID=<HCP Service Principal Client ID>",
                    "-e", "HCP_CLIENT_SECRET=<HCP Service Principal Client Secret>",
                    "hashicorp/vault-radar-mcp-server:<tag>",
            ]
        }
    }
}

자세한 내용은 Claude Desktop Users 문서를 참고하세요.

MCP 클라이언트 구성

  • 채팅 인터페이스를 열고 모드 설정에서 Agent를 선택하세요.

  • 도구 아이콘을 클릭해 Vault Radar MCP 서버 도구가 활성화되어 있는지 확인하세요.

  • 채팅 창을 열고 줄임표 메뉴에서 Chat Settings를 선택하세요.

  • Default new chat mode 드롭다운 메뉴에서 Agent를 선택하세요.

  • Cursor Settings 사이드바에서 MCP를 선택해 Vault Radar MCP 서버 도구가 활성화되어 있는지 확인하세요.

  • 채팅 창을 열고 채팅 창 왼쪽 아래의 검색 및 도구 슬라이더 아이콘을 선택하세요.

  • vault-radar-mcp-server를 클릭해 모든 도구가 활성화되어 있는지 확인하세요.

다음 단계

Vault Radar MCP 서버를 다운로드하고 클라이언트에 연결한 후, Vault Radar 구성 코드에 대해 모델에 프롬프트하기 시작할 수 있어요.

AI 모델에 프롬프트하는 방법에 대한 자세한 내용은 documentation을 참고하세요.

더 알아보기 (Learn more)