MCP Management

🔧 MCP 관리

개요

경로: 좌측 사이드바 > MCP 관리

메뉴 타입: 그룹 메뉴 (하위 메뉴 포함)

MCP(Model Context Protocol) 관리는 LLM과의 연동을 위한 MCP 서버 및 툴을 관리하는 기능입니다. MCP 서버와 도구를 등록하고 관리하여 AI 애플리케이션과의 통합을 지원합니다.

접근 방법

1. 좌측 사이드바에서 "MCP 관리" 메뉴를 클릭하여 하위 메뉴를 확장합니다
2. 확장된 하위 메뉴에서 원하는 기능을 선택합니다

💡 참고: MCP 관리는 그룹 메뉴이므로 클릭 시 하위 메뉴가 확장/축소됩니다.

하위 메뉴 구성

MCP 관리 메뉴를 클릭하면 다음 하위 메뉴들이 표시됩니다:

1. Tool 관리 - MCP Tool 목록 및 관리
2. MCP Server 관리 - MCP 서버 인스턴스 관리
3. Virtual MCP Server 관리 - 가상 MCP 서버 환경 구성
4. Metrics - MCP 관련 성능 지표 및 모니터링

---

Tool 관리

경로: 좌측 사이드바 > MCP 관리 > Tool 관리

🔧 MCP 관리

개요

경로: 좌측 사이드바 > MCP 관리

메뉴 타입: 그룹 메뉴 (하위 메뉴 포함)

MCP(Model Context Protocol) 관리는 LLM과의 연동을 위한 MCP 서버 및 툴을 관리하는 기능입니다. MCP 서버와 도구를 등록하고 관리하여 AI 애플리케이션과의 통합을 지원합니다.

접근 방법

1. 좌측 사이드바에서 "MCP 관리" 메뉴를 클릭하여 하위 메뉴를 확장합니다
2. 확장된 하위 메뉴에서 원하는 기능을 선택합니다

💡 참고: MCP 관리는 그룹 메뉴이므로 클릭 시 하위 메뉴가 확장/축소됩니다.

하위 메뉴 구성

MCP 관리 메뉴를 클릭하면 다음 하위 메뉴들이 표시됩니다:

1. Tool 관리 - MCP Tool 목록 및 관리
2. MCP Server 관리 - MCP 서버 인스턴스 관리
3. Virtual MCP Server 관리 - 가상 MCP 서버 환경 구성
4. Metrics - MCP 관련 성능 지표 및 모니터링

---

Tool 관리

경로: 좌측 사이드바 > MCP 관리 > Tool 관리

기능 설명

Tool 관리 페이지에서는 MCP Tool의 목록을 확인하고, 각 Tool의 Input Schema를 확인하며, Tool을 생성하고 관리할 수 있습니다.

페이지 구성

1. Tool 목록 섹션

등록된 MCP Tool들이 카드 형태로 표시됩니다.

Tool 카드 정보:

• Tool 이름: Tool의 이름 및 아이콘
• 생성자 정보: Tool을 생성한 사용자의 이메일 주소
• 생성 시간: Tool이 생성된 시간 (상대 시간 표시, 예: "2 hours ago")
• 상세 설명: Tool의 기능 및 용도 설명
• 공개/비공개 상태: Public 또는 Private 접근 권한 표시
• 관련 태그: Tool과 관련된 태그 목록

2. Tool 생성 버튼

• Tool 생성 또는 Add Tool 버튼을 클릭하여 새로운 Tool을 등록할 수 있습니다

주요 기능

1. Tool 목록 조회

• 등록된 모든 MCP Tool의 목록을 카드 형태로 확인할 수 있습니다
• 각 Tool의 기본 정보와 상태를 한눈에 파악할 수 있습니다

2. Tool 상세 정보 확인

• Tool 카드를 클릭하면 Tool의 상세 정보를 확인할 수 있습니다
• Input Schema: Tool의 입력 파라미터 스키마 확인
• 설명: Tool의 상세 기능 및 사용 방법 확인

3. Tool 생성

• 새로운 MCP Tool을 등록하여 AI 애플리케이션에서 사용할 수 있도록 합니다
• Tool 이름, 설명, Input Schema, 태그 등을 설정합니다

4. Tool 편집 및 삭제

• 기존 Tool의 정보를 수정하거나 삭제할 수 있습니다
• Public/Private 접근 권한을 변경할 수 있습니다

