> ## 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 (Model Context Protocol)

> Model Context Protocol을 사용하여 Claude Desktop, Cursor, Windsurf 등 AI 어시스턴트에 Caret를 연결하세요.

MCP는 AI 어시스턴트가 Caret 미팅 데이터에 직접 접근할 수 있게 해주는 오픈 프로토콜입니다. 워크플로우를 벗어나지 않고 AI에게 과거 미팅에 대해 질문하거나, 지식 베이스를 검색하거나, 전사본을 참조할 수 있습니다.

## 지원 클라이언트

<CardGroup cols={3}>
  <Card title="Claude Desktop" icon="message-bot">
    Anthropic의 데스크톱 AI 어시스턴트.
  </Card>

  <Card title="Cursor" icon="code">
    AI 기반 코드 에디터.
  </Card>

  <Card title="모든 MCP 클라이언트" icon="plug">
    Model Context Protocol을 지원하는 모든 클라이언트.
  </Card>
</CardGroup>

## 빠른 설정

<Tabs>
  <Tab title="Claude Desktop">
    <Steps>
      <Step title="설정 열기">
        Claude Desktop을 열고 **Settings > MCP Servers**로 이동합니다.
      </Step>

      <Step title="서버 추가">
        **Add**를 클릭하고 서버 URL을 입력합니다:

        ```
        https://api.caret.so/mcp
        ```
      </Step>

      <Step title="로그인">
        Claude가 브라우저 창을 엽니다. Google 계정으로 로그인하세요.
      </Step>

      <Step title="워크스페이스 선택">
        연결할 Caret 워크스페이스를 선택합니다.
      </Step>

      <Step title="사용 시작">
        연결 완료. Claude에게 미팅에 대해 질문해 보세요.
      </Step>
    </Steps>

    `claude_desktop_config.json`에서 수동으로 서버를 추가할 수도 있습니다:

    ```json theme={null}
    {
      "mcpServers": {
        "caret": {
          "type": "streamable-http",
          "url": "https://api.caret.so/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Cursor">
    <Steps>
      <Step title="MCP 설정 열기">
        **Cursor Settings > MCP**로 이동합니다.
      </Step>

      <Step title="서버 추가">
        **Add new MCP server**를 클릭하고 URL에 `https://api.caret.so/mcp`를 입력합니다.
      </Step>

      <Step title="인증">
        브라우저 창이 나타나면 로그인하고 워크스페이스를 선택합니다.
      </Step>
    </Steps>

    또는 프로젝트의 `.cursor/mcp.json`에 직접 추가합니다:

    ```json theme={null}
    {
      "mcpServers": {
        "caret": {
          "type": "streamable-http",
          "url": "https://api.caret.so/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="기타 클라이언트">
    MCP 호환 클라이언트에서 아래 설정을 사용하세요:

    * **서버 URL**: `https://api.caret.so/mcp`
    * **전송 방식**: Streamable HTTP
    * **인증**: OAuth 2.0 (대부분의 클라이언트에서 자동 처리)

    클라이언트가 OAuth를 지원하지 않는 경우 아래의 API 키 방식을 사용하세요.
  </Tab>
</Tabs>

## API 키 인증

MCP 클라이언트가 OAuth를 지원하지 않는 경우 API 키로 인증할 수 있습니다.

<Steps>
  <Step title="API 키 생성">
    Caret의 **설정 > 개발자**에서 **API 키 만들기**를 클릭합니다.
  </Step>

  <Step title="권한 범위 할당">
    MCP 도구 전체에 접근하려면 `notes` 및 `users` 범위를 선택합니다.
  </Step>

  <Step title="클라이언트 설정">
    MCP 클라이언트의 인증 헤더에 API 키를 Bearer 토큰으로 설정합니다.
  </Step>
</Steps>

<Warning>
  API 키를 안전하게 보관하세요. 공개 저장소나 클라이언트 측 코드에 키가 노출되지
  않도록 주의하세요.
</Warning>

## 사용 가능한 기능

모든 도구는 **읽기 전용**이며 워크스페이스 범위 내에서 동작합니다.

| 기능           | 예시 프롬프트                |
| :----------- | :--------------------- |
| 미팅 노트 목록     | "지난주 미팅을 보여줘"          |
| 노트 상세 조회     | "Q3 기획 회의에서 무엇을 논의했어?" |
| 제목으로 노트 검색   | "가격 관련 미팅을 찾아줘"        |
| 지식 베이스 검색    | "고객이 경쟁사에 대해 뭐라고 했어?"  |
| 워크스페이스 정보 조회 | "어떤 워크스페이스에 연결되어 있어?"  |
| 팀 멤버 조회      | "팀에 누가 있어?"            |

전체 도구 스키마와 파라미터는 [MCP 도구 레퍼런스](/api-reference/mcp/tools)를 참고하세요.

## 문제 해결

| 문제              | 해결 방법                                       |
| :-------------- | :------------------------------------------ |
| 연결 실패           | URL이 정확히 `https://api.caret.so/mcp`인지 확인하세요 |
| 인증 오류           | 재인증하거나 API 키의 권한 범위가 올바른지 확인하세요             |
| 결과 없음           | 워크스페이스에 완료 상태의 미팅 노트가 있는지 확인하세요             |
| 워크스페이스를 찾을 수 없음 | 선택한 워크스페이스의 멤버인지 확인하세요                      |