사용 설명서

① 연결하기

Claude(또는 ChatGPT) 설정에서 커넥터(앱)를 추가하고 아래 커넥터 URL을 입력하면 끝입니다. 프로그램을 따로 설치하지 않습니다.

1. Claude: 설정 → 커넥터(Connectors) → 커스텀 커넥터 추가에서 아래 URL을 붙여넣습니다. (Pro·Max·Team·Enterprise 플랜에서 지원)
2. ChatGPT: 설정 → 앱(Apps)에서 같은 커넥터 URL을 추가합니다.

커넥터 URL:

https://mcp.synapse.sh/mcp

② 환경 선택

Synapse는 여러 환경(배포)으로 운영됩니다(예: test · staging · production · airgap · demo). 사용할 환경을 먼저 고른 뒤 로그인합니다 — 환경마다 로그인과 데이터가 따로 격리됩니다.

• 환경 목록 보여줘 — 고를 수 있는 환경을 봅니다(list_environments).
• staging 환경 선택해줘 — 그 환경으로 전환합니다(select_environment). 지금 환경이 궁금하면 현재 환경 알려줘 (current_environment).

연결할 수 있는 환경이 하나뿐이라면 이 단계는 건너뛰어도 됩니다.

③ 로그인 · 워크스페이스 선택

환경을 고른 뒤 로그인합니다. 평소 쓰던 Synapse 계정의 이메일·비밀번호로 로그인하면 됩니다 — 로그인할게, 이메일은 … 처럼 말하면 됩니다 (login). 관리자가 미리 토큰을 설정해 두는 경우도 있습니다. 로그인은 환경별로 따로 합니다.

로그인 후에는 기능을 쓰기 전에 워크스페이스를 먼저 선택해야 합니다. 워크스페이스는 여러분의 데이터가 담긴 작업 공간이며, 선택한 공간 안에서만 작업이 일어나도록 격리됩니다.

• 내 워크스페이스 보여줘 — 선택할 수 있는 목록을 봅니다.
• ○○ 워크스페이스 선택해줘 — 그 공간으로 들어갑니다(select_workspace).

워크스페이스를 고르기 전에 기능을 요청하면, AI가 먼저 목록을 보여주며 선택을 안내합니다.

④ 할 수 있는 일

아래 문장처럼 평소 말하듯 요청하면 됩니다. 정확한 명령어를 외울 필요는 없습니다.

둘러보기 (읽기)

• 내 프로젝트 목록 보여줘
• 이미지 데이터 컬렉션만 보여줘 — 종류로 걸러서 봅니다.
• 프로젝트 61 상세 보여줘 — 특정 항목을 자세히 봅니다.

만들기

• 이미지 프로젝트 P 만들어줘
• 정답셋 X 만들어줘
• 이미지 데이터 컬렉션 Y 만들어줘

만들기 요청을 하면 AI가 먼저 무엇을 만들지 미리보기를 보여줍니다. 여러분이 "확인"이라고 답해야 실제로 생성됩니다.

수정 · 삭제

• 데이터 컬렉션 5 이름을 Z로 바꿔줘

수정·삭제도 똑같이 미리보기 → 확인 순서로 진행됩니다.

작업 진행 상황

• 비동기 작업 목록 보여줘
• 작업 상태 확인해줘 — 오래 걸리는 작업의 진행을 확인합니다.
• 그 작업 취소해줘 — 진행 중인 작업을 멈춥니다.

어노테이션 워크플로

• 할당작업 4574 제출해줘 (작업자)
• 할당작업 4574 승인해줘 / 반려해줘 (검수자)

상태를 바꾸는 요청은 실수 방지를 위해 확인 절차를 거칩니다.

게시판

• 공지 보여줘
• FAQ 보여줘