1장. MCP 서버


1.1. Red Hat OpenShift의 MCP 서버로 클러스터 검사

OpenShift Container Platform 클러스터에서 문제가 발생하면 가능한 한 빨리 문제를 해결할 수 있도록 상황을 정확하게 파악해야 합니다. Red Hat OpenShift 기능의 MCP 서버는 OpenShift Container Platform 클러스터를 빠르고 쉽게 진단할 수 있는 AI 툴을 제공합니다.

1.1.1. AI 보안

Red Hat OpenShift용 MCP 서버는 AI 에이전트에게 클러스터 리소스에 대한 액세스 권한을 부여하므로 안전 관행을 따라 무단 작업, 데이터 노출 및 프롬프트 인젝션 위험으로부터 클러스터를 보호해야 합니다.

중요

이 기능은 AI 기술을 사용합니다. 입력에 개인 정보 또는 기타 민감한 정보를 포함하지 마십시오. 상호 작용은 Red Hat의 제품 또는 서비스를 개선하는 데 사용될 수 있습니다. 사용하기 전에 AI가 생성한 콘텐츠를 항상 검토하십시오.

1.1.1.1. 데이터 소유권

Red Hat OpenShift용 MCP 서버는 클러스터의 정보 또는 상태를 저장하지 않습니다. 옵트인 경우 Red Hat OpenShift에 대한 MCP 서버의 전체 사용 수준을 이해하기 위해 수집된 여러 원격 분석 지표가 있습니다.

  • Cluster:k8s_mcp_tool_calls:sum:
  • 클러스터 전체에서 모든 MCP(Model Context Protocol) 툴 호출의 총 수
  • Cluster:k8s_mcp_tool_errors:sum:
  • 클러스터에서 실패한 모든 MCP 툴 호출의 총 수
  • Cluster:k8s_mcp_http_requests:sum:
  • MCP 서버에서 수신한 모든 HTTP 요청의 총 수

이러한 메트릭은 호출, 요청 또는 오류 자체에 대한 특정 세부 정보를 수집하지 않으며 사용량에 대한 집계 전체 합계만 제공합니다.

옵트인하려면 TOML 구성을 편집합니다.

[telemetry]
enabled = true

옵트아웃하려면 TOML 구성을 편집합니다.

[telemetry]
enabled = false

1.1.1.2. 필수 확인 워크플로우: HITL(Human in the loop) 시행

  • MCP 클라이언트에서 AI 에이전트의 제안된 작업을 평가하는 것이 좋습니다.
  • 제안된 리소스 버전을 수동으로 확인해야 합니다(예: 모델이 더 이상 사용되지 않는 API를 제안하지 않는지 확인).
  • "쓰기" 작업을 위해 AI 클라이언트 인터페이스에서 인적 승인 메커니즘을 사용하는 것이 좋습니다.

1.1.1.3. 데이터 개인 정보 보호 및 마스킹

Red Hat OpenShift의 MCP 서버에는 PII 및 데이터 마스킹에 대한 내부 메커니즘이 없습니다. 허용된 CR(사용자 정의 리소스) 내에서 클러스터 정보가 데이터 개인 정보 보호 표준을 준수하도록 하려면 TrustyAI를 배포하여 발신 페이로드를 모니터링하고 정제합니다. 특정 CR에 대한 MCP 액세스 범위를 지정하고 제한하는 방법은 "사용자 정의 리소스에 대한 액세스 취소"를 참조하십시오.

1.1.1.4. 감사 추적 권장 사항

Red Hat OpenShift의 MCP 서버는 감사 로그에 user-agent 문자열을 추가하여 MCP 서버를 통해 AI 에이전트가 요청한 것을 확인하도록 구성되어 있습니다. OAuth 또는 MCP 게이트웨이를 통해 권한 부여가 활성화되었는지 확인합니다. 자세한 내용은 "Red Hat OpenShift용 MCP 서버 설치"를 참조하십시오.

1.1.1.5. 타사 MCP 서버 관련 권장 사항

보안 및 제어 향상을 위해 타사 MCP 호스트는 Red Hat OpenShift용 MCP 서버를 통해 수행되는 "쓰기" 작업을 승인해야 하는 HITL 요구 사항을 구현하는 것이 좋습니다.

1.1.1.6. AI 거버넌스 및 가드레일

MCP 게이트웨이는 중앙 집중식 제어 지점 역할을 하며 중앙 집중식 인증 및 ID 관리를 통해 에이전트 툴 상호 작용에 대해 엄격한 거버넌스를 적용하여 에이전트가 지정된 작업에 필요한 특정 권한만 갖도록 올바르게 범위가 지정된 토큰 및 OAuth 2.0을 사용합니다. MCP 게이트웨이는 tools/list 검색 프로세스에서 무단 툴을 완전히 제거하는 ID 기반 툴 필터링을 사용하여 환경을 추가로 보호하므로 에이전트가 금지된 기능에 액세스하려고 시도하는 것을 방지합니다.

AI 관련 위험을 완화하려면 게이트웨이를 안전 가드레일과 함께 배포해야 합니다. 가드레일에는 Trusty AI 또는 NVIDIA Nemo와 같은 외부 엔진과 통합하여 프롬프트 인젝션 및 안전 위반에 대한 트래픽 페이로드 검사가 포함됩니다. 또한 MCP 게이트웨이는 에이전트 주도 서비스 거부 공격을 방지하는 속도 제한을 구현하고 모든 툴 사용량을 추적 및 분석하는 포괄적인 감사 로깅을 제공하여 운영 안정성과 책임을 보장합니다.

1.1.1.7. MCP 게이트웨이를 사용하여 액세스 집계 및 제어

MCP 게이트웨이를 사용하여 MCP 서버에 대한 인증 및 권한 부여 관리를 포함하여 MCP 서버에 대한 액세스를 집계하고 제어하는 것이 좋습니다. 이는 MCP 툴 사용량의 관찰 기능 및 거버넌스도 제공합니다. 또한 MCP 게이트웨이에는 PII의 요청 및 응답 트래픽, MCP 서버에 도달하기 전에 신속하게 주입 및 안전하지 않은 콘텐츠를 표시하는 Trusty AI 및 NeMo guardrails와의 통합도 포함되어 있습니다.

1.1.1.8. AI 에이전트 액세스 긴급 제거

긴급 상황에서는 다음 작업 중 하나를 사용하여 MCP 서버를 통해 AI 에이전트에 대한 액세스를 취소할 수 있습니다.

구성 변경 사항을 적용하는 방법에 대한 자세한 내용은 "Red Hat OpenShift용 MCP 서버에 구성 변경 사항 적용"을 참조하십시오.

  • config.toml에서 문제를 일으키는 툴에 대한 액세스를 제거합니다.

    특정 툴만 활성화합니다.

    enabled_tools = ["pods_list", "pods_get", "pods_log"]
  • 활성화된 툴셋에서 특정 툴을 비활성화합니다.

    config.toml 에서 파괴적인 툴 호출을 비활성화합니다.

    disabled_tools = ["resources_delete", "pods_delete"].
  • 프로덕션에서 안전한 구성을 생성합니다.

    read_only = true
  • 쓰기를 허용하지만 삭제를 방지합니다.

    disable_destructive = true
  • 다음 명령을 실행하여 MCP 서버를 완전히 제거합니다.

    $ oc delete mcpserver --all --all-namespaces
  • RBAC 취소:

    사용자의 rolebinding 또는 clusterrolebinding을 제거합니다. 자세한 내용은 "Red Hat OpenShift용 MCP 서버 설치"를 참조하십시오.

  • MCP 게이트웨이를 통해 액세스 제거

    게이트웨이를 통한 액세스를 제거하려면 다음 명령을 실행하여 MCPServerRegistration CR을 삭제할 수 있습니다.

    $ oc delete mcpsr <name of registration>

1.1.2. Model Context Protocol 개요

MCP(Model Context Protocol)는 AI 애플리케이션이 사용자 지정 통합 없이 외부 데이터 소스, 툴 및 워크플로우에 안전하게 연결할 수 있는 오픈 소스 표준입니다.

MCP는 AI 애플리케이션을 외부 시스템에 연결하기 위한 오픈 소스 표준입니다.

MCP를 사용하여 Claude Code 또는 Cursor와 같은 AI 애플리케이션은 다음 항목에 연결하여 키 정보에 액세스하고 작업을 수행할 수 있습니다.

  • 데이터 소스: 예를 들어 로컬 파일, 데이터베이스
  • 툴: 예를 들어 검색 엔진, 계산기
  • 워크플로우: 예를 들어 특수 프롬프트

MCP는 AI 애플리케이션을 위한 USB-C 포트와 유사하게 작동합니다. USB-C가 전자 장치를 연결하는 표준화된 방법을 제공하는 것과 마찬가지로 MCP는 AI 애플리케이션을 외부 시스템에 연결하는 표준화된 방법을 제공합니다.

1.1.3. MCP 서버 개요

MCP(Model Context Protocol) 서버는 체계적이고 안전한 방식으로 클러스터 데이터와 작업을 AI 모델에 노출하여 AI 에이전트가 API 또는 데이터베이스에 직접 액세스할 필요 없이 클러스터에서 진단하고 조치를 취할 수 있습니다.

1.1.3.1. MCP 서버의 목표