5. Tool 검색 및 필터링

• Tool 이름, 태그, 생성자 등으로 검색할 수 있습니다
• Public/Private 상태로 필터링할 수 있습니다

사용 방법

1. 좌측 사이드바에서 "MCP 관리" 메뉴를 클릭합니다
2. 하위 메뉴에서 **"Tool 관리"**를 선택합니다
3. Tool 목록에서 원하는 Tool을 확인합니다
4. Tool 카드를 클릭하여 상세 정보를 확인합니다
5. Tool 생성 버튼을 클릭하여 새로운 Tool을 등록합니다

활용 예시

예시 1: Tool 목록 확인

1. MCP 관리 > Tool 관리 메뉴로 이동
2. 등록된 Tool 목록 확인
3. 각 Tool의 이름, 생성자, 설명, 태그 확인

예시 2: Tool 상세 정보 확인

1. Tool 목록에서 원하는 Tool 카드 클릭
2. Tool의 Input Schema 확인
3. Tool의 상세 설명 및 사용 방법 확인

예시 3: 새 Tool 등록

1. Tool 생성 버튼 클릭
2. Tool 이름, 설명, Input Schema 입력
3. 태그 및 접근 권한 설정
4. 저장하여 Tool 등록 완료

주의사항

• ⚠️ Tool의 Input Schema는 JSON 형식으로 정의해야 합니다
• ⚠️ Public Tool은 모든 사용자가 사용할 수 있으며, Private Tool은 생성자만 사용할 수 있습니다
• ⚠️ Tool을 삭제하면 해당 Tool을 사용하는 모든 연결이 끊어질 수 있습니다

---

MCP Server 관리

경로: 좌측 사이드바 > MCP 관리 > MCP Server 관리

기능 설명

MCP Server 관리 페이지에서는 외부 MCP 호환 서버와의 웹소켓/SSE 연결 상태를 모니터링하고, 새로운 MCP 서버 엔드포인트를 등록하고 관리할 수 있습니다.

페이지 구성

1. Server 목록 섹션

등록된 MCP 서버 목록이 테이블 또는 카드 형태로 표시됩니다.

Server 정보:

• Server 이름: MCP 서버의 이름
• 엔드포인트 URL: 서버의 웹소켓 또는 SSE 엔드포인트 주소
• 연결 상태: 연결됨(Connected) / 연결 안 됨(Disconnected) / 오류(Error)
• 연결 타입: WebSocket 또는 SSE (Server-Sent Events)
• 마지막 연결 시간: 서버와 마지막으로 연결된 시간
• 액션: 연결 테스트, 설정 변경, 삭제 등

2. Server 추가 버튼

• Add Server 또는 서버 추가 버튼을 클릭하여 새로운 MCP 서버를 등록할 수 있습니다

주요 기능

1. Server 목록 조회

• 등록된 모든 MCP 서버의 목록과 연결 상태를 확인할 수 있습니다
• 각 서버의 엔드포인트와 연결 타입을 확인할 수 있습니다

2. Server 연결 상태 모니터링

• 실시간으로 서버의 연결 상태를 확인할 수 있습니다
• 연결 상태가 변경되면 자동으로 업데이트됩니다

3. Server 등록

• 새로운 MCP 서버 엔드포인트를 등록합니다
• 서버 이름, 엔드포인트 URL, 연결 타입(WebSocket/SSE) 등을 설정합니다

4. Server 연결 테스트

• 등록된 서버와의 연결을 테스트하여 정상 작동 여부를 확인합니다
• 연결 실패 시 오류 메시지를 확인할 수 있습니다

5. Server 설정 변경 및 재시작

• 서버의 설정을 변경하거나 연결을 재시작할 수 있습니다
• 서버를 삭제할 수 있습니다

사용 방법

