**이 페이지 개선에 도움 주기** 

이 사용자 가이드에 기여하려면 모든 페이지의 오른쪽 창에 있는 **GitHub에서 이 페이지 편집** 링크를 선택합니다.

# Amazon EKS MCP 서버 구성 참조
<a name="eks-mcp-tool-configurations"></a>

이 가이드에서는 IDE에서 완전관리형 Amazon EKS MCP 서버에 연결할 수 있는 [https://github.com/aws/mcp-proxy-for-aws](https://github.com/aws/mcp-proxy-for-aws) 클라이언트 측 도구에 사용할 수 있는 모든 구성을 보여줍니다.

**참고**  
Amazon EKS MCP 서버는 Amazon EKS의 미리 보기 릴리스로 제공되며 변경될 수 있습니다.

## 예제
<a name="_example"></a>

```
{
  "mcpServers": {
    "eks-mcp": {
      "disabled": false,
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://eks-mcp.us-west-2.api.aws/mcp",
        "--service",
        "eks-mcp",
        "--profile",
        "default",
        "--region",
        "us-east-1",
        "--read-only"
      ]
    }
  }
}
```

## IAM 권한
<a name="_iam_permissions"></a>

MCP 서버에 연결하는 데 사용되는 역할에는 사용 가능한 도구에 대한 정보를 초기화하고 검색할 수 있는 **`eks-mcp:InvokeMcp`** 권한이 필요합니다. **`eks-mcp:CallReadOnlyTool`**은 읽기 전용 도구를 사용하는 데 필요하며, **`eks-mcp:CallPrivilegedTool`**은 전체 액세스(쓰기) 도구를 사용하는 데 필요합니다.

## 환경 변수
<a name="_environment_variables"></a>

 **`AWS_PROFILE`**(선택 사항): 사용할 AWS 자격 증명 프로파일 이름으로, `--profile` 명령줄 인수로 재정의할 수 있습니다.
+ 예시: `export AWS_PROFILE=production` 

 **`AWS_REGION`**(선택 사항): SigV4 서명을 위한 AWS 리전으로, 설정하지 않은 경우 기본값은 `us-west-2`입니다.
+ 예시: `export AWS_REGION=us-east-1` 

## 인수
<a name="_arguments"></a>

 **SigV4 MCP 엔드포인트 URL**(필수): 연결할 MCP 엔드포인트 URL.
+ 예시: `https://eks-mcp.us-west-2.api.aws/mcp` 

 **`--service`**(선택 사항): SigV4 서명을 위한 AWS 서비스 이름으로, 제공하지 않은 경우 엔드포인트 호스트 이름에서 자동으로 감지됩니다.
+ 예시: `--service eks-mcp` 

 **`--profile`**(선택 사항): 사용할 AWS 자격 증명 프로파일. 지정되지 않은 경우 기본값은 `AWS_PROFILE` 환경 변수입니다.
+ 예시: `--profile production` 

 사용할 **`--region`** AWS 리전. 설정되지 않은 경우 `AWS_REGION` 환경 변수를 사용하며 기본값은 `us-east-1`입니다.
+ 예시: `--region us-west-2` 

 **`--read-only`**(선택 사항): 쓰기 권한이 필요할 수 있는 도구를 비활성화합니다(쓰기 권한이 필요하지 않은 도구는 readOnlyHint=true로 주석이 달림). 모든 도구는 기본적으로 활성화되어 있습니다.
+ 예시: `--read-only` 

자세한 구성 옵션은 [Configuration parameters](https://github.com/aws/mcp-proxy-for-aws?tab=readme-ov-file#configuration-parameters)를 참조하세요.

## 도구
<a name="_tools"></a>

파라미터 및 사용 예제를 포함하여 사용 가능한 모든 도구에 대한 자세한 내용은 [Amazon EKS MCP 서버 도구 참조](eks-mcp-tools.md) 섹션을 참조하세요.