MCP는 AI 어시스턴트가 Caret 미팅 데이터에 직접 접근할 수 있게 해주는 오픈 프로토콜입니다. 워크플로우를 벗어나지 않고 AI에게 과거 미팅에 대해 질문하거나, 지식 베이스를 검색하거나, 전사본을 참조할 수 있습니다.
지원 클라이언트
Claude Desktop
Anthropic의 데스크톱 AI 어시스턴트.
모든 MCP 클라이언트
Model Context Protocol을 지원하는 모든 클라이언트.
빠른 설정
Claude Desktop
Cursor
기타 클라이언트
설정 열기
Claude Desktop을 열고 Settings > MCP Servers로 이동합니다.
로그인
Claude가 브라우저 창을 엽니다. Google 계정으로 로그인하세요.
워크스페이스 선택
연결할 Caret 워크스페이스를 선택합니다.
사용 시작
연결 완료. Claude에게 미팅에 대해 질문해 보세요.
claude_desktop_config.json에서 수동으로 서버를 추가할 수도 있습니다:{
"mcpServers": {
"caret": {
"type": "streamable-http",
"url": "https://api.caret.so/mcp"
}
}
}
MCP 설정 열기
Cursor Settings > MCP로 이동합니다.
서버 추가
Add new MCP server를 클릭하고 URL에 https://api.caret.so/mcp를 입력합니다.
인증
브라우저 창이 나타나면 로그인하고 워크스페이스를 선택합니다.
또는 프로젝트의 .cursor/mcp.json에 직접 추가합니다:{
"mcpServers": {
"caret": {
"type": "streamable-http",
"url": "https://api.caret.so/mcp"
}
}
}
MCP 호환 클라이언트에서 아래 설정을 사용하세요:
- 서버 URL:
https://api.caret.so/mcp
- 전송 방식: Streamable HTTP
- 인증: OAuth 2.0 (대부분의 클라이언트에서 자동 처리)
클라이언트가 OAuth를 지원하지 않는 경우 아래의 API 키 방식을 사용하세요.
API 키 인증
MCP 클라이언트가 OAuth를 지원하지 않는 경우 API 키로 인증할 수 있습니다.
API 키 생성
Caret의 설정 > 개발자에서 API 키 만들기를 클릭합니다.
권한 범위 할당
MCP 도구 전체에 접근하려면 notes 및 users 범위를 선택합니다.
클라이언트 설정
MCP 클라이언트의 인증 헤더에 API 키를 Bearer 토큰으로 설정합니다.
API 키를 안전하게 보관하세요. 공개 저장소나 클라이언트 측 코드에 키가 노출되지
않도록 주의하세요.
사용 가능한 기능
모든 도구는 읽기 전용이며 워크스페이스 범위 내에서 동작합니다.
| 기능 | 예시 프롬프트 |
|---|
| 미팅 노트 목록 | ”지난주 미팅을 보여줘” |
| 노트 상세 조회 | ”Q3 기획 회의에서 무엇을 논의했어?” |
| 제목으로 노트 검색 | ”가격 관련 미팅을 찾아줘” |
| 지식 베이스 검색 | ”고객이 경쟁사에 대해 뭐라고 했어?” |
| 워크스페이스 정보 조회 | ”어떤 워크스페이스에 연결되어 있어?” |
| 팀 멤버 조회 | ”팀에 누가 있어?” |
전체 도구 스키마와 파라미터는 MCP 도구 레퍼런스를 참고하세요.
문제 해결
| 문제 | 해결 방법 |
|---|
| 연결 실패 | URL이 정확히 https://api.caret.so/mcp인지 확인하세요 |
| 인증 오류 | 재인증하거나 API 키의 권한 범위가 올바른지 확인하세요 |
| 결과 없음 | 워크스페이스에 완료 상태의 미팅 노트가 있는지 확인하세요 |
| 워크스페이스를 찾을 수 없음 | 선택한 워크스페이스의 멤버인지 확인하세요 |