MCP 서버의 주요 목표는 체계적이고 안전하며 예측 가능한 방식으로 AI 모델에 특정 기능을 노출하는 것입니다. MCP 서버가 수행하는 주요 목표는 다음과 같습니다.

  • 기능 노출: 서버는 AI가 수행하거나 볼 수 있도록 허용된 항목을 정확하게 정의합니다. 서버는 세 가지 특정 항목을 노출하여 이를 수행합니다.

    • 툴: 작업을 수행하는 실행 가능한 함수(예: "이 파일을 삭제", "Slack에 게시" 또는 "모기지 계산").
    • 리소스: 컨텍스트를 제공하는 읽기 전용 데이터 소스(예: "README.md의 콘텐츠 읽기" 또는 "최근 1시간의 로그 가져오기").
    • 프롬프트: AI 모델의 동작을 안내하는 사전 정의된 템플릿(예: AI가 특정 언어의 버그를 찾는 방법을 정확하게 알려주는 "코드 검토자" 프롬프트)입니다.
  • 복잡성의 추상화: MCP 서버가 통합의 복잡한 부분을 숨깁니다. LLM은 SQL 쿼리를 작성하거나 특정 GitHub API를 사용하는 방법을 알 필요가 없습니다. 서버는 코드, 포맷 및 기술적 고유 복잡성을 처리하여 LLM에 깔끔하고 표준화된 결과를 제공합니다.
  • 실행 및 동작: AI[agent 또는 client]가 툴을 사용하기로 결정하면 MCP 서버가 특정 툴을 사용하여 실행됩니다. 예를 들어 Python 스크립트를 실행하거나, 데이터베이스를 쿼리하거나, 외부 API를 호출합니다.
  • 안전 및 보안: 서버가 격리 계층을 제공합니다. 별도의 프로세스로 실행하면 특정 폴더 또는 특정 API 엔드포인트에만 액세스하도록 제한할 수 있습니다. AI 모델이 원하지 않거나 의도하지 않은 작업을 시도하는 경우, 예를 들어 전체 하드 드라이브를 삭제하려고 하면 서버는 내부 규칙에 따라 동작을 거부할 수 있습니다.

1.1.4. MCP 게이트웨이 개요

MCP(Model Context Protocol) 게이트웨이의 주요 목표는 AI 모델이 외부 데이터 및 툴과 상호 작용하는 방식을 표준화하고 단순화하는 것입니다. 게이트웨이가 없으면 AI 모델은 액세스해야 하는 모든 개별 데이터베이스, API 또는 로컬 파일 시스템마다 사용자 지정 통합이 필요합니다.

1.1.4.1. 집계 및 오케스트레이션

게이트웨이는 여러 MCP 서버에 동시에 연결됩니다. LLM(Large Language Model)이 10개의 서로 다른 연결을 관리하는 대신 게이트웨이와만 통신합니다. 그런 다음 게이트웨이는 LLM의 요청을 관련 정보를 보유하는 특정 서버로 라우팅합니다(예: 한 서버에서 Jira 티켓을 가져오고 다른 서버에서 Google 드라이브 문서를 가져오는 경우).

1.1.4.2. 보안 및 액세스 제어

게이트웨이는 보안 경계 역할을 합니다.

이는 다음을 관리합니다.

  • 인증: 다양한 서버에 필요한 API 키 또는 토큰을 보관합니다.
  • 권한: AI 모델이 사용자가 승인한 특정 데이터 또는 툴에만 액세스하도록 보장합니다.
  • 개인 정보 보호: 모델 공급자에게 다시 전송되기 전에 민감한 정보를 제거합니다.

1.1.4.3. 프로토콜 변환

게이트웨이를 사용하면 AI 모델과 서버 간의 통신이 MCP 표준을 따르도록 합니다. AI 모델의 상위 수준 "의도"를 MCP 서버에서 이해할 수 있는 특정 JSON-RPC 호출로 변환합니다.

1.1.4.4. 확장성

AI 모델을 데이터 소스에서 분리하면 AI 애플리케이션의 코어 구성을 변경하지 않고도 MCP 서버를 추가, 제거 또는 업데이트할 수 있습니다.

1.1.5. Red Hat OpenShift용 MCP 서버 프롬프트 워크플로우

MCP(Model Context Protocol) 프롬프트 워크플로우를 이해하면 문제를 보다 효과적으로 해결하고 MCP 서버, 게이트웨이 및 Large Language Model(LLM)을 통해 프롬프트가 클러스터 리소스에 도달하는 방법을 최적화할 수 있습니다.

LLM에 프롬프트를 입력하면 다음 단계에 따라 실행이 수행됩니다.

  1. 사용자가 프롬프트를 입력합니다. "계속 다시 시작되는 Pod가 있습니까?".
  2. MCP 호스트(예: Claude Desktop): 프롬프트를 수신합니다. 연결된 MCP 서버를 보고 pods_list라는 툴이 있는지 확인합니다.
  3. MCP 게이트웨이(사용되는 경우): 엔터프라이즈 환경에 있는 경우 호스트는 게이트웨이와 먼저 통신합니다. 게이트웨이는 "이 사용자가 클러스터에 액세스할 수 있습니까?"와 "클러스터가 현재 온라인 상태입니까?"를 확인합니다.
  4. MCP 서버: 게이트웨이(또는 호스트)는 명령을 서버로 보냅니다. 서버는 실제 코드(OpenShift에 대한 API 호출)를 실행하고 데이터를 가져와서 다시 보냅니다.
  5. LLM: 해당 원시 데이터를 가져와서 "reads"하고 최종 요약을 제공합니다.

1.1.6. Red Hat OpenShift용 MCP 서버 설치

AI 에이전트가 클러스터를 안전하게 진단하고 검사할 수 있도록 Red Hat OpenShift용 MCP 서버를 설치하고 구성합니다.

Red Hat OpenShift용 MCP 서버 기능을 설치하려면 다음 절차를 완료합니다.

사전 요구 사항

  • admin 권한으로 OpenShift 콘솔에 액세스할 수 있습니다.
  • Claude Code, Visual Studio Code(VS Code), Cursor 또는 OpenShift LightSpeed(OLS)와 같은 설치된 MCP 호환 클라이언트입니다.

    Gemma 4는 연결이 끊긴 환경에서도 사용할 수 있습니다.

    참고

    클라우드 전용 결과는 연결이 끊긴 배포에는 적용되지 않습니다.

  • Red Hat OpenShift AI v3.5가 OpenShift Container Platform v4.22 클러스터에 설치되어 있습니다.

절차

  1. MCP 게이트웨이를 설치합니다.
  2. MCP Lifecycle Operator를 활성화합니다.
  3. MCP 카탈로그에서 MCP 서버를 배포합니다.
  4. MCP 게이트웨이 배포를 확인합니다.
  5. MCP 게이트웨이를 구성합니다.
  6. Claude Code와 같은 MCP(Model Context Protocol) 호환 클라이언트를 MCP 서버에 연결합니다.
  7. RBAC 적용을 구성합니다.
  8. 사용자 정의 리소스에 대한 액세스를 취소합니다.
  9. MCP 게이트웨이 인증을 설정합니다.
  10. MCP 게이트웨이 권한 부여를 설정합니다.

1.1.6.1. MCP 게이트웨이 설치

MCP(Model Context Protocol) 게이트웨이를 설치하여 모든 MCP 서버 트래픽에 대해 인증, 권한 부여 및 속도 제한을 적용하는 안전하고 중앙 집중식 진입점을 제공합니다.

절차

  1. MCP 게이트웨이를 설치합니다.

    MCP 게이트웨이를 설치하는 방법에 대한 자세한 내용은 "MCP 게이트웨이 설치(Red Hat Connectivity Link)"를 참조하십시오.

    설치 후 컨트롤러는 게이트웨이 액세스를 위해 HTTPRoute를 자동으로 생성합니다. MCP 게이트웨이는 여러 MCP 서버를 단일 엔드포인트에 집계하고 인증 및 속도 제한을 위한 계층을 제공하는 역방향 프록시 역할을 합니다.

1.1.6.2. MCP Lifecycle Operator 활성화

Red Hat OpenShift 기능의 MCP 서버를 설치하려면 MCP Lifecycle Operator를 사용하여 MCP(Model Context Protocol) 서버를 설치합니다.

중요

MCP Lifecycle Operator는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

사전 요구 사항

  • MCP 게이트웨이가 설치되어 있습니다.
  • admin 권한으로 OpenShift 콘솔에 액세스할 수 있습니다.

절차

  • MCP Lifecycle Operator를 사용하여 설치하는 방법에 대한 자세한 내용은 " MCP 서버 라이프사이클 관리 활성화(Red Hat OpenShift AI 문서)"를 참조하십시오.

    중요

    MCP Lifecycle Operator를 설치하려면 소프트웨어의 초기 릴리스 버전인 Red Hat OpenShift AI v3.6.0-ae2를 설치해야 합니다.

    Red Hat OpenShift AI v3.6.0-ae2는 소프트웨어 카탈로그 AI/Machine Learning Red Hat OpenShift AI 의 콘솔에서 사용할 수 있습니다. Channel 에서 beta 를 선택하고 버전 에서 3.6.0-ae.2 를 선택합니다.

1.1.6.3. MCP 카탈로그에서 MCP 서버 배포

Red Hat OpenShift AI의 MCP(Model Context Protocol) 카탈로그에서 Red Hat OpenShift용 MCP 서버를 배포합니다. MCP 카탈로그는 MCP Lifecycle Operator가 조정하여 배포, 서비스 및 네트워크 정책을 자동으로 구성하는 MCP 서버 CR(사용자 정의 리소스)을 생성합니다.

사전 요구 사항

  • MCP 게이트웨이가 설치되어 있습니다.
  • MCP 라이프사이클 Operator가 활성화되어 있습니다.

절차

  • MCP 카탈로그에서 MCP 서버를 배포하는 방법에 대한 자세한 내용은 "MCP 카탈로그에서 MCP 서버 배포(Red Hat OpenShift AI 문서)를 참조하십시오.

1.1.6.4. MCP 게이트웨이 배포 확인

라우팅, 인증 및 권한 부여를 구성하기 전에 MCP(Model Context Protocol) 게이트웨이가 올바르게 배포되고 실행되고 있는지 확인합니다.

사전 요구 사항

  • OpenShift Container Platform 콘솔에 액세스하고 관리자 권한이 있습니다.
  • OpenShift CLI(oc)가 설치되어 있어야 합니다.
  • MCP 게이트웨이가 설치되어 있습니다.
  • MCP 라이프사이클 Operator가 활성화되어 있습니다.
  • MCP 서버가 설치되어 있어야 합니다.

