> ## Documentation Index
> Fetch the complete documentation index at: https://docs.caret.so/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP 도구

> Caret MCP 서버에서 사용 가능한 도구

Caret MCP 서버는 워크스페이스 데이터에 접근하기 위한 6개의 읽기 전용 도구를 제공합니다. 모든 도구는 [OAuth 2.0 또는 API 키](/api-reference/mcp/authentication)를 통한 인증이 필요합니다.

## caret\_list\_notes

워크스페이스의 미팅 노트를 선택적 필터와 함께 목록 조회합니다. 기본 정보가 포함된 페이지네이션된 노트 목록을 반환합니다. 전사본과 요약을 포함한 전체 정보는 `caret_get_note`를 사용하세요.

**필요 권한:** `notes`

### 파라미터

<ParamField query="limit" type="number" default="20">
  반환할 노트 수 (1–100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  페이지네이션 오프셋
</ParamField>

<ParamField query="sortBy" type="string" default="createdAt">
  정렬 기준. 옵션: `createdAt`, `updatedAt`, `title`
</ParamField>

<ParamField query="sortOrder" type="string" default="desc">
  정렬 순서. 옵션: `asc`, `desc`
</ParamField>

<ParamField query="status" type="string">
  노트 상태 필터. 옵션: `idle`, `recording`, `transcript-processing`,
  `recorded-not-summarized`, `summarizing`, `completed`
</ParamField>

<ParamField query="search" type="string">
  제목 검색 쿼리
</ParamField>

<ParamField query="fromDate" type="string">
  해당 날짜 이후 생성된 노트 필터 (ISO 8601)
</ParamField>

<ParamField query="toDate" type="string">
  해당 날짜 이전 생성된 노트 필터 (ISO 8601)
</ParamField>

<ParamField query="folderIds" type="string">
  쉼표로 구분된 폴더 ID 필터
</ParamField>

<ParamField query="participantEmail" type="string">
  참여자 이메일 주소 필터
</ParamField>

### 응답

<ResponseField name="notes" type="NoteListItem[]">
  <Expandable title="NoteListItem">
    <ResponseField name="id" type="string">
      노트 ID
    </ResponseField>

    <ResponseField name="title" type="string">
      노트 제목
    </ResponseField>

    <ResponseField name="kind" type="string">
      노트 유형: `online`, `in-person`, 또는 `podcast`
    </ResponseField>

    <ResponseField name="status" type="string">
      현재 상태
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 타임스탬프
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601 타임스탬프
    </ResponseField>

    <ResponseField name="visibility" type="string">
      `private`, `workspace`, 또는 `shared`
    </ResponseField>

    <ResponseField name="tags" type="object[]">
      노트에 할당된 폴더/태그
    </ResponseField>

    <ResponseField name="participants" type="object[]">
      이름, 이메일, 회사 정보가 포함된 미팅 참여자
    </ResponseField>

    <ResponseField name="totalDurationSec" type="number">
      녹음 시간(초)
    </ResponseField>

    <ResponseField name="userWrittenNote" type="string">
      사용자의 개인 메모
    </ResponseField>

    <ResponseField name="calendarEvent" type="object | null">
      연결된 캘린더 이벤트
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable title="Pagination">
    <ResponseField name="limit" type="number">
      페이지당 항목 수
    </ResponseField>

    <ResponseField name="offset" type="number">
      현재 오프셋
    </ResponseField>

    <ResponseField name="hasMore" type="boolean">
      추가 결과 존재 여부
    </ResponseField>

    <ResponseField name="nextOffset" type="number | null">
      다음 페이지 오프셋, 마지막 페이지면 null
    </ResponseField>
  </Expandable>
</ResponseField>

***

## caret\_get\_note

특정 노트의 전사본, 요약, 참여자 정보를 포함한 상세 정보를 조회합니다.

**필요 권한:** `notes`

### 파라미터

<ParamField query="id" type="string" required>
  노트 ID
</ParamField>

<ParamField query="folderIds" type="string">
  노트가 속해야 하는 폴더 ID 목록(쉼표로 구분)
</ParamField>

### 응답

<ResponseField name="note" type="Note">
  <Expandable title="Note">
    <ResponseField name="id" type="string">
      노트 ID
    </ResponseField>

    <ResponseField name="title" type="string">
      노트 제목
    </ResponseField>

    <ResponseField name="kind" type="string">
      노트 유형
    </ResponseField>

    <ResponseField name="status" type="string">
      현재 상태
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 타임스탬프
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601 타임스탬프
    </ResponseField>

    <ResponseField name="visibility" type="string">
      `private`, `workspace`, 또는 `shared`
    </ResponseField>

    <ResponseField name="tags" type="object[]">
      폴더/태그
    </ResponseField>

    <ResponseField name="participants" type="object[]">
      참여자 상세 정보
    </ResponseField>

    <ResponseField name="totalDurationSec" type="number">
      녹음 시간(초)
    </ResponseField>

    <ResponseField name="userWrittenNote" type="string">
      사용자의 개인 메모
    </ResponseField>

    <ResponseField name="enhancedNote" type="string">
      AI 보강 노트 내용
    </ResponseField>

    <ResponseField name="summary" type="string">
      AI 생성 요약
    </ResponseField>

    <ResponseField name="transcripts" type="Transcript[]">
      <Expandable title="Transcript">
        <ResponseField name="speaker" type="string">
          발화자 이름
        </ResponseField>

        <ResponseField name="text" type="string">
          발화 내용
        </ResponseField>

        <ResponseField name="startTimestamp" type="string">
          시작 시간 (HH:MM:SS)
        </ResponseField>

        <ResponseField name="endTimestamp" type="string">
          종료 시간 (HH:MM:SS)
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="calendarEvent" type="object | null">
      참석자, 시간, 미팅 링크가 포함된 캘린더 이벤트
    </ResponseField>
  </Expandable>
</ResponseField>

***

## caret\_search\_notes

제목으로 노트를 검색합니다. 기본 정보가 포함된 일치하는 노트를 반환합니다.

**필요 권한:** `notes`

### 파라미터

<ParamField query="query" type="string" required>
  검색 쿼리
</ParamField>

<ParamField query="limit" type="number" default="10">
  반환할 결과 수 (1–50)
</ParamField>

<ParamField query="folderIds" type="string">
  필터링할 폴더 ID 목록(쉼표로 구분)
</ParamField>

### 응답

<ResponseField name="notes" type="NoteListItem[]">
  일치하는 노트 배열 (`caret_list_notes`와 동일한 구조)
</ResponseField>

<ResponseField name="query" type="string">
  사용된 검색 쿼리
</ResponseField>

<ResponseField name="count" type="number">
  반환된 결과 수
</ResponseField>

***

## caret\_search\_knowledge

자연어를 사용하여 미팅 노트와 워크스페이스 지식을 검색합니다. 시맨틱 검색을 통해 미팅 요약, Q\&A, 지식 베이스 문서에서 관련 콘텐츠를 찾습니다.

**필요 권한:** `notes`

### 파라미터

<ParamField query="query" type="string" required>
  자연어 검색 쿼리 (예: "고객이 가격에 대해 뭐라고 했어?")
</ParamField>

<ParamField query="sourceType" type="string" default="all">
  검색할 소스 유형. 옵션: `all`, `meeting`(미팅 노트만), `knowledge`(지식
  베이스만)
</ParamField>

<ParamField query="maxResults" type="number" default="5">
  반환할 최대 결과 수 (1–20)
</ParamField>

### 응답

<ResponseField name="results" type="SearchResult[]">
  <Expandable title="SearchResult">
    <ResponseField name="content" type="string">
      일치하는 콘텐츠 발췌
    </ResponseField>

    <ResponseField name="score" type="number">
      관련성 점수
    </ResponseField>

    <ResponseField name="sourceTitle" type="string">
      출처 문서 제목
    </ResponseField>

    <ResponseField name="sourceType" type="string">
      출처 유형 (meeting, knowledge 등)
    </ResponseField>

    <ResponseField name="url" type="string">
      출처 URL (있는 경우)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="query" type="string">
  사용된 검색 쿼리
</ResponseField>

<ResponseField name="sourceType" type="string">
  적용된 소스 유형 필터
</ResponseField>

<ResponseField name="totalResults" type="number">
  반환된 결과 수
</ResponseField>

***

## caret\_get\_workspace

이름, 설정, 허용 이메일 도메인 등 현재 워크스페이스의 상세 정보를 조회합니다.

**필요 권한:** 없음

### 파라미터

파라미터가 필요하지 않습니다.

### 응답

<ResponseField name="workspace" type="Workspace">
  <Expandable title="Workspace">
    <ResponseField name="id" type="string">
      워크스페이스 ID
    </ResponseField>

    <ResponseField name="name" type="string">
      워크스페이스 이름
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 타임스탬프
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601 타임스탬프
    </ResponseField>

    <ResponseField name="settings" type="object">
      워크스페이스 설정
    </ResponseField>

    <ResponseField name="allowedEmailDomains" type="string[]">
      워크스페이스의 허용 이메일 도메인
    </ResponseField>

    <ResponseField name="iconUrl" type="string | null">
      워크스페이스 아이콘 URL
    </ResponseField>
  </Expandable>
</ResponseField>

***

## caret\_list\_members

워크스페이스 멤버를 선택적 검색과 함께 목록 조회합니다. 이름, 이메일, 역할, 할당된 폴더 등 멤버 정보를 반환합니다.

**필요 권한:** `users`

### 파라미터

<ParamField query="limit" type="number" default="20">
  반환할 멤버 수 (1–100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  페이지네이션 오프셋
</ParamField>

<ParamField query="search" type="string">
  이름 또는 이메일로 검색
</ParamField>

### 응답

<ResponseField name="members" type="Member[]">
  <Expandable title="Member">
    <ResponseField name="id" type="string">
      사용자 ID
    </ResponseField>

    <ResponseField name="name" type="string">
      전체 이름
    </ResponseField>

    <ResponseField name="email" type="string">
      이메일 주소
    </ResponseField>

    <ResponseField name="profileUrl" type="string">
      프로필 이미지 URL
    </ResponseField>

    <ResponseField name="role" type="string">
      워크스페이스 역할
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 타임스탬프
    </ResponseField>

    <ResponseField name="folders" type="object[]">
      ID와 이름이 포함된 할당된 폴더
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable title="Pagination">
    <ResponseField name="limit" type="number">
      페이지당 항목 수
    </ResponseField>

    <ResponseField name="offset" type="number">
      현재 오프셋
    </ResponseField>

    <ResponseField name="hasMore" type="boolean">
      추가 결과 존재 여부
    </ResponseField>

    <ResponseField name="nextOffset" type="number | null">
      다음 페이지 오프셋
    </ResponseField>
  </Expandable>
</ResponseField>