MCP 도구
MCP 도구에서는 Orchestrator가 연결된 MCP 서버에서 발견한 도구와 모델에 노출되는 공개 이름을 확인합니다. 도구가 목록에 없거나 모델이 잘못된 도구를 선택할 때 카탈로그와 스키마를 점검하는 화면입니다.
개요
서버 카탈로그의 도구는 공개 도구 이름, 설명과 입력 스키마로 변환되어 모델에 전달됩니다. 동일한 이름이 여러 서버에서 충돌하지 않도록 공개 이름과 원본 서버를 함께 확인해야 합니다.
도구 목록 확인
- 카탈로그 갱신 시각과 연결된 MCP 서버를 확인합니다.
- 필요한 도구의 공개 이름을 검색합니다.
- 원본 서버와 실제 도구 이름을 확인합니다.
- 설명이 모델이 이해할 만큼 구체적인지 확인합니다.
- 필수 입력과 JSON 스키마를 확인합니다.
- 정책 상태와 사용 가능 범위를 확인합니다.
목록 항목
| 항목 | 설명 |
|---|---|
| Public tool name | 모델에 노출되는 고유 이름입니다. |
| Server | 도구를 제공하는 MCP 서버입니다. |
| Description | 모델이 도구 선택에 사용하는 기능 설명입니다. |
| Input schema | 호출에 필요한 필드, 형식과 필수 여부입니다. |
| Risk level | 읽기, 쓰기, 파괴 또는 미상 위험으로 구분합니다. |
| Enabled | 현재 카탈로그와 정책에서 사용할 수 있는지 나타냅니다. |
도구가 보이지 않을 때
MCP 서버 주소와 연결 상태를 확인하고 카탈로그를 다시 불러옵니다. 서버가 도구를 반환해도 이름이나 입력 스키마가 잘못되면 모델 노출에서 제외될 수 있습니다. 시작 시 카탈로그 warm-up 로그의 도구 수와 서버 목록을 함께 확인하십시오.
안전한 도구 설명
설명에는 수행 작업, 대상 데이터와 변경 여부가 드러나야 합니다. 조회 도구를 수정 도구처럼 설명하거나 쓰기 도구의 영향을 숨기면 정책과 승인 판단이 잘못될 수 있습니다. 입력 스키마에는 tenantId 같은 격리 키와 필수 식별자를 명확히 정의합니다.
변경 검증
- 시험 테넌트에서 읽기 전용 도구를 호출합니다.
- 요청 인수와 반환 형식을 확인합니다.
- 쓰기 도구는 승인 요청이 나타나는지 확인합니다.
- 파괴적 도구는 자동 실행되지 않는지 확인합니다.
- 턴 검사기에서 선택된 도구와 정책 근거를 확인합니다.
관련 작업
- MCP 정책에서 위험 수준별 결정을 확인합니다.
- Function Call 구성에서 비 MCP 함수의 스키마와 승인 여부를 관리합니다.
- MCP 진단에서 실제 서버 카탈로그와 호출 경로를 검증합니다.