절차

  1. 다음 명령을 실행하여 배포 상태를 확인합니다.

    $ oc get pods -n gateway-namespace -l "app.kubernetes.io/name=mcp-gateway"
    참고

    이 예에서는 게이트웨이 설치에 네임스페이스 "gateway-namespace"를 사용합니다. "gateway-namespace"가 아닌 다른 네임스페이스에 게이트웨이를 설치하는 경우 프로시저 전체에서 해당 네임스페이스를 사용합니다.

    예

    NAME                                      READY   STATUS    RESTARTS   AGE
    mcp-gateway-controller-594b9649cf-zstfw   1/1     Running   0          22s

  2. 다음 명령을 실행하여 MCP 게이트웨이 확장이 있는지 확인합니다.

    $ oc get mcpgatewayextension -A

    예

    NAMESPACE          NAME          READY   AGE
    gateway-namespace  mcp-gateway           105s

  3. 다음 명령을 실행하여 broker-router 배포를 확인합니다.

    $ oc logs -n gateway-namespace deployment/mcp-gateway
  4. 다음 명령을 실행하여 EnvoyFilter가 게이트웨이 네임스페이스에 생성되었는지 확인합니다.

    $ oc get envoyfilter -n gateway-namespace -l app.kubernetes.io/managed-by=mcp-gateway-controller

1.1.6.5. MCP 게이트웨이 구성

클라이언트 트래픽을 MCP 서버로 라우팅하고 서버가 노출하는 툴을 검색할 수 있도록 MCP(Model Context Protocol) 게이트웨이를 구성합니다.

사전 요구 사항

  • admin 권한으로 OpenShift 콘솔에 액세스할 수 있습니다.
  • MCP 게이트웨이가 설치되어 있습니다.
  • MCP 라이프사이클 Operator가 활성화되어 있습니다.
  • MCP 서버가 설치되어 있어야 합니다.
  • MCP 게이트웨이 배포가 확인되었습니다.

절차

  1. HTTPRoute 를 생성하기 전에 다음 명령을 입력하여 MCP 서버 서비스의 정확한 이름을 확인합니다.

    $ oc get svc -n openshift-mcp-server

    다음 매니페스트의 backendRefs.name 필드가 서비스의 NAME 출력과 일치하는지 확인합니다. 예: openshift-mcp-server.

  2. 다음 명령을 실행하여 MCP 서버의 HTTPRoute를 생성합니다.

    $ oc apply -f - <<EOF
    apiVersion: gateway.networking.k8s.io/v1
    kind: HTTPRoute
    metadata:
      name: mcp-api-key-server-route
      namespace: openshift-mcp-server
    spec:
      parentRefs:
      - group: gateway.networking.k8s.io
        kind: Gateway
        name: mcp-gateway
        namespace: gateway-namespace
        sectionName: mcp
      hostnames:
      - ${MCP_SERVER_HOST}
      rules:
      - matches:
        - path:
            type: PathPrefix
            value: /mcp
        backendRefs:
        - name: openshift-mcp-server
          port: 8080
    EOF

    ${MCP_SERVER_HOST} 는 MCP 게이트웨이 경로의 호스트 이름입니다(예: mcp-gateway.apps.<cluster-name>.<domain-name>).

    이 HTTPRoute를 사용하면 MCP 게이트웨이가 MCP 서버 인스턴스로 트래픽을 라우팅하고 MCPServerRegistration 리소스에서 참조됩니다.

  3. 다음 명령을 실행하여 MCP 서버 등록 리소스를 생성합니다.

    $ oc apply -f - <<EOF
    apiVersion: mcp.kuadrant.io/v1alpha1
    kind: MCPServerRegistration
    metadata:
      name: my-mcp-server-reg
      namespace: openshift-mcp-server
    spec:
      prefix: "openshift_"
      targetRef:
        group: "gateway.networking.k8s.io"
        kind: "HTTPRoute"
        name: "mcp-api-key-server-route"
        namespace: openshift-mcp-server
    EOF
    • metadata.name: MCP 서버 등록 오브젝트의 이름을 제공합니다.
    • metadata.namespace: MCP 서버의 네임스페이스로, openshift-mcp-server입니다.
    • spec.targetRef.name: MCP 서버 HTTPRoute의 이름입니다. oc get httproute -n openshift-mcp-server 명령을 실행하여 이를 확인할 수 있습니다.
    • spec.targetRef.namespace: MCP 서버 HTTPRoute의 네임스페이스로, openshift-mcp-server입니다.
  4. 다음 명령을 실행하여 등록 상태를 확인합니다.

    $ oc wait --for=condition=Ready mcpsr/my-mcp-server-reg -n openshift-mcp-server --timeout=120s
    $ oc get mcpsr -A

    출력 예

    NAMESPACE             NAME                PREFIX      TARGET                     PATH   READY   TOOLS   CREDENTIALS   AGE
    openshift-mcp-server  my-mcp-server-reg   myserver_   mcp-api-key-server-route   /mcp   True    4                     30s

    READY 열에 True가 표시되고 TOOLS 열에는 검색된 툴 수가 표시되어야 합니다.

    상태가 준비되지 않은 경우 다음 명령을 실행하여 MCP 서버 등록 조건을 확인합니다.

    $ oc describe mcpsr my-mcp-server-reg -n openshift-mcp-server
  5. 다음 명령을 실행하여 컨트롤러 로그를 확인합니다.

    $ oc logs -n gateway-namespace deployment/mcp-gateway-controller
  6. 다음 명령을 실행하여 툴 검색에 대한 브로커 로그를 확인합니다.

    $ oc logs -n gateway-namespace deployment/mcp-gateway
  7. MCP 게이트웨이를 통해 MCP 서버 툴을 사용할 수 있는지 확인합니다.

    1. MCP 세션을 초기화하고 -D를 사용하여 헤더를 파일로 덤프한 후 다음 명령을 실행하여 세션 ID를 읽어 캡처합니다.

      $ curl -s -D /tmp/mcp_headers -X POST http://mcp-gateway.apps.<cluster-name>.<domain-name>:8001/mcp  \
        -H "Content-Type: application/json" \
        -d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "test-client", "version": "1.0.0"}}}'

      <cluster-name>.<domain-name>은 클러스터의 이름과 도메인입니다.

    2. 다음 명령을 실행하여 응답 헤더에서 MCP 세션 ID를 추출합니다.

      $ SESSION_ID=$(grep -i "mcp-session-id:" /tmp/mcp_headers | cut -d' ' -f2 | tr -d '\r')
      
      $ echo "MCP Session ID: $SESSION_ID"
    3. 다음 명령에서 세션 ID를 사용하여 툴을 나열합니다.

      $ curl -X POST http://mcp-gateway.apps.<cluster-name>.<domain-name>:8001/mcp \
        -H "Content-Type: application/json" \
        -H "mcp-session-id: $SESSION_ID" \
        -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}'

      <cluster-name>.<domain-name>은 클러스터의 이름과 도메인입니다.

    4. 다음 명령을 실행하여 정리합니다.

      $ rm -f /tmp/mcp_headers

      이제 openshift_ 와 같이 구성된 접두사 값이 접두사로 추가된 응답에 MCP 서버 도구가 표시되어야 합니다.

1.1.6.6. 클라이언트를 MCP 서버에 연결

AI 에이전트가 클러스터와 상호 작용할 수 있도록 MCP(Model Context Protocol)와 호환되는 클라이언트를 MCP 서버에 연결합니다.

사전 요구 사항

  • admin 권한으로 OpenShift 콘솔에 액세스할 수 있습니다.
  • MCP 게이트웨이가 설치되어 있습니다.
  • MCP 라이프사이클 Operator가 활성화되어 있습니다.
  • MCP 서버가 설치되어 있어야 합니다.
  • MCP 게이트웨이가 구성 및 확인되어 있습니다.

절차

  1. 클라이언트 구성 파일에 다음 행을 추가합니다.

    • Claude Desktop의 경우: claude_desktop_config.json 파일
    • Claude Code(CLI)의 경우: .mcp.json 파일

      {
        "mcpServers": {
          "openshift": {
            "type": "http",
            "url": "<url of the mcp gateway>/mcp"
          }
        }
      }

      <url of the mcp gateway>은 MCP 게이트웨이 설치 중에 구성한 호스트 이름입니다.

  2. 클라이언트에서 메시지가 표시되면 CA 인증서를 수락합니다.

1.1.6.7. RBAC 적용 구성

MCP(Model Context Protocol) 서버에서 액세스할 수 있는 클러스터 리소스를 제어하려면 AI 에이전트가 필요한 리소스로만 제한되도록 역할 기반 액세스 제어(RBAC)를 구성합니다.

기본적으로 RBAC가 활성화되어 있으며 ClusterRoles, ClusterRoleBindings, Roles, Rolebindings를 확장할 수 있습니다.

사전 요구 사항

  • admin 권한으로 OpenShift 콘솔에 액세스할 수 있습니다.
  • MCP 게이트웨이가 설치되어 있습니다.
  • MCP 라이프사이클 Operator가 활성화되어 있습니다.
  • MCP 서버가 설치되어 있어야 합니다.
  • MCP 게이트웨이가 구성 및 확인되어 있습니다.
  • MCP 호환 클라이언트가 연결되어 있습니다.

절차

  1. ClusterRoles, ClusterRoleBindings, Roles 및 Rolebindings를 확장하여 RBAC 적용을 구성합니다.

    다음 예제 RBAC YAML 파일을 사용하여 ClusterRoles, ClusterRoleBindings, Roles 및 Rolebindings를 확장합니다.

    RBAC 설정 YAML 파일의 예

      apiVersion: rbac.authorization.k8s.io/v1
      kind: ClusterRole
      metadata:
        name: acm-managed-clusters
      rules:
        ...
      ---
      apiVersion: rbac.authorization.k8s.io/v1
      kind: ClusterRoleBinding
      metadata:
        name: acm-managed-clusters
        ...
      ---
      apiVersion: rbac.authorization.k8s.io/v1
      kind: Role
      metadata:
        name: acm-cluster-proxy-discovery
        namespace: multicluster-engine
        ...
      ---
      apiVersion: rbac.authorization.k8s.io/v1
      kind: RoleBinding
      metadata:
        name: acm-cluster-proxy-discovery
        namespace: multicluster-engine
        ...

  2. 위 예제를 파일(예: rbac-values.yaml)에 저장하여 RBAC 구성을 적용한 후 다음 명령을 실행합니다.

    $ oc apply -f rbac-values.yaml

1.1.6.8. 사용자 정의 리소스에 대한 액세스 취소

AI 에이전트가 기밀 클러스터 데이터를 읽거나 노출하지 못하도록, 시크릿 및 ConfigMaps와 같은 민감한 사용자 정의 리소스(CR)에 대한 MCP(Model Context Protocol) 서버 액세스를 취소할 수 있습니다.

