> For the complete documentation index, see [llms.txt](https://genos-docs.gitbook.io/default/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://genos-docs.gitbook.io/default/v1.9.1/basic-tutorials/guides/mcp/mcp-tool-catalog.md).
# MCP 도구 카탈로그
## 개요
MCP 도구 카탈로그는 사내 리소스 마켓플레이스인 통합 카탈로그에서 **MCP 도구**를 공유하고 재사용하는 기능입니다. 기존 카탈로그가 프롬프트·모델·워크플로우·전처리기·평가지표 5종을 다뤘다면, v1.9.0부터는 MCP 도구도 소유자가 특정 리비전을 동결해 게시하고 다른 사용자가 그 카탈로그를 자신의 MCP 도구로 복제해 사용할 수 있습니다.
**도구 > MCP 도구** 목록 우상단의 `카탈로그 보기` 버튼을 누르면 오른쪽에 카탈로그 패널이 열립니다. 카드를 클릭하면 읽기 전용 카탈로그 상세로 이동하고, 게시(등록 신청)는 원본 MCP 도구 상세 화면에서 진행합니다.
MCP 도구 목록 우상단 '카탈로그 보기' 버튼으로 연 카탈로그 패널
이 문서는 MCP 도구 고유의 흐름에 집중합니다.
* 등록·승인·평점·게시 해제 등 리소스 공통 동작은 [카탈로그](/default/v1.9.1/basic-tutorials/guides/catalog.md) 문서를 참고하세요.
* MCP 도구 자체를 만들고 서버에 배포하는 방법은 [MCP 도구/ 서버 만들기](https://github.com/genonai/genos-docs/tree/v1.9.1/basic-tutorials/guides/mcp/mcp-tool-server.md) 문서를 참고하세요.
## 주요 개념
| 개념 | 설명 |
| -------- | ---------------------------------------------------------------------------------------- |
| MCP 도구 | MCP(Model Context Protocol) 도구 리소스입니다. 도구 본체(이름·설명)와 리비전(코드·입력 스키마·환경 변수·행위 유형)으로 구성됩니다. |
| 리비전 | 도구의 코드·환경 변수·PyPI 패키지·행위 유형을 담는 버전 단위입니다. 중요 정보를 수정해 저장할 때마다 새 리비전이 생성됩니다. |
| 행위 유형 | 도구가 데이터를 어떻게 다루는지 나타내는 분류입니다. 조회 / 변경 / 삭제 / 미분류 중 하나로 표시됩니다. |
| 리비전 동결 | 카탈로그 등록을 신청한 시점의 리비전을 고정하는 것입니다. 원본 도구를 이후에 수정해도 카탈로그는 동결된 리비전을 그대로 유지합니다. |
| 복제(사용하기) | 게시된 카탈로그를 자신의 MCP 도구로 가져오는 것입니다. 새 도구로 만들거나 기존 도구에 리비전을 추가하는 두 가지 방식이 있습니다. |
| 복제 수 | 카탈로그가 복제된 횟수입니다. 복제가 일어날 때마다 이력이 기록되고 카드에 표시되는 복제 수가 증가합니다. |
## 진입 경로
* **카탈로그 탐색**: 도구 > MCP 도구 목록 우상단 `카탈로그 보기` 버튼을 누르면 오른쪽 사이드 패널이 열립니다. 이 버튼은 권한과 무관하게 항상 표시됩니다.
* **카탈로그 상세**: 패널의 카드를 클릭하면 읽기 전용 카탈로그 상세 화면으로 이동합니다.
* **카탈로그 등록**: 도구 > MCP 도구 > 상세 화면에서 신청합니다. **목록 화면에는 등록 버튼이 없습니다.**
## MCP 도구를 카탈로그에 게시하기 (소유자)
MCP 도구 소유자는 **원본 도구의 상세 화면**에서 카탈로그 등록을 신청합니다. 등록 관련 버튼은 원본 도구에 대한 수정 권한이 있을 때만 표시됩니다.
1. MCP 도구 상세 우상단의 `+ 카탈로그 등록` 버튼을 누르면 `MCP 도구 카탈로그 등록 신청` 창이 열립니다.
2. `제목`(기본값은 도구명)과 `상세 설명`을 입력합니다.
3. `리비전` 드롭다운에서 **동결할 리비전**을 선택합니다. 이 시점에 선택한 리비전의 코드·환경 변수·패키지·행위 유형이 카탈로그에 고정됩니다.
4. `예`를 누르면 등록 신청이 생성되고, 상태가 승인 대기로 바뀝니다.
5. 관리자가 승인하면 카탈로그에 게시되어 다른 사용자에게 노출됩니다.
MCP 도구 상세의 '카탈로그 등록' 버튼과 등록 신청 창 (제목·상세 설명·동결할 리비전 선택)
원본 상세 화면의 버튼은 현재 카탈로그 상태에 따라 다음과 같이 바뀝니다.
| 카탈로그 상태 | 표시되는 버튼 | 비고 |
| --------------- | ------------ | ----------------------------- |
| 미등록 · 반려됨 · 취소됨 | `+ 카탈로그 등록` | 새로 등록을 신청할 수 있습니다. |
| 승인 대기 | `카탈로그 신청 취소` | 승인 전까지 신청을 취소할 수 있습니다. |
| 게시 중 | `카탈로그 해제` | `Go To Catalog` 버튼이 함께 표시됩니다. |
| 해제 승인 대기 | `해제 신청 취소` | 해제 승인 전까지 신청을 취소할 수 있습니다. |
### 게시 중 유의 사항
* 게시 중이거나 등록·해제 신청이 진행 중인 도구는 **삭제할 수 없습니다.** 삭제 아이콘이 비활성화되며 마우스를 올리면 사유가 안내됩니다. 삭제하려면 먼저 카탈로그를 해제하거나 신청을 취소하세요.
* 같은 도구의 같은 리비전으로 이미 진행 중인 신청이 있으면 중복 신청이 차단됩니다. 기존 신청을 취소하거나 다른 리비전을 선택해 신청하세요.
## 카탈로그 탐색과 복제 (사용자)
MCP 도구 목록에서 `카탈로그 보기`를 누르면 카탈로그 패널이 열립니다. 패널에는 **게시 중인 카탈로그만**, **현재 활성 워크스페이스 범위**로 표시됩니다.
1. 검색 필드를 선택하고 검색어를 입력합니다.
2. 정렬 기준을 선택합니다. 기본값은 `최신 등록순`입니다.
3. 아래로 스크롤하면 다음 항목이 이어서 로드됩니다.
4. 카드의 `MCP 도구 설정값`을 펼쳐 내용을 미리 확인합니다.
5. 카드를 클릭해 읽기 전용 카탈로그 상세로 들어갑니다.
6. `사용` 버튼을 눌러 자신의 MCP 도구로 복제합니다.
### 검색·정렬 기준
| 구분 | 선택할 수 있는 값 |
| ----- | -------------------------------- |
| 검색 필드 | 이름(기본) · 설명 · 생성자 |
| 정렬 | 최신 등록순(기본) · 등록 오래된순 · 평점순 · 복제순 |
### 카탈로그 카드에서 설정값 미리 보기
카드 헤더에는 복제 수와 평균 평점·평점 개수가 표시되고, 그 아래에 관리 그룹·생성자·생성일시·카탈로그 등록일시가 나옵니다.
`MCP 도구 설정값` 오른쪽의 `펼치기`를 누르면 동결된 리비전의 정보를 읽기 전용으로 확인할 수 있습니다. 다시 접으려면 `접기`를 누릅니다.
| 항목 | 내용 |
| ----- | ----------------------------------------------------------- |
| 행위 유형 | 조회 / 변경 / 삭제 / 미분류 배지 |
| 패키지 | 동결된 리비전이 사용하는 PyPI 패키지 목록입니다. 없으면 `-`로 표시됩니다. |
| 코드 | 동결된 리비전의 Python 코드입니다. 읽기 전용으로 표시됩니다. |
| 환경 변수 | 동결된 리비전의 환경 변수를 `키 = 값` 형태로 보여줍니다. 비밀 값으로 지정된 항목은 값이 가려집니다. |
카탈로그 카드의 'MCP 도구 설정값'을 펼친 화면 (행위 유형·패키지·코드·환경 변수)
### 카탈로그 상세 (읽기 전용)
카탈로그 상세 화면은 원본 도구가 아니라 카탈로그에 게시된 내용만으로 구성되므로, 원본 도구에 대한 권한이 없는 사용자도 열람할 수 있습니다. 화면 전체가 읽기 전용이며 `기본 정보`·`중요 정보` 두 개의 탭으로 구성됩니다.
`기본 정보` 탭에는 제작자·관리 그룹·등록일시·카탈로그 게시일·복제 수·카탈로그 게시 버전·원본 MCP 도구·제목·상세 설명이 표시됩니다.
상단 액션은 카탈로그가 게시 중일 때만 표시됩니다.
| 액션 | 표시 조건 |
| -------------------- | --------------------------------------------------------------- |
| 평점(별 아이콘) | 게시 중인 카탈로그 |
| `사용` | 게시 중인 카탈로그 |
| `해제 신청` / `해제 신청 취소` | 게시 중이면서 원본 도구에 대한 수정 권한이 있는 경우. 해제 승인 대기 상태이면 `해제 신청 취소`로 바뀝니다. |
### 복제(사용하기)
`사용` 버튼을 누르면 `MCP 도구 사용하기` 창이 열립니다. 상단 탭에서 복제 방식을 선택합니다.
| 방식 | 입력 항목 | 결과 |
| ------------- | ------------------------------------------ | ---------------------------------- |
| 새 MCP 도구 생성 | `새 MCP 도구 제목`(기본값 `{도구명} (복사본)`) · `관리 그룹` | 새 MCP 도구가 생성되고 해당 도구 상세로 이동합니다. |
| 기존 MCP 도구에 추가 | 대상 MCP 도구 선택 | 선택한 도구에 리비전이 추가되고 해당 도구 상세로 이동합니다. |
`복제하기`를 누르면 복제가 실행됩니다. 코드·행위 유형·PyPI 패키지·환경 변수·입력 스키마는 동결된 리비전에서 그대로 복사됩니다.
'MCP 도구 사용하기' 창 — 새 MCP 도구 생성 / 기존 MCP 도구에 추가 탭
* 복제된 MCP 도구는 원본 카탈로그와 분리되어 관리되므로, 본인의 목록에서 자유롭게 수정할 수 있습니다.
* `기존 MCP 도구에 추가`에서는 본인이 수정할 수 있는 도구만 선택 목록에 나오며, 이름으로 검색할 수 있습니다.
* 복제가 완료되면 결과 도구의 상세 화면으로 이동하고, 원본 카탈로그의 복제 수가 증가합니다.
## 리비전과 행위 유형
### 리비전 상세에서 확인하기
리비전 상세 창은 해당 리비전 시점의 정보를 읽기 전용으로 보여줍니다.
* **행위 유형**: 상단에 배지로 표시됩니다. 설정하지 않았다면 `미분류`로 표시됩니다.
* **환경 변수**: 해당 리비전에 저장된 환경 변수 목록입니다.
* **패키지**와 **코드**도 함께 읽기 전용으로 표시됩니다.
### 행위 유형 설정 위치
행위 유형은 리비전 단위 속성이므로 **중요 정보 탭**에서 설정합니다. 중요 정보 탭의 **패키지 영역 위**에서 조회 / 변경 / 삭제 / 미분류 중 하나를 선택하며, 저장하면 코드·PyPI 패키지·환경 변수와 함께 하나의 리비전으로 저장됩니다.
기본 정보 탭에는 행위 유형 항목이 없습니다. 기본 정보 탭의 저장은 이름과 설명만 반영합니다.
### 저장 시 유의 사항
중요 정보를 수정해 저장하면 새 리비전이 생성됩니다. 이때 항목별로 이전 리비전 값의 승계 여부가 다릅니다.
| 항목 | 새 리비전 저장 시 동작 |
| ----- | ---------------------------------------------------------------------- |
| 환경 변수 | 이번에 변경하지 않은 항목은 이전 리비전 값을 그대로 이어받습니다. |
| 행위 유형 | 저장 시점에 선택된 값이 그대로 저장됩니다. 값이 비어 있으면 미분류로 초기화되며 이전 리비전에서 자동으로 이어받지 않습니다. |
화면에서 중요 정보 탭을 통해 저장하는 경우에는 행위 유형이 항상 함께 저장되므로 값이 유지됩니다. 저장 후 행위 유형이 `미분류`로 바뀌어 보인다면, 중요 정보 탭에서 원하는 행위 유형을 다시 선택하고 저장하세요.
## 사용자 시나리오
### 시나리오 1 — MCP 도구를 카탈로그에 게시하기 (소유자)
도구 > MCP 도구 > 상세에서 `+ 카탈로그 등록`을 눌러 제목·상세 설명과 동결할 리비전을 선택하면 등록 신청이 생성되고, 버튼이 `카탈로그 신청 취소`로 바뀝니다. 관리자가 승인하면 카탈로그에 게시되며, 상세 화면에는 `카탈로그 해제`와 `Go To Catalog` 버튼이 표시됩니다.
### 시나리오 2 — 카탈로그를 탐색해 복제하기 (사용자)
MCP 도구 목록에서 `카탈로그 보기`로 패널을 열고 이름·설명·생성자로 검색한 뒤 정렬합니다. 카드의 `MCP 도구 설정값`을 펼쳐 행위 유형·패키지·코드·환경 변수를 미리 확인하고, 카드를 클릭해 읽기 전용 상세로 들어갑니다. `사용`을 누르면 새 도구로 복제하거나 기존 도구에 리비전을 추가할 수 있습니다. 복제가 끝나면 결과 도구 상세로 이동하고 원본 카탈로그의 복제 수가 증가합니다.
### 시나리오 3 — 행위 유형을 설정하고 저장하기
MCP 도구 상세의 중요 정보 탭에서 코드·PyPI 패키지·환경 변수와 함께 행위 유형(조회 / 변경 / 삭제 / 미분류)을 선택해 저장하면 새 리비전이 생성됩니다. 이후 이 리비전을 동결해 카탈로그에 등록하면, 다른 사용자가 카드에서 해당 도구의 행위 유형을 바로 확인할 수 있습니다.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://genos-docs.gitbook.io/default/v1.9.1/basic-tutorials/guides/mcp/mcp-tool-catalog.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.