1. 좌측 사이드바에서 "MCP 관리" 메뉴를 클릭합니다
2. 하위 메뉴에서 **"MCP Server 관리"**를 선택합니다
3. Server 목록에서 등록된 서버들의 연결 상태를 확인합니다
4. Add Server 버튼을 클릭하여 새로운 서버를 등록합니다
5. 서버 정보 입력:
   • Server 이름
   • 엔드포인트 URL (예: ws://example.com/mcp 또는 https://example.com/mcp/sse)
   • 연결 타입 (WebSocket 또는 SSE)
6. 연결 테스트 버튼을 클릭하여 연결을 확인합니다
7. 저장하여 서버 등록을 완료합니다

활용 예시

예시 1: Server 목록 확인

1. MCP 관리 > MCP Server 관리 메뉴로 이동
2. 등록된 서버 목록 확인
3. 각 서버의 연결 상태 확인 (연결됨/연결 안 됨)

예시 2: 새 Server 등록

1. Add Server 버튼 클릭
2. Server 이름 입력 (예: "My MCP Server")
3. 엔드포인트 URL 입력 (예: wss://mcp.example.com/ws)
4. 연결 타입 선택 (WebSocket 또는 SSE)
5. 연결 테스트 버튼으로 연결 확인
6. 저장하여 서버 등록 완료

예시 3: Server 연결 상태 모니터링

1. Server 목록에서 연결 상태 확인
2. 연결 안 됨 상태인 서버의 연결 테스트 버튼 클릭
3. 오류 메시지 확인 및 문제 해결

주의사항

• ⚠️ MCP 서버는 WebSocket 또는 SSE 프로토콜을 지원해야 합니다
• ⚠️ 서버 엔드포인트 URL은 유효한 주소여야 하며, 접근 가능해야 합니다
• ⚠️ 연결이 끊어진 서버는 Tool을 사용할 수 없습니다
• ⚠️ 서버를 삭제하면 해당 서버와 연결된 모든 Tool 연결이 끊어집니다

---

Virtual MCP Server 관리

경로: 좌측 사이드바 > MCP 관리 > Virtual MCP Server 관리

기능 설명

Virtual MCP Server 관리 페이지에서는 가상 MCP 서버 환경을 구성하고 관리할 수 있습니다. 테스트 환경이나 개발 환경에서 MCP 서버를 시뮬레이션하거나 가상 서버를 생성하여 사용할 수 있습니다.

페이지 구성

1. Virtual Server 목록 섹션

생성된 가상 MCP 서버 목록이 표시됩니다.

Virtual Server 정보:

• Server 이름: 가상 서버의 이름
• 상태: 실행 중(Running) / 중지됨(Stopped) / 일시 중지됨(Paused)
• 생성 시간: 가상 서버가 생성된 시간
• 설정 정보: 가상 서버의 구성 정보
• 액션: 시작, 중지, 설정 변경, 삭제 등

2. Virtual Server 생성 버튼

• Create Virtual Server 또는 가상 서버 생성 버튼을 클릭하여 새로운 가상 서버를 생성할 수 있습니다

주요 기능

1. Virtual Server 목록 조회

• 생성된 모든 가상 MCP 서버의 목록과 상태를 확인할 수 있습니다

2. Virtual Server 생성

• 새로운 가상 MCP 서버를 생성합니다
• 서버 이름, 설정, 환경 변수 등을 구성합니다

3. Virtual Server 시작/중지

• 가상 서버를 시작하거나 중지할 수 있습니다
• 서버 상태를 제어할 수 있습니다

4. Virtual Server 설정 변경

• 가상 서버의 설정을 변경할 수 있습니다
• 환경 변수, 리소스 할당 등을 조정할 수 있습니다

5. 테스트 환경 구성

• 개발 및 테스트를 위한 가상 서버 환경을 구성할 수 있습니다
• 실제 서버 없이 MCP 기능을 테스트할 수 있습니다

사용 방법

1. 좌측 사이드바에서 "MCP 관리" 메뉴를 클릭합니다
2. 하위 메뉴에서 **"Virtual MCP Server 관리"**를 선택합니다
3. Virtual Server 목록에서 생성된 서버들을 확인합니다
4. Create Virtual Server 버튼을 클릭하여 새로운 가상 서버를 생성합니다
5. 서버 정보 입력:
   • Server 이름
   • 설정 정보
   • 환경 변수 (필요한 경우)
6. 저장하여 가상 서버 생성 완료
7. 시작 버튼을 클릭하여 서버를 시작합니다

활용 예시

예시 1: Virtual Server 생성

1. MCP 관리 > Virtual MCP Server 관리 메뉴로 이동
2. Create Virtual Server 버튼 클릭
3. Server 이름 입력 (예: "Test MCP Server")
4. 설정 정보 구성
5. 저장하여 가상 서버 생성 완료

예시 2: Virtual Server 제어

1. Virtual Server 목록에서 원하는 서버 선택
2. 시작 버튼으로 서버 시작
3. 서버 상태가 "Running"으로 변경되는지 확인
4. 중지 버튼으로 서버 중지

주의사항

• ⚠️ Virtual Server는 테스트 및 개발 목적으로 사용됩니다
• ⚠️ Virtual Server의 리소스는 제한될 수 있습니다
• ⚠️ Virtual Server를 삭제하면 해당 서버의 모든 데이터가 삭제됩니다

---

Metrics

경로: 좌측 사이드바 > MCP 관리 > Metrics

기능 설명

Metrics 페이지에서는 MCP 관련 성능 지표와 리소스 사용량을 모니터링할 수 있습니다. 서버 상태, Tool 사용량, 연결 상태 등의 메트릭을 확인할 수 있습니다.

페이지 구성

1. 메트릭 대시보드

주요 성능 지표가 카드 또는 차트 형태로 표시됩니다.

주요 메트릭:

• 서버 상태: 연결된 MCP 서버 수 및 상태
• Tool 사용량: Tool 호출 횟수 및 사용 통계
• 연결 상태: 활성 연결 수 및 연결 풀 상태
• 응답 시간: 평균 응답 시간 및 지연 시간
• 에러율: 에러 발생 횟수 및 에러율
• 리소스 사용량: CPU, 메모리, 네트워크 사용량

2. 시간 범위 선택

• 메트릭을 조회할 시간 범위를 선택할 수 있습니다
• 예: 최근 1시간, 최근 24시간, 최근 7일 등

3. 필터 옵션

• 특정 서버, Tool, 프로젝트 등으로 필터링할 수 있습니다

주요 기능

1. 실시간 메트릭 모니터링

• 실시간으로 MCP 관련 성능 지표를 확인할 수 있습니다
• 서버 상태, Tool 사용량 등을 실시간으로 모니터링합니다

2. 성능 지표 확인

• 응답 시간, 처리량, 에러율 등의 성능 지표를 확인할 수 있습니다
• 차트를 통해 시간에 따른 변화를 시각적으로 확인할 수 있습니다

3. 리소스 사용량 모니터링

• CPU, 메모리, 네트워크 등의 리소스 사용량을 확인할 수 있습니다
• 리소스 사용량이 높은 서버나 Tool을 식별할 수 있습니다

4. 에러 및 경고 확인

• 에러 발생 횟수와 에러율을 확인할 수 있습니다
• 경고 및 알림을 확인할 수 있습니다

5. 메트릭 내보내기

• 메트릭 데이터를 CSV, JSON 등으로 내보낼 수 있습니다
• 리포트 생성 및 공유가 가능합니다

사용 방법

1. 좌측 사이드바에서 "MCP 관리" 메뉴를 클릭합니다
2. 하위 메뉴에서 **"Metrics"**를 선택합니다
3. 메트릭 대시보드에서 주요 지표를 확인합니다
4. 시간 범위를 선택하여 원하는 기간의 메트릭을 조회합니다
5. 필터 옵션을 사용하여 특정 서버나 Tool의 메트릭만 확인합니다
6. 차트를 통해 성능 추이를 분석합니다

활용 예시

예시 1: 전체 메트릭 확인

1. MCP 관리 > Metrics 메뉴로 이동
2. 메트릭 대시보드에서 전체 지표 확인
3. 서버 상태, Tool 사용량, 응답 시간 등 확인

예시 2: 특정 기간 메트릭 분석

1. 시간 범위 선택 (예: 최근 24시간)
2. 성능 지표 차트 확인
3. 응답 시간 추이, 에러율 변화 등 분석

예시 3: 리소스 사용량 모니터링

1. 리소스 사용량 섹션 확인
2. CPU, 메모리 사용량이 높은 서버 식별
3. 필요시 서버 리소스 조정

주의사항

• ⚠️ 메트릭 데이터는 일정 기간 후 자동으로 삭제될 수 있습니다
• ⚠️ 실시간 메트릭은 약간의 지연이 있을 수 있습니다
• ⚠️ 메트릭 데이터는 서버 상태에 따라 정확도가 달라질 수 있습니다

활용 팁

• 💡 정기적인 모니터링: 성능 문제를 조기에 발견하기 위해 정기적으로 메트릭을 확인하세요
• 💡 알림 설정: 특정 임계값을 초과할 때 알림을 받도록 설정할 수 있습니다
• 💡 트렌드 분석: 시간에 따른 메트릭 변화를 분석하여 용량 계획을 수립하세요