사전 요구 사항

  • admin 권한으로 OpenShift 콘솔에 액세스할 수 있습니다.
  • MCP 게이트웨이가 설치되어 있습니다.
  • MCP 라이프사이클 Operator가 활성화되어 있습니다.
  • MCP 서버가 설치되어 있어야 합니다.
  • MCP 게이트웨이가 구성 및 확인되어 있습니다.
  • MCP 호환 클라이언트가 연결되어 있습니다.
  • RBAC가 구성되어 있습니다.

절차

  • 다음 명령을 실행하여 거부된 리소스 값을 추가하도록 openshift-mcp-server ConfigMap을 편집합니다.

    $ oc edit cm openshift-mcp-server

    다음 예제 파일을 사용하여 시크릿, ConfigMaps 및 RBAC 리소스에 대한 액세스를 취소합니다.

    예

    # Deny access to Secrets
    [[denied_resources]]
    group = ""
    version = "v1"
    kind = "Secret"
    
    # Deny access to ConfigMaps
    [[denied_resources]]
    group = ""
    version = "v1"
    kind = "ConfigMap"
    
    # Deny access to RBAC resources for additional security
    [[denied_resources]]
    group = "rbac.authorization.k8s.io"
    version = "v1"
    kind = "Role"
    
    [[denied_resources]]
    group = "rbac.authorization.k8s.io"
    version = "v1"
    kind = "RoleBinding"
    
    [[denied_resources]]
    group = "rbac.authorization.k8s.io"
    version = "v1"
    kind = "ClusterRole"
    
    [[denied_resources]]
    group = "rbac.authorization.k8s.io"
    version = "v1"
    kind = "ClusterRoleBinding"

1.1.6.9. ID 공급자 및 OAuth 통합

Red Hat OpenShift의 MCP 서버를 ID 공급자 및 OAuth와 통합하여 사용자가 Single Sign-On을 통해 인증하고 서버는 ID를 사용하여 OpenShift Container Platform 리소스에 액세스하도록 합니다.

ID 공급자 (IdP)는 사용자 ID 정보를 생성, 유지보수 및 관리하고 애플리케이션 및 시스템에 대한 사용자를 인증하는 중앙 집중식 서비스입니다. IdP는 애플리케이션당 별도의 인증 정보를 사용하는 대신 한 번(단일 사인온)을 인증하고 해당 확인을 다른 서비스에 안전하게 전달할 수 있습니다.

OAuth (특히 OAuth 2.0)는 오픈 표준 권한 부여 프레임워크입니다. 이를 통해 타사 애플리케이션에서 사용자의 암호를 노출하지 않고 다른 서비스의 사용자 리소스에 액세스할 수 있습니다. 로그인 인증 정보를 공유하는 대신 OAuth는 특정 제한된 권한(범위)을 부여하는 액세스 토큰을 사용합니다.

MCP 게이트웨이는 OAuth 토큰의 유효성을 검사하고 OpenShift Container Platform API에 대해 인증하는 MCP 서버에 전달합니다. 서버는 (기본값) 토큰을 전달하거나 구성에 따라 교환합니다. cluster_auth_mode 및 [token_exchange] 블록이 구성되어 있는지 여부에 따라 제어합니다.

사용할 수 있는 두 가지 IAM(Identity and Access Management) 플랫폼이 있습니다.

  • Red Hat build of Keycloak
  • Microsoft Entra ID

1.1.6.10. MCP 게이트웨이 인증 설정

확인된 사용자만 Red Hat OpenShift용 MCP 서버 툴 및 클러스터 리소스에 액세스할 수 있도록 MCP(Model Context Protocol) 게이트웨이에 대한 OAuth 기반 인증을 설정합니다.

사전 요구 사항

  • admin 권한으로 OpenShift 콘솔에 액세스할 수 있습니다.
  • MCP 게이트웨이가 설치되어 있습니다.
  • MCP 라이프사이클 Operator가 활성화되어 있습니다.
  • MCP 서버가 설치되어 있어야 합니다.
  • MCP 게이트웨이가 구성 및 확인되어 있습니다.
  • MCP 호환 클라이언트가 연결되어 있습니다.
  • RBAC가 구성되어 있습니다.
  • 필요에 따라 특정 CR(사용자 정의 리소스)에 대한 액세스 권한을 취소했습니다.
  • ID 공급자(IdP): Entra ID 또는 Keycloak에 액세스할 수 있습니다.
  • OpenShift Container Platform 클러스터는 IdP를 외부 OIDC 공급자로 신뢰하도록 구성되어 있습니다. "외부 OIDC ID 공급자로 직접 인증 활성화"를 참조하십시오.

절차

  1. 다음 명령을 실행하여 MCP 게이트웨이 broker-router 배포에서 환경 변수를 설정하여 OAuth 메타데이터 검색을 구성합니다.

    $ oc set env mcp-gateway/gateway-namespace -n mcp-system\
    OAUTH_RESOURCE_NAME="MCP Server" \
    OAUTH_RESOURCE="https://<mcp_gateway_host>/mcp" \
    OAUTH_AUTHORIZATION_SERVERS=<authorization_server_url> \
    OAUTH_BEARER_METHODS_SUPPORTED="header" \
    OAUTH_SCOPES_SUPPORTED=<oauth-scopes-supported>
    참고

    이러한 환경 변수는 클라이언트가 인증 검색에 사용하는 OAuth 2.0 Protected Resource Metadata 엔드포인트를 활성화합니다.

  2. 다음 명령을 실행하여 OAuth 검색용 HTTPRoute를 생성합니다.

    $ oc apply -f - <<EOF
    apiVersion: gateway.networking.k8s.io/v1
    kind: HTTPRoute
    metadata:
      name: mcp-gateway-oauth-metadata
      namespace: gateway-namespace
    spec:
      parentRefs:
      - group: gateway.networking.k8s.io
        kind: Gateway
        name: mcp-gateway
        namespace: gateway-namespace
        sectionName: mcp
      hostnames:
      - ${MCP_GATEWAY_HOST}
      rules:
      - matches:
        - path:
            type: PathPrefix
            value: /.well-known/oauth-protected-resource
        backendRefs:
        - name: mcp-gateway
          port: 8080
    EOF

    ${MCP_GATEWAY_HOST}는 MCP 게이트웨이의 정규화된 도메인 이름입니다(예: mcp.127-0-0-1.sslip.io).

    이 경로를 사용하면 클라이언트가 인증 흐름에 필요한 OAuth 메타데이터를 검색할 수 있습니다. 이 경로가 없으면 클라이언트는 OAuth 검색을 시도할 때 404 오류가 발생합니다.

  3. IdP(Entra ID 또는 Keycloak) 앱 등록을 구성합니다.

    • Entra ID 의 경우:

      1. Azure Portal 또는 Entra admin center에서 Entra ID 앱 등록으로 이동합니다.
      2. API 노출에서 mcp-server라는 사용자 지정 범위를 추가합니다.
      3. openid,offline_access, mcp-server의 범위를 사용할 수 있는지 확인합니다.
      4. 조직에 필요한 경우 이러한 범위에 대한 관리자 동의를 부여합니다.

        Entra ID 앱 등록 구성에 대한 자세한 내용은 "Microsoft Entra ID"를 참조하십시오.

    • Keycloak 의 경우:

      1. Keycloak 영역에 다음과 같은 필수 범위가 있는지 확인합니다.

        • OpenID (built-in)
        • offline_access (built-in)
        • MCP-server(사용자 정의 - 존재하지 않는 경우 생성)
      2. 관리자 콘솔에서 Cryostat 설정 > 클라이언트 등록 > 인증된 액세스 정책으로 이동하여 이러한 범위를 영역의 DCR 허용 클라이언트 범위 정책에 추가합니다.

        Keycloak에 대한 자세한 내용은 "Red Hat build of Keycloak"을 참조하십시오.

  4. 다음 명령을 실행하여 IdP의 CA 인증서를 Authorino 배포에 마운트하여 JWT 검증에 대한 인증서 신뢰를 구성합니다.

    중요

    IdP에서 공개적으로 신뢰할 수 있는 인증서를 사용하는 경우 이 단계를 건너뜁니다.

    $ oc create configmap idp-ca --from-file=ca.crt=/path/to/idp-ca.crt -n kuadrant-system
    $ oc patch deployment authorino -n kuadrant-system --type=json -p='[
      {
        "op": "add",
        "path": "/spec/template/spec/volumes/-",
        "value": {"name": "idp-ca", "configMap": {"name": "idp-ca"}}
      },
      {
        "op": "add",
        "path": "/spec/template/spec/containers/0/volumeMounts/-",
        "value": {"name": "idp-ca", "mountPath": "/etc/ssl/certs/idp-ca.crt", "subPath": "ca.crt"}
      }
    ]'

    이렇게 하면 Authorino가 IdP에서 JWT 토큰 서명을 확인할 수 있습니다.

  5. 다음 명령을 실행하여 JWT 토큰을 검증하는 인증 정책을 적용하여 MCP 게이트웨이 인증을 구성합니다.

    $ oc apply -f - <<EOF
    apiVersion: kuadrant.io/v1
    kind: AuthPolicy
    metadata:
      name: mcp-auth-policy
      namespace: gateway-namespace
    spec:
      targetRef:
        group: gateway.networking.k8s.io
        kind: Gateway
        name: mcp-gateway
        sectionName: mcp
      defaults:
        when:
          - predicate: "!request.path.contains('/.well-known')"
        rules:
          authentication:
            'idp':
              jwt:
                issuerUrl: <authorization_server_url>
          response:
            unauthenticated:
              code: 401
              headers:
                'WWW-Authenticate':
                  value: Bearer resource_metadata=https://<mcp_gateway_host>/.well-known/oauth-protected-resource/mcp
                body:
                  value: |
                    {
                      "error": "Unauthorized",
                      "message": "Authentication required."
                    }
    
            success:
              headers:
                authorization:
                  plain:
                    expression: "request.headers['authorization']"
    
    EOF
  6. 다음과 유사한 파일을 사용하여 ClusterRoleBinding 을 생성하여 클러스터에 대해 인증된 사용자 권한을 부여합니다.

    apiVersion: rbac.authorization.k8s.io/v1
    kind: ClusterRoleBinding
    metadata:
      name: oidc-mcp-cluster-reader
    roleRef:
      apiGroup: rbac.authorization.k8s.io
      kind: ClusterRole
      name: view
    subjects:
    - apiGroup: rbac.authorization.k8s.io
      kind: User
      name: <issuer_url>#<username>
    • name: < issuer_url>#<username> 형식의 사용자 제목입니다.
    • 사용자에게 필요한 액세스 수준으로 ClusterRole (예: view)을 조정합니다.

