전체 도구 카탈로그¶
synapse-mcp 가 제공하는 도구 98개를 온톨로지 카테고리별로 정리했습니다. 각 도구명을 클릭하면 카테고리 페이지의 상세 설명(언제 부르는지 · 안전장치 · 관련 도구)으로 이동합니다. 도구가 왜 이렇게 조직돼 있는지는 Synapse 온톨로지를 보세요.
구분 범례 — 읽기: 조회 전용 · ✏️ 쓰기: 변경 도구(기본 dry-run 미리보기 → confirm=true 확정) ·
⚠️ 파괴적: 삭제/덮어쓰기/중지 등 되돌리기 어려운 변경(2단계 confirm, 일부는 이름 재확인 요구).
🔑 계정 · 워크스페이스¶
모든 기능의 전제 게이트 — 로그인 → 워크스페이스 선택, 멤버·역할 관리. → 카테고리 페이지
| 도구 | 용도 | 구분 |
|---|---|---|
ping |
서버 헬스 체크 — 'pong' 반환. | 읽기 |
login |
이메일/비밀번호로 현재 환경에 로그인한다. 다음 단계는 워크스페이스 선택. | ✏️ 쓰기 |
whoami |
인증된 사용자 본인의 식별 정보를 반환한다. | 읽기 |
current_environment |
현재 활성 환경 이름 + base_url 을 반환한다. | 읽기 |
list_workspaces |
사용자가 속한 워크스페이스 목록 조회(환경별 캐시, refresh=True 로 갱신). |
읽기 |
select_workspace |
활성 워크스페이스를 선택한다 — 기능 사용 전 필수 게이트. | ✏️ 쓰기 |
current_workspace |
현재 활성 워크스페이스 code 를 반환한다. | 읽기 |
list_members |
워크스페이스 멤버 목록 — 구성원과 역할(role) 확인. | 읽기 |
get_member |
멤버 1건 상세 — 목록의 id 로 조회. | 읽기 |
manage_members |
멤버 역할 변경/제거(action=update_role|remove) — 권한 서열은 서버가 판단. | ✏️ 쓰기 |
🏭 데이터 준비 · 업로드¶
Workforce 척추 앞부분 — 컬렉션(그릇) → 업로드(2단계) → 데이터유닛. → 카테고리 페이지
| 도구 | 용도 | 구분 |
|---|---|---|
list_data_collections |
데이터 컬렉션(원천 데이터 묶음) 목록 — name 은 페이지 내 부분일치 필터. |
읽기 |
get_data_collection |
데이터 컬렉션 1건 상세. | 읽기 |
create_data_collection |
컬렉션 생성 — category 만 고르면 파일 스펙 자동 합성, 필요하면 직접 지정(메타 사양 포함). | ✏️ 쓰기 |
update_data_collection |
컬렉션 name/description 수정 · 파일 사양 추가(병합, 삭제 없음). | ✏️ 쓰기 |
delete_data_collection |
컬렉션 삭제. | ⚠️ 파괴적 |
list_data_units |
데이터 유닛(컬렉션 내 개별 데이터 항목) 목록. | 읽기 |
get_data_unit |
데이터 유닛 1건 상세. | 읽기 |
get_file_specifications |
카테고리별 파일 스펙·허용 확장자·검증 규칙 조회 — "파일 스펙에 맞춘 정리 후 업로드"의 전제. | 읽기 |
prepare_data_upload |
업로드 1단계 — presigned URL 발급(파일 바이트는 호스트가 직접 PUT). | ✏️ 쓰기 |
finalize_data_upload |
업로드 2단계 — 확정 + 데이터유닛 생성(동일 구성은 멱등 재사용). | ✏️ 쓰기 |
create_tasks_from_units |
데이터유닛으로 작업 일괄 생성 — 이미 작업 있는 유닛은 건너뜀. | ✏️ 쓰기 |
🏭 프로젝트 · 라벨링¶
척추 중간 — 프로젝트(규칙) → 태스크 → 라벨링 스키마·내용 렌즈. → 카테고리 페이지
| 도구 | 용도 | 구분 |
|---|---|---|
list_projects |
프로젝트 목록 — name 은 페이지 내 부분일치 필터. |
읽기 |
get_project |
프로젝트 1건 상세 — 설정·상태 확인. | 읽기 |
create_project |
프로젝트 생성 — title + category 만으로 시작 가능. 작업을 만들 거면 data_collection 필수(생성 시에만 지정 가능). |
✏️ 쓰기 |
update_project |
프로젝트 title/description 수정. | ✏️ 쓰기 |
delete_project |
프로젝트 삭제. | ⚠️ 파괴적 |
get_annotation_configurations |
프로젝트 configuration 구성에 필요한 annotation/widget type·검증 규칙 조회. | 읽기 |
get_labeling_schema |
🔍 렌즈 — 라벨링 스키마(클래스→속성→옵션 트리) 조회. | 읽기 |
list_tasks |
태스크(프로젝트×데이터유닛 단위 작업) 목록. | 읽기 |
get_task |
태스크 1건 상세. | 읽기 |
get_task_data |
🔍 렌즈 — 어노테이션 내용을 클래스 히스토그램 + 항목 표로 요약(mode='detail' 로 속성값 포함). |
읽기 |
find_tasks_by_class |
🔗 워크플로 — 특정 라벨링 클래스를 사용한 task 검색(청크 스캔, 커서로 이어보기). | 읽기 |
manage_project_tags |
task 분류용 프로젝트 태그 조회/생성/수정/삭제 — category 는 생성 후 불변. | ✏️ 쓰기 |
annotate_task_data |
태스크 어노테이션 데이터를 저장/제출(action=save|submit) — 산출물 덮어쓰기 주의. | ⚠️ 파괴적 |
🏭 워크샵 · 할당 · 검수¶
척추 뒷부분 — 사람 배치 → 할당작업 → 제출/승인/반려 · 검수 이력. → 카테고리 페이지
| 도구 | 용도 | 구분 |
|---|---|---|
manage_workshop |
워크샵 생성/수정/삭제/참여 — 할당 단위·검수 사용 여부는 생성 후 불변. | ✏️ 쓰기 |
manage_workshop_workers |
워크샵 작업자 배정 조회/추가/수정/제거 — "누가 일할 수 있는지"만 다룸. | ✏️ 쓰기 |
manage_reviewer_covers |
워크샵 검수자 커버 배정 조회/추가/수정/제거(can_self_review 포함). |
✏️ 쓰기 |
list_assignments |
할당작업 목록 — 작업 진행·상태 확인. | 읽기 |
get_assignment |
할당작업 1건 상세. | 읽기 |
submit_assignment |
할당작업 제출(작업자 역할) — 상태전환. | ✏️ 쓰기 |
approve_assignment |
할당작업 승인(검수자 역할) — 상태전환. | ✏️ 쓰기 |
reject_assignment |
할당작업 반려(검수자 역할) — 상태전환. | ✏️ 쓰기 |
update_assignment_data |
할당작업의 어노테이션 데이터 정정 — 상태전환 아님, 덮어쓰기 주의. | ⚠️ 파괴적 |
list_reviews |
검수 목록 — 반려/코멘트 이력 확인. | 읽기 |
get_review |
검수 1건 상세. | 읽기 |
update_review |
검수 코멘트/태그 정정 — 승인/반려 상태전환 아님. | ✏️ 쓰기 |
manage_review_tags |
검수 반려 사유 태그 조회/생성/수정/삭제 — task 분류 태그와 별개. | ✏️ 쓰기 |
inspect_labeling |
🔗 워크플로 — 어노테이션을 스키마와 대조한 검수 리포트(분포·미정의 코드·누락·중복). | 읽기 |
🏭 현황 · 통계 · 게시판¶
운영 시야 — 진행률·멤버별 현황·정식 통계 4종 + 공지/문의·FAQ. → 카테고리 페이지
| 도구 | 용도 | 구분 |
|---|---|---|
get_project_progress |
프로젝트 진행률 요약 — 라벨링·검수 완료율과 반려율을 한눈에. | 읽기 |
get_project_member_breakdown |
멤버별 진행 현황 — 작업자/검수자 각각의 담당량·완료·검수중·반려 건수. | 읽기 |
get_project_statistics |
정식 통계 4종(worker/class/rejection/defect) 조회 — 진행률 요약과 역할이 다름. | 읽기 |
list_posts |
게시글 목록 — 공지 + 본인 작성 글. | 읽기 |
get_post |
게시글 1건 상세(조회수 증가). | 읽기 |
list_post_categories |
게시판 카테고리 목록(board=notice|inquiry). | 읽기 |
manage_board |
게시글(공지/가이드) 생성/수정/삭제. | ✏️ 쓰기 |
list_faqs |
FAQ 목록 — 카테고리·검색으로 좁히기. | 읽기 |
list_notifications |
내 알림 목록 + 읽지 않은 개수 — 서버 필터 없어 페이지 단위로 훑음. | 읽기 |
get_notification |
알림 1건 상세 — 본문·연관 데이터·읽은 시각. 조회로 읽음 처리되지 않음. | 읽기 |
manage_notifications |
알림 읽음/안읽음 처리 — mark_read·mark_unread·mark_all_read. | ✏️ 쓰기 |
🧠 학습데이터(정답셋)¶
두 축의 봉합점 — 학습 적격 게이트 → 정답셋(GT) → 학습데이터 버전. → 카테고리 페이지
| 도구 | 용도 | 구분 |
|---|---|---|
check_training_eligibility |
🔗 워크플로 — 할당작업의 학습 적격(qualifiesForTraining)을 항별 평가. 정답셋에 넣기 전 게이트. | 읽기 |
list_ground_truth_datasets |
정답셋(컨테이너) 목록. | 읽기 |
get_ground_truth_dataset |
정답셋 1건 상세. | 읽기 |
create_ground_truth_dataset |
정답셋 생성. | ✏️ 쓰기 |
update_ground_truth_dataset |
정답셋 name/description 수정. | ✏️ 쓰기 |
delete_ground_truth_dataset |
정답셋 삭제. | ⚠️ 파괴적 |
list_ground_truths |
정답셋 개별 항목 목록 — classes 서버 필터로 클래스 기준 검색 가능. |
읽기 |
get_ground_truth |
정답셋 항목 1건 상세 — classes + 라벨 payload(절단 요약). | 읽기 |
list_ground_truth_versions |
정답셋의 학습데이터 버전 목록(조회 전용). | 읽기 |
🧠 실험 · 모델 · 추론¶
ML 척추 뒷부분 — 실험 → 모델 → 플레이그라운드(추론). → 카테고리 페이지
| 도구 | 용도 | 구분 |
|---|---|---|
list_experiments |
실험(ML 실험·평가) 목록. | 읽기 |
get_experiment |
실험 1건 상세. | 읽기 |
create_experiment |
실험 생성 — name + 연결할 작업(task) 필요. | ✏️ 쓰기 |
update_experiment |
실험 name/description 수정. | ✏️ 쓰기 |
delete_experiment |
실험 삭제 — 실삭제 시 현재 name 정확히 일치 요구. | ⚠️ 파괴적 |
update_model |
모델 name/description 수정. | ✏️ 쓰기 |
delete_model |
모델 삭제 — 서빙 중지, 플러그인 자체는 유지. | ⚠️ 파괴적 |
get_model_lineage |
모델 계보(학습데이터 버전·정답셋 소스·조상 모델) 단일 호출 조회. | 읽기 |
run_playground |
모델을 플레이그라운드(추론 서버)로 구동 — 유일한 추론 구동 경로. | ✏️ 쓰기 |
🔗 백그라운드 작업(잡)¶
장시간 작업 추적 — 백엔드 비동기 작업(Celery)과 에이전트 잡(Ray)은 서로 다른 시스템. → 카테고리 페이지
| 도구 | 용도 | 구분 |
|---|---|---|
list_async_jobs |
백엔드 비동기 작업(내보내기·일괄처리 등, Celery) 목록 — Ray 잡은 list_agent_jobs. |
읽기 |
get_async_job |
백엔드 비동기 작업 1건 상세 — 진행률·완료 여부. | 읽기 |
cancel_async_job |
진행 중인 백엔드 비동기 작업 취소 요청 — Ray 잡 중지는 stop_agent_job. |
✏️ 쓰기 |
list_agent_jobs |
에이전트(Ray) 잡 목록 — status·action 필터. Celery 작업은 list_async_jobs. |
읽기 |
get_agent_job |
에이전트 잡 1건 상세 — 대형 필드는 요약·절단. | 읽기 |
get_agent_job_logs |
에이전트 잡 로그(mode=console|tail|events) — 스냅샷 절단 표시, events 는 구조화 로그. | 읽기 |
stop_agent_job |
실행/대기 중인 에이전트 잡을 사용자 개시로 중지 — 종료된 잡은 거부. | ⚠️ 파괴적 |
🔗 플러그인 실행 기록 (임포트·익스포트·전처리·학습)¶
에이전트 Job 을 감싼 도메인 실행 기록 — "어느 컬렉션으로 임포트했나 / 무엇을 익스포트했나 / 어떤 전처리로 등록했나 / 어떤 실험을 학습했나" 를 도메인 맥락과 함께 조회. Job 상태·로그는 위 잡 도구로 드릴다운. → 카테고리 페이지
| 도구 | 용도 | 구분 |
|---|---|---|
list_imports |
🏭 임포트(Upload) 실행 기록 목록 — data_collection·project·status 필터. | 읽기 |
get_import |
임포트 실행 기록 1건 상세 — 대상 컬렉션/프로젝트·경로·연결 Job. | 읽기 |
list_exports |
🏭🧠 익스포트(Export) 실행 기록 목록 — target·storage·project 필터. | 읽기 |
get_export |
익스포트 실행 기록 1건 상세 — target·필터·경로·연결 Job. | 읽기 |
list_pre_annotations |
🏭🧠 작업데이터/GT 등록(전처리) 실행 기록 목록 — target·method 필터. | 읽기 |
get_pre_annotation |
전처리 등록 실행 기록 1건 상세 — method·target·플러그인·연결 Job. | 읽기 |
list_trains |
🧠 학습(Train) 실행 기록 목록 — experiment·dataset·has_model 필터. | 읽기 |
get_train |
학습 실행 기록 1건 상세 — 실험·GTDV·is_tune·best_trial·연결 Job. | 읽기 |
🔗 플러그인 레지스트리¶
실행 기록·Ray job 이 참조하는 플러그인 정의·릴리즈 원장 — 코드/카테고리와 버전별 설정 스키마. → 카테고리 페이지
| 도구 | 용도 | 구분 |
|---|---|---|
list_plugins |
🔗 플러그인 정의 목록 — category·is_active 필터. | 읽기 |
get_plugin |
플러그인 1건 상세 — code·category 등 불변 식별자. | 읽기 |
list_plugin_releases |
🔗 플러그인 릴리즈(버전별 실체) 목록 — plugin 필터. | 읽기 |
get_plugin_release |
플러그인 릴리즈 1건 상세 — config/run_schema 등 대형 필드는 절단 요약, expand=<필드명> 으로 전체 조회. |
읽기 |
📚 제품 지식 위키¶
Synapse 제품 개념·정책·기능·용어의 정본 문서(synapse-wiki 릴리즈 스냅샷) — 로그인만 하면 워크스페이스 선택 없이 조회됩니다. → 카테고리 페이지
| 도구 | 용도 | 구분 |
|---|---|---|
list_wiki_docs |
위키 목차(개념·정책·UX 정책·기능) — 제품 지식 질문의 진입점. | 읽기 |
read_wiki_doc |
위키 문서 본문 — 목차의 slug 로 정본 내용 조회. | 읽기 |