검증

  1. 다음 명령을 실행하여 브로커가 OAuth 검색 정보를 제공하는지 테스트하여 OAuth Discovery를 확인합니다.

    curl ${MCP_GATEWAY_HOST}/.well-known/oauth-protected-resource

    ${MCP_GATEWAY_HOST} 의 경우 MCP 게이트웨이 도메인을 사용합니다.

    이 명령은 다음과 유사한 OAuth 2.0 Protected Resource Metadata를 표시해야 합니다.

    예

    {
      "resource_name": "MCP Server",
      "resource": "http://mcp.127-0-0-1.sslip.io:8001/mcp",
      "authorization_servers": [
        "https://login.microsoftonline.com/<tenant-id>/v2.0"
      ],
      "bearer_methods_supported": [
        "header"
      ],
      "scopes_supported": [
        "mcp-server",
      ]
    }

  2. 다음 명령을 실행하여 보호된 엔드포인트에 이제 인증이 필요한지 테스트합니다.

    $ curl -v ${MCP_GATEWAY_HOST}/mcp \
      -H "Content-Type: application/json" \
      -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'
    • ${MCP_GATEWAY_HOST} 의 경우 MCP 게이트웨이 도메인을 사용합니다.

      예

      {
        "error": "Unauthorized",
        "message": "Authentication required."
      }

1.1.6.11. MCP 게이트웨이 권한 부여 설정

MCP(Model Context Protocol) 게이트웨이에 대한 툴 수준 권한 부여를 설정하여 특정 MCP 서버 툴에 액세스할 수 있는 사용자를 제어하여 각 사용자가 역할에서 허용하는 작업만 사용할 수 있도록 합니다.

사전 요구 사항

  • admin 권한으로 OpenShift 콘솔에 액세스할 수 있습니다.
  • MCP 게이트웨이가 설치되어 있습니다.
  • MCP 라이프사이클 Operator가 활성화되어 있습니다.
  • MCP 서버가 설치되어 있어야 합니다.
  • MCP 게이트웨이가 구성 및 확인되어 있습니다.
  • MCP 호환 클라이언트가 연결되어 있습니다.
  • RBAC가 구성되어 있습니다.
  • 필요에 따라 특정 CR(사용자 정의 리소스)에 대한 액세스 권한을 취소했습니다.
  • MCP 게이트웨이 인증이 구성되어 있습니다.

절차

  1. ID 공급자에 발행된 JWT 토큰에 필요한 그룹/역할 클레임이 포함되어 있는지 확인합니다.

    발행된 OAuth 토큰에는 다음과 유사한 클레임이 포함되어야 합니다.

    예

    {
      "resource_access": {
        "mcp-ns/openshift-mcp-server": {
          "roles": ["pods_list", "events_list", "nodes_list", "deployments_get"]
        },
        "mcp-ns/geometry-mcp-server": {
          "roles": ["pods_list", "events_list", "nodes_list", "deployments_get"]
        }
      }
    }

    • 네임스페이스는 MCPServerRegistration CR의 네임스페이스와 일치해야 합니다.
    • “roles”는 허용된 툴을 나타냅니다. 이 예에서는 pods_list, events_list, nodes_list, deployments_get입니다.
  2. 다음 명령을 실행하여 툴 수준 액세스 제어를 시행하는 AuthPolicy를 적용하여 툴 수준 권한 부여를 구성합니다.

    $ oc apply -f - <<EOF
    apiVersion: kuadrant.io/v1
    kind: AuthPolicy
    metadata:
      name: mcp-tool-auth-policy
      namespace: openshift-mcp-server
    spec:
      targetRef:
        group: gateway.networking.k8s.io
        kind: Gateway
        name: mcp-gateway
        sectionName: mcp
      rules:
        authentication:
          'idp':
            jwt:
              issuerUrl: <authorization_server_url>
        authorization:
          'tool-access-check':
            patternMatching:
              patterns:
                - predicate: |
                    request.headers['x-mcp-toolname'] in (has(auth.identity.resource_access) && auth.identity.resource_access.exists(p, p == request.headers['x-mcp-servername']) ? auth.identity.resource_access[request.headers['x-mcp-servername']].roles : [])
        response:
          unauthenticated:
            headers:
              'WWW-Authenticate':
                value: Bearer resource_metadata=https://<mcp_gateway_host>/.well-known/oauth-protected-resource/mcp
            body:
              value: |
                {
                  "error": "Unauthorized",
                  "message": "MCP Tool Access denied: Authentication required."
                }
          unauthorized:
            body:
              value: |
                {
                  "error": "Forbidden",
                  "message": "MCP Tool Access denied: Insufficient permissions for this tool."
                }
    EOF
    • &lt ;authorization_server_url >의 경우 다음 중 하나를 사용합니다.

    • spec.sectionName 은 MCP 서버 Listener를 대상으로 합니다.
    • <cluster-name>.<domain-name>은 클러스터의 이름과 도메인입니다.

검증

  1. MCP Inspector를 설정하여 권한 부여가 툴 액세스를 제어하는지 테스트합니다.

    1. 다음 명령을 실행하여 MCP Inspector를 시작합니다(Node.js/npm 필요).

      $ npx @modelcontextprotocol/inspector@latest &
      INSPECTOR_PID=$!
    2. 다음 명령을 실행하여 서비스가 시작될 때까지 기다립니다.

      $ sleep 3
    3. 다음 URL로 이동하여 MCP Inspector를 엽니다. http://localhost:6274/?transport=streamable-http&serverUrl=https://<mcp_gateway_host>/mcp.

      & lt;mcp_gateway_host >를 MCP 게이트웨이의 정규화된 도메인 이름으로 바꿉니다.

  2. 나중에 서비스를 중지하려면 다음 명령을 실행합니다.

    $ kill $INSPECTOR_PID
  3. ID 공급자에서 필요한 역할 클레임으로 구성된 사용자 계정을 사용하여 인증합니다.
  4. 다음과 같은 허용된 툴을 사용해 보십시오.

    • pods_list
    • events_list
    • nodes_list
    • deployments_get
  5. 이 제한된 툴 시도: pods_delete

    이 툴은 제한되므로 403 Forbidden 오류가 발생해야 합니다.

  6. 권한 부여 결정을 모니터링합니다.

    1. 다음 명령을 실행하여 AuthPolicy 상태를 확인합니다.

      $ oc get authpolicy -A
    2. 다음 명령을 실행하여 권한 부여 로그를 확인합니다.

      $ oc logs -n kuadrant-system -l authorino-resource=authorino

1.1.6.12. 클러스터에 대한 MCP 서버 인증 구성

사용자 ID로 실행되도록 Red Hat OpenShift의 MCP 서버가 사용자 토큰을 통과하거나 클러스터가 허용하는 토큰에 대해 교환하여 OpenShift Container Platform API 서버에 인증하는 방법을 구성합니다.

두 가지 방법이 있습니다.

  • Passthrough (기본값): 서버가 사용자의 토큰을 클러스터로 직접 전달합니다. 클러스터가 사용자의 토큰을 그대로 수락할 때 사용됩니다.

    cluster_auth_mode = "passthrough"

    cluster_auth_mode 가 설정되지 않은 경우 기본값입니다.

  • 토큰 교환: 서버는 클러스터를 수락하는 토큰을 교환하여 사용자 ID를 보존합니다. [token_exchange] 블록이 있는 경우 패스스루 내에서 교환이 수행됩니다.

사전 요구 사항

  • admin 권한으로 OpenShift 콘솔에 액세스할 수 있습니다.
  • MCP 게이트웨이가 설치되어 있습니다.
  • MCP 라이프사이클 Operator가 활성화되어 있습니다.
  • MCP 서버가 설치되어 있어야 합니다.
  • MCP 게이트웨이가 구성 및 확인되어 있습니다.
  • MCP 호환 클라이언트가 연결되어 있습니다.
  • RBAC가 구성되어 있습니다.
  • 필요에 따라 특정 CR(사용자 정의 리소스)에 대한 액세스 권한을 취소했습니다.
  • MCP 게이트웨이 인증이 구성되어 있습니다.
  • passthrough: 클러스터는 IdP를 외부 OIDC 공급자로 신뢰합니다.

절차

  • 패스스루 토큰 교환을 설정하려면 config.toml ConfigMap 에 다음 콘텐츠를 추가합니다.

    Keycloak (RFC 8693):
    [token_exchange]
    strategy = "rfc8693"
    audience = "openshift"
    scopes = ["mcp:openshift"]
    
    [token_exchange.client_auth]
    method = "client_secret_basic"
    client_id = "mcp-server"
    client_secret = "<client_secret>"
    Entra (On-Behalf-Of):
    [Token_exchange]
    strategy = "entra-obo"
    scopes = ["api://<downstream_api_app_id>/.default"]
    
    [token_exchange.client_auth]
    method = "private_key_jwt"   # certificate (recommended)
    client_id = "<client_id>"
    certificate_file = "/path/to/client.crt"
    private_key_file = "/path/to/client.key"
    참고

    [token_exchange] 및 oauth_*/require_oauth 를 다시 로드할 수 있지만 구성에 대한 변경 사항은 자동으로 적용되지 않습니다. 구성 변경 사항을 적용하는 방법에 대한 자세한 내용은 "Red Hat OpenShift용 MCP 서버에 구성 변경 사항 적용"을 참조하십시오.

검증

  • 서버가 클러스터 API에 사용자로 도달하는지 확인합니다(예: 클러스터 액세스가 필요한 툴 호출) 또는 auth mode/exchange의 서버 로그를 확인합니다.

1.1.7. Red Hat OpenShift용 MCP 서버 프롬프트

MCP(Model Context Protocol) 서버 프롬프트를 사용하여 LLM(Large Language Model)을 쿼리하여 OpenShift Container Platform 클러스터에서 문제를 식별하고 진단합니다.

참고

프롬프트를 입력할 때 최상의 결과를 얻으려면 다음을 수행하십시오.

  • 네임스페이스를 지정합니다.
  • Red Hat Advanced Cluster Management for Kubernetes(ACM) 환경의 경우 클러스터를 지정합니다.

1.1.7.1. MCP 프롬프트

MCP 프롬프트는 특정 워크플로우를 통해 AI 어시스턴트를 안내하는 사전 정의된 템플릿입니다.

다음을 결합합니다:

  • 구조화된 지침: 일반적인 작업에 대한 단계별 지침
  • 매개 변수화: 특정 컨텍스트에 대한 프롬프트를 사용자 지정하는 인수
  • 대화 템플릿: 상호 작용을 안내하는 미리 포맷된 메시지

1.1.7.2. 사용자 정의 프롬프트 생성

config.toml 파일에 사용자 정의 프롬프트를 정의합니다. 코드 변경 및 다시 컴파일은 필요하지 않습니다.

구성 변경 사항을 적용하는 방법에 대한 자세한 내용은 "Red Hat OpenShift용 MCP 서버에 구성 변경 사항 적용"을 참조하십시오.

사용자 정의 프롬프트의 예

[[prompts]]
name = "check-pod-logs"
title = "Check Pod Logs"
description = "Quick way to check pod logs"

[[prompts.arguments]]
name = "pod_name"
description = "Name of the pod"
required = true

[[prompts.arguments]]
name = "namespace"
description = "Namespace of the pod"
required = false

[[prompts.messages]]
role = "user"
content = "Show me the logs for pod {{pod_name}} in {{namespace}}"

[[prompts.messages]]
role = "assistant"
content = "I'll retrieve and analyze the logs for you."

표 1.1. 구성 참조
프롬프트 필드

name(필수)

프롬프트의 고유 식별자

title(선택 사항)

사람이 읽을 수 있는 표시 이름

description(필수)

프롬프트의 기능에 대한 간략한 설명

arguments(선택 사항)

프롬프트에서 허용하는 매개변수 목록

messages(필수)

역할/컨텐츠 쌍을 사용한 대화 템플릿

인수 필드

name(필수)

인수 식별자

description(선택 사항)

인수의 목적에 대한 설명

required(선택 사항)

인수를 제공해야 하는지 여부(기본값: false)

인수 치환

메시지 콘텐츠에 {{argument_name}} 자리 표시자를 사용합니다. 템플릿 엔진은 프롬프트가 호출될 때 이러한 값을 실제 값으로 대체합니다. 선택적 인수를 제공하지 않으면 해당 자리 표시자가 출력에서 제거됩니다.

1.1.7.3. 기본 제공 프롬프트

Red Hat OpenShift용 MCP 서버에는 항상 사용 가능한 몇 가지 기본 제공 프롬프트가 포함되어 있습니다.

cluster-health-check 는 OpenShift 클러스터에 대한 포괄적인 상태 평가를 수행합니다.

인수:

  • namespace(선택 사항): 상태 점검을 특정 네임스페이스로 제한합니다. 기본값: 모든 네임스페이스.
  • check_events(선택 사항): 분석에 최근 경고/오류 이벤트를 포함합니다. 값: true 또는 false. 기본값: true.

확인하는 내용:

  • 노드: 상태 및 조건(예: Ready, MemoryPressure, DiskPressure)
  • 클러스터 Operator: 사용 가능하고 성능이 저하된 상태
  • Pod: 단계, 컨테이너 상태, 재시작 횟수 및 일반적인 문제 (예: CrashLoopBackOff, ImagePullBackOff)
  • 워크로드 컨트롤러: Deployments, StatefulSets, DaemonSets 복제본 상태
  • 영구 볼륨 클레임: 바인딩 상태
  • 이벤트: 최근 1시간의 경고 및 오류 이벤트

사용 예:

Check the health of my cluster

또는 특정 매개변수의 경우:

Check the health of namespace production

더 빠른 결과를 위해 이벤트 검사를 건너뛸 수도 있습니다.

Check the health of my cluster without events

프롬프트는 포괄적인 진단 데이터를 수집하여 분석을 위해 이를 LLM에 제공하며, LLM은 다음을 제공합니다.

  • 전반적인 상태(Healthy, Warning 또는 Critical)
  • 즉각적인 주의가 필요한 심각한 문제
  • 경고 및 권장 사항
  • 구성 요소별 요약

1.1.7.4. 구성 파일 위치

MCP 서버에서 사용하는 config.toml 파일에 프롬프트를 배치합니다. 서버를 시작할 때 --config flag를 사용하여 구성 파일 경로를 지정합니다.

1.1.7.5. 툴셋 프롬프트

일부 툴셋에는 프롬프트가 포함되어 있으며 툴셋을 활성화하면 프롬프트가 활성화됩니다.

1.1.7.6. 프롬프트 병합

툴셋과 구성 프롬프트가 둘 다 있는 경우 구성 정의된 프롬프트가 동일한 이름으로 툴셋 프롬프트를 덮어씁니다. 이를 통해 관리자는 기본 제공 워크플로우를 사용자 지정할 수 있습니다. 두 소스 모두에서 고유한 이름을 가진 프롬프트를 사용할 수 있습니다.

1.1.8. Red Hat OpenShift용 MCP 서버 툴셋

툴 세트는 Red Hat OpenShift의 MCP 서버가 노출하는 툴 및 리소스 및 프롬프트 등 이름이 지정된 관련 기능 그룹입니다. 에이전트는 활성화된 툴 세트에서 툴을 사용하여 작업을 수행합니다.

툴셋에는 두 가지 종류가 있습니다.

코어
Kubernetes 프리미티브를 제공하는 기본값 always-on, toolset(예: pods_list,pods_exec)입니다. 다른 도구 모음은 그 위에 구축됩니다.
선택 사항
이렇게 하면 특정 도메인에 대한 서버(경고, 서비스 메시 등)가 확장됩니다. 기본적으로 꺼져 있으며 명시적으로 활성화합니다.

1.1.8.1. 툴 세트 활성화

에이전트에게 특정 작업에 필요한 항목을 제공하면서 툴 표면을 유지 관리하는 데 필요한 툴 세트만 활성화합니다. 툴셋을 활성화하려면 config.toml 의 툴셋 설정에 원하는 툴 세트를 나열해야 합니다. 변경 사항을 다시 로드할 수 있습니다. 그러나 다시 로드할 수 있는 것은 자동이라는 의미는 아닙니다.

구성 변경 사항을 적용하는 방법에 대한 자세한 내용은 "Red Hat OpenShift용 MCP 서버에 구성 변경 사항 적용"을 참조하십시오.

일부 툴 세트에는 [toolset_configs.<name>] 의 자체 구성과 툴 외에도 일부 번들 프롬프트 또는 리소스가 필요합니다. 특정 툴셋을 활성화하는 방법에 대한 자세한 내용은 "사용 가능한 툴 세트" 테이블의 "추가 정보" 열을 참조하십시오.

1.1.8.2. 툴셋 툴 보기

툴셋을 활성화하면 연결된 MCP 클라이언트에서 제공하는 툴을 사용할 수 있게 됩니다. 사용 가능한 툴을 보려면 tools/list 방법을 사용하여 검색하는 MCP 클라이언트의 툴 목록을 확인합니다.

1.1.8.3. 사용 가능한 툴 세트

표 1.2. 사용 가능한 툴 세트
Name설명기본적으로 활성화되어 있음추가 정보

코어

Kubernetes 프리미티브(예: pods_list,pods_exec)

제공됨

 

OS sm (kiali)

OpenShift Service Mesh/Kiali 메시 툴

이 툴 세트를 사용하면 도우미가 Red Hat OpenShift용 MCP 서버에서 Kiali를 통해 메시 상태 및 트래픽 그래프와 같은 OpenShift Service Mesh 정보를 쿼리할 수 있습니다.

없음

"ossm (kiali) toolset"을 참조하십시오.

ovn-kubernetes/cni-diagnostics

OVN/OVS/CNI 네트워킹 진단

없음

"Troubleshooting OVN-Kubernetes with the MCP server"를 참조하십시오.

netedge

네트워크 인그레스 및 DNS(NIDS) 문제 해결

이 툴 세트는 Red Hat OpenShift의 MCP 서버를 네트워크 인그레스 및 DNS(NIDS) 구성 요소에 대해 읽기 전용 AI 중심 진단으로 확장합니다.

없음

"AI 기반 네트워킹 문제 해결"을 참조하십시오.

1.1.8.4. OSSM (Service Mesh) 툴셋

도우미가 라이브 OpenShift Service Mesh를 쿼리하고 선택적으로 Kiali가 이미 제공하는 툴을 사용하여 구성을 변경할 수 있도록 ossm (Kiali) 툴셋을 활성화하고 구성합니다.

길잡이가 Kiali에 직접 연결되지 않습니다. Red Hat OpenShift의 MCP 서버에 연결하고 해당 서버는 호출자의 토큰을 사용하여 Kiali를 호출합니다.

ossm 로 툴셋을 활성화합니다. 툴 이름에서는 ossm_ 접두사를 사용합니다.

사전 요구 사항

  • Red Hat OpenShift용 MCP 서버가 설치되어 있어야 합니다.
  • OpenShift Service Mesh가 설치되고 MCP 서버는 Kiali 경로에 연결할 수 있습니다.
  • MCP 서버를 시작하는 OpenShift ID는 네임스페이스를 나열하고 도우미에서 확인해야 하는 메시 리소스를 읽을 수 있습니다.

절차

  1. ossm 툴셋을 활성화하려면 ossm 툴셋을 포함하도록 config.toml 파일을 추가하거나 업데이트합니다.

    ossm 툴셋 추가

    toolsets = ["core", "ossm"]

  2. 다음과 유사한 ossm 툴 세트를 구성합니다.

    ossm 툴셋 구성 추가

    [toolset_configs.kiali]
    url = "https://<kiali_route>"
    # insecure = true
    # certificate_authority = "/path/to/ca.crt"

    중요

    테이블이 없거나 유효하지 않으면 서버가 시작되지 않습니다.

    • ossm toolset은 [toolset_configs.kiali] 에서 설정을 읽습니다.
    • URL 이 필요합니다.

      호스트를 포함하는 http:// 또는 https:// URL을 사용합니다. url 이 https:// 이고 insecure 가 false 인 경우 certificate_authority 를 Kiali 인증서의 CA 파일로 설정합니다. 상대 CA 경로는 TOML 파일이 포함된 디렉터리에서 확인됩니다.

    • 프로덕션 외부에서 insecure = true 는 인증서 확인을 건너뜁니다.
    • read_only = true (default) hides ossm_manage_istio_config:

      메시 구성을 생성, 업데이트 또는 삭제할 수 있는 도우미의 권한을 설정하려면 다음을 수행합니다.

      • not allowed: read_only = true 를 설정합니다.
      • is allowed: read_only 를 설정하지 않거나 false 로 설정합니다.

        구성 변경 사항을 적용하는 방법에 대한 자세한 내용은 "Red Hat OpenShift용 MCP 서버에 구성 변경 사항 적용"을 참조하십시오.

  3. 호출자의 ID를 operator 제공 kiali-viewer (read) 또는 kiali (읽기/쓰기) ClusterRole 에 바인딩합니다.

    서버는 기존 Kubernetes 인증 정보( kubeconfig 또는 in-cluster에서)를 사용하여 Kiali 호출에 대한 전달자 토큰을 설정합니다. Kiali에는 MCP HTTP 끝점에 전달된 HTTP 인증 헤더가 필요하지 않습니다. Kiali 호출은 서버의 구성된 토큰을 사용합니다.

    Kiali는 해당 토큰을 사용하여 액세스를 적용합니다(네임스페이스 get/list 및 쓰기 및 로그, 리소스 RBAC). 이를 RBAC 메타데이터로 알리는 툴:

    • Kubernetes 검사를 인수 또는 유한 종류 enum(로그, 리소스 세부 정보, Istio 구성 읽기/쓰기, 메트릭/추적 네임스페이스 게이트, 트래픽 그래프)에서 가져올 수 있는 툴에 바인딩됩니다. OpenShift Container Platform에서 리소스/그래프 선언에는 Operator 뷰어 역할의 deployment config 및 경로 도 포함됩니다.
    • Kiali는 제한된 Kubernetes 요구 사항 세트로 표시할 수 없는 control-plane 및 observability 백엔드를 집계하는 메시 전체 상태 및 메시 클러스터 목록에 바인딩되지 않았습니다.
  4. 선택 사항: 다중 클러스터 지원을 설정합니다.

    Kiali는 Istio 서비스 메시 내에서 여러 클러스터를 관리할 수 있습니다. 대부분의 Kiali 툴에서는 선택적 meshCluster 매개변수를 허용하여 특정 메시 클러스터를 대상으로 합니다. 툴의 이름을 클러스터로 지정하지 않으면 Kiali가 실행되는 클러스터인 홈 클러스터를 사용합니다.

    다른 툴을 호출하기 전에 사용 가능한 메시 클러스터 이름을 검색하려면 ossm_list_mesh_clusters 를 사용합니다. 해당 응답의 name 필드는 meshCluster 에 대해 유일하게 유효한 값입니다.

    ossm 툴에서는 OpenShift 컨텍스트 를 사용하지 않습니다. ossm_list_mesh_clusters 의 메시 클러스터 이름을 사용합니다. 다중 클러스터 모드가 활성화된 경우에도 동일한 MCP 서버의 핵심 툴에서 컨텍스트 를 계속 사용합니다.

1.1.8.5. 툴셋 툴 목록

Red Hat OpenShift용 MCP 서버의 각 툴 세트는 작업을 수행하는 데 도움이 되는 툴 세트를 제공합니다. 이 표에는 각 툴셋의 도구가 나열되고 각 툴의 기능을 설명합니다.

각 툴 이름은 길잡이가 호출하는 대로 표시됩니다.

표 1.3. ossm 툴
Name수행하는 작업

ossm_get_logs

네임스페이스에서 Pod 또는 워크로드에 대한 로그를 반환합니다.

ossm_get_mesh_status

컨트롤 플레인, 데이터 플레인, 관찰 기능 백엔드 및 해당 구성 요소가 연결하는 방법을 포함한 메시 상태를 반환합니다.

메시 전체 보기가 필요한 경우 먼저 이 값을 사용합니다.

ossm_get_mesh_traffic_graph

처리량, 응답 시간, mTLS와 같은 서비스 간 트래픽, 종속성 및 네트워크 지표를 반환합니다.

ossm_get_metrics

서비스, 워크로드 또는 애플리케이션에 대한 대기 시간, 트래픽, 처리량 및 페이로드 지표를 반환합니다.

ossm_get_pod_performance

Pod의 현재 CPU 및 메모리 사용을 요청 및 제한과 비교합니다.

ossm_get_resource_details

애플리케이션, 서비스, 워크로드, 네임스페이스 또는 Argo CD 애플리케이션을 나열하거나 하나의 리소스에 대한 세부 정보를 반환합니다.

ossm_get_trace_details

분산 추적 하나의 호출 계층 구조를 반환합니다.

ossm_list_traces 후에 사용하십시오.

ossm_list_mesh_clusters

Kiali가 액세스할 수 있는 메시 클러스터를 나열하고 Kiali가 실행되는 홈 클러스터를 식별합니다.

ossm_list_traces

서비스의 분산 추적을 나열합니다.

ossm_manage_istio_config

Istio, Gateway API 및 Inference API 리소스를 포함하여 서비스 메시 구성을 생성, 업데이트 또는 삭제합니다.

이 도구는 서버가 읽기 전용일 때 숨겨집니다.

ossm_manage_istio_config_read

서비스 메시 구성을 나열하거나 하나의 리소스를 반환합니다.

유효한 오브젝트 및 유효하지 않은 오브젝트는 별도로 보고됩니다.

1.1.8.6. 문제 해결 툴 세트

Red Hat OpenShift용 MCP 서버에서 툴셋을 활성화하고 구성할 때 발생할 수 있는 일반적인 문제를 진단하고 해결합니다.

다음 표를 사용하여 ossm 툴셋의 문제를 해결합니다.

표 1.4. ossm 툴 세트 문제 해결
문제해결

ossm 툴셋이 활성화되면 Kiali 구성이 누락되었습니다.

config.toml 에 [toolset_configs.kiali].url 을 설정합니다.

잘못된 URL입니다.

[toolset_configs.kiali].url 이 유효한 http(s)://host URL인지 확인합니다.

TLS 인증서 검증.

* [toolset_configs.kiali].url 에서 HTTPS를 사용하고 [toolset_configs.kiali].insecure 가 false인 경우 CA 인증서 파일 경로로 [toolset_configs.kiali].certificate_authority 를 설정해야 합니다. 상대 경로는 구성 파일이 포함된 디렉터리를 기준으로 해석됩니다.

* 프로덕션 환경 이외의 환경의 경우 [toolset_configs.kiali].insecure = true 를 설정하여 인증서 확인을 건너뛸 수 있습니다.

'ossm을 활성화한 후 서버가 시작되지 않음

Set [toolset_configs.kiali].url.

URL이 거부됩니다.

호스트를 포함하는 http:// 또는 https:// URL을 사용합니다.

HTTPS는 인증서 확인에 실패합니다.

certificate_authority 를 CA 파일로 설정하거나 프로덕션 외부에서 insecure = true 를 설정합니다.

툴은 데이터를 반환하지 않거나 권한 부여 오류를 반환합니다.

Kiali에 제공된 토큰은 해당 네임스페이스 또는 리소스를 읽을 수 없습니다. ID를 kiali-viewer 또는 kiali 에 바인딩합니다.

ossm_manage_istio_config 는 제공되지 않습니다.

서버가 read_only = true 로 실행 중입니다.

1.1.9. MCP 서버 업그레이드 및 롤아웃 모니터링

MCP(Model Context Protocol) 서버를 업그레이드하려면 MCPServer CR(사용자 정의 리소스)에서 컨테이너 이미지 참조를 업데이트합니다. 그런 다음 MCP Lifecycle Operator에서 새 서버 버전을 롤아웃하고 CR 상태 조건을 통해 진행 상황을 보고합니다.

참고

TLS(Transport Layer Security) 기능을 사용하려면 MCP Lifecycle Operator의 해당 버전을 실행해야 합니다. MCPServer CR에서 서버 이미지를 업데이트하기 전에 Lifecycle Operator를 업그레이드합니다.

업그레이드는 또한 MCP 사양의 새 버전을 지원하며, 다양한 툴 세트를 정리 및 개선하고, 별도의 포트에서 지표 끝점을 실행할 수 있으며, auth/tokenexchange 흐름을 개선할 수 있습니다.

사전 요구 사항

  • MCP Lifecycle Operator가 설치되고 TLS 기능이 필요한 경우 이를 지원하는 버전으로 업그레이드됩니다. " MCP 서버 라이프사이클 관리 활성화"를 참조하십시오(Red Hat OpenShift AI 문서).

절차

  1. 새 서버 이미지를 가리키도록 MCPServer CR을 편집합니다.

    apiVersion: mcp.openshift.io/v1alpha1
    kind: MCPServer
    metadata:
        name: openshift-mcp-server
    spec:
        source:
            containerImage:
                ref: <new_image_reference>
    • spec.source.containerImage.ref: 대상 MCP 서버 버전에 대한 컨테이너 이미지 참조(예: registry.redhat.io/openshift-mcp/openshift-mcp-server-rhel9:495310209578a754f3383016486fa8f611 11452) .
  2. 다음 명령을 실행하여 변경 사항을 적용합니다.

    $ oc apply -f mcpserver.yaml

검증

  • 다음 명령을 실행하여 롤아웃을 모니터링합니다.

    $ oc get mcpserver openshift-mcp-server -o yaml

    status.conditions 는 Accepted 를 통해 진행되어야 하며, 구성이 유효한지 확인한 후 배포가 실행 중이지만 아직 핸드셰이크가 없음을 나타냅니다. 마지막으로 확인 시 프로토콜 핸드셰이크가 성공했으며 MCP 서버가 다시 작동합니다.

1.1.10. 메트릭을 사용하여 Red Hat OpenShift의 MCP 서버 모니터링

Red Hat OpenShift의 MCP 서버는 OTLP(OpenTelemetry Protocol) 내보내기 또는 Prometheus를 사용하여 서버 상태, 요청 속도 및 툴셋 활동을 모니터링할 수 있는 지표를 노출합니다.

표 1.5. 사용 가능한 메트릭 캡처 방법
Mechanism방향방법endpoint/config

OTLP 내보내기

push

서버는 30초마다 메트릭을 구성된 OTLP 엔드포인트로 푸시합니다.

[telemetry] config.toml

Prometheus

pull

Prometheus가 서버를 스크랩

/metrics 끝점 및 ServiceMonitor

참고

MCP 서버는 또한 HTTP 포트에서 OpenMetrics 형식으로 Prometheus 호환 /metrics 끝점을 노출합니다. 가져오기 기반 컬렉션을 선호하는 경우 서버의 메트릭 포트를 대상으로 하는 ServiceMonitor를 생성합니다. 레이블을 사용합니다.

  • app: mcp-server 및 mcp-server:MCPServer CR>의 MCP 서버 이름
  • 포트: mcp

자세한 내용은 "OpenShift Container Platform 모니터링 정보"를 참조하십시오.

표 1.6. 사용 가능한 메트릭
지표유형설명

k8s_mcp_tool_calls_total

카운터

총 MCP 툴 호출( tool_name으로 레이블이 지정됨)

k8s_mcp_tool_errors_total

카운터

총 MCP 툴 오류 ( tool_name으로 레이블이 지정됨)

k8s_mcp_tool_duration_seconds

히스토그램

툴 호출 기간(초)

k8s_mcp_http_requests_total

카운터

HTTP 요청( method/path/status class로 레이블이 지정됨)

k8s_mcp_server_info

게이지

서버 정보(버전으로 레이블이 지정됨, go_version)

사전 요구 사항

  • Red Hat OpenShift용 MCP 서버가 설치되어 실행 중입니다.

절차

  1. MCP 서버 config.toml 파일에서 다음 예에 따라 OTLP 끝점 및 전송 프로토콜을 설정하는 [telemetry] 섹션을 추가합니다.

    [telemetry]
    endpoint = "http://<otlp_endpoint>:4317"
    protocol = "grpc"
    • endpoint: OTLP 백엔드의 URL입니다. endpoint 를 설정하면 Telemetry가 자동으로 활성화됩니다.
    • 프로토콜: Either grpc (포트 4317의 기본값) 또는 http/protobuf (포트 4318)에 있습니다. 프로토콜과 일치하도록 포트를 설정합니다.
  2. 선택 사항: 보안(TLS) 끝점의 경우 https:// URL을 사용하고 자체 서명된 CA의 경우 CA 인증서를 제공합니다.
  3. 업데이트된 구성을 적용하고 MCP 서버를 다시 시작하거나 재배포하여 새 [telemetry] 설정을 로드합니다.

    구성 변경 사항을 적용하는 방법에 대한 자세한 내용은 "Red Hat OpenShift용 MCP 서버에 구성 변경 사항 적용"을 참조하십시오.

검증

  • 메트릭이 OTLP 백엔드에 도달하는지 확인합니다. 서버는 30초마다 메트릭을 내보내므로 확인하기 전에 최소 시간을 허용합니다.

1.1.11. 구성 참조

Red Hat OpenShift에 대한 MCP 서버를 구성하려면 서버가 환경 변수 및 config.toml 파일에서 설정을 확인하는 방법과 이 릴리스에서 변경된 구성 옵션을 검토하십시오.

MCP Lifecycle Operator 관리 배포에서 서버는 ConfigMap 에서 마운트된 config.toml 파일(또는 민감한 값에 대한 Secret )에서 구성을 읽습니다. 구성을 변경하려면 ConfigMap 또는 시크릿 을 편집합니다. 다시 시작 없이 변경 사항이 적용되었는지 여부는 다음 "Vector changes" 테이블에 나열된 대로 옵션을 다시 로드할 수 있는지와 "시작이 필요한 항목" 섹션에 따라 달라집니다. 다시 로드(SIGHUP)를 시작한 후 다시 로드할 수 있는 옵션이 적용됩니다. 로드되지 않은 옵션을 사용하려면 서버를 다시 시작해야 합니다.

구성 변경 사항을 적용하는 방법에 대한 자세한 내용은 "Red Hat OpenShift용 MCP 서버에 구성 변경 사항 적용"을 참조하십시오.

구성의 로드 우선 순위(최고에서 가장 낮은 값)는 환경 변수( MCP_CONFIG_PATH)입니다. 그런 다음 config.toml 파일 및 기본값입니다. 명령줄 플래그는 런타임 구성이 아닌 시작(--config,--config-dir,--version)에만 사용됩니다.

환경 변수는 spec.config.env 및 spec.config.env From 을 통해 지원됩니다.

시작 구성 로깅
서버는 시작 시 유효한 구성(및 각 값이 제공된 위치)을 기록합니다.
구성 옵션 제거 및 이름 변경

OpenShift Container Platform 5.0에서 4.22와 비교하여 여러 구성 옵션이 제거되거나 이름이 변경되었습니다. 제거 또는 이름이 변경된 옵션 목록은 다음 표를 참조하십시오.

표 1.7. 제거된 CLI 플래그
삭제된 플래그교체

--port

TOML의 포트

--bind-address

bind_address

--metrics-port

metrics_port

--log-level

log_level

--log-file

log_file

--kubeconfig

kubeconfig ( kubeconfig가 비어 있을 때 KUBECONFIG가 클라이언트의 대체로 남아 있음)

--list-output

list_output

--read-only

read_only

--disable-destructive

disable_destructive

--stateless

stateless

--toolsets

툴 세트

--cluster-provider

cluster_provider_strategy

--disable-multi-cluster

cluster_provider_strategy = "disabled"

--tls-cert/--tls-key

tls_cert/tls_key

--require-tls

require_tls

숨겨진 OAuth 플래그(--require-oauth,--authorization-url, …​)

TOML 키와 일치

표 1.8. TOML 키 제거/이름 지정
레거시 설정교체

token_exchange_strategy

token_exchange.strategy

sts_audience

token_exchange.audience

sts_scopes

token_exchange.scopes

sts_subject_token_type

token_exchange.subject_token_type

sts_requested_token_type

token_exchange.requested_token_type

sts_client_id

token_exchange.client_auth.client_id

sts_client_secret

token_exchange.client_auth.client_secret

sts_auth_style

token_exchange.client_auth.method

sts_client_cert_file

token_exchange.client_auth.certificate_file

sts_client_key_file

token_exchange.client_auth.private_key_file

sts_federated_token_file

token_exchange.client_auth.token_file

표 1.9. 부트스트랩 환경 이름 변경
레거시 이름새 이름

K8S_MCP_CONFIG_PATH

MCP_CONFIG_PATH

표 1.10. 벡터 변경
TOML환경다시 로드

log_level, log_file

—

제공됨

포트,bind_address,metrics_port,stateless,disable_localhost_protection,server_instructions,apps_enabled

—

없음

list_output

—

제공됨

kubeconfig, cluster_provider_strategy

—

없음

cluster_auth_mode,denied_resources,read_only,disable_destructive,validation_enabled, experimental_enable_target_compatibility_tool_filters

—

제공됨

도구 세트,enabled_tools,disabled_tools,tool_overrides,프롬프트,confirmation_*

—

제공됨

tls_cert, tls_key, require_tls

—

없음

tls_min_version

TLS_MIN_VERSION

없음 (Inbound)

tls_cipher_suites

TLS_CIPHER_SUITES

없음 (Inbound)

http.read_header_timeout

—

없음

http.max_body_bytes, http.rate_limit_rps, http.rate_limit_burst

—

제공됨

require_oauth,oauth_*, authorization_url,skip_jwt_verification,disable_dynamic_client_registration,server_url,certificate_authority,trust_proxy_headers,token_exchange.*

—

제공됨

telemetry*

OTEL_*일치

없음

kube_client_qps, kube_client_burst

KUBE_CLIENT_QPS, KUBE_CLIENT_BURST

없음

kubeconfig_debounce_window, cluster_state_*, workspace_*

일치하는 *_MS

없음

toolset_configs

—

제공됨

cluster_provider_configs

—

없음

참고
  • 벡터가 꺼져 있음을 나타냅니다.Indicates that vector is off.
  • reload = yes는 값을 변경하는 SIGHUP을 의미합니다.
  • reload = no는 값을 변경하는 SIGHUP이 거부되고 프로세스가 종료됩니다.

1.1.12. Red Hat OpenShift의 MCP 서버에 구성 변경 적용

Red Hat OpenShift 구성의 MCP 서버 변경 사항은 자동으로 적용되지 않습니다. ConfigMap 또는 보안을 편집한 후 서버를 다시 로드하여 다시 로드할 수 있는 옵션을 적용하거나 다시 시작하여 로드할 수 없는 옵션을 적용합니다.

사전 요구 사항

  • Red Hat OpenShift용 MCP 서버가 설치되어 실행 중입니다.
  • oc CLI를 사용하여 클러스터에 액세스할 수 있습니다.
  • ConfigMap (또는 Secret)을 편집하고 MCP 서버 Pod에서 oc exec 를 실행할 수 있는 권한이 있습니다.
  • 변경 중인 구성 옵션을 다시 로드할 수 있는지 여부를 알고 있습니다("구성 참조 참조 참조 참조).

절차

  1. ConfigMap (또는 민감한 값의 시크릿 )을 편집합니다.
  2. 옵션에 따라 다음을 수행합니다.

    • 다시 로드 가능한 옵션의 경우 다시 시작하지 않도록 다음 명령을 실행하여 SIGHUP 을 보냅니다.

      oc exec [-n <namespace>] <mcp-server-pod-name> -- kill -HUP 1

      <namespace >는 MCP 서버의 네임스페이스이며 < mcp-server-pod-name >은 MCP 서버 Pod입니다.

      중요

      새 구성이 유효하지 않으면 다시 로드가 실패하고 프로세스가 종료됩니다. Pod를 재시작하지 않도록 구성이 유효한지 확인합니다.

    • 다시 로드할 수 없는 옵션의 경우 다시 시작하거나 재배포합니다.

검증

다시 로드한 후 서버는 효과적인 구성을 기록하므로 서버 로그를 확인하여 변경 사항이 로드되었는지 확인할 수 있습니다.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동