당신의 노트를 AI 어시스턴트 안으로

Cosmonote를 Claude, ChatGPT 또는 다른 AI 어시스턴트에 연결하세요. 녹음, 전사, 요약, 할 일을 읽고 그에 대한 질문에 답할 수 있게 됩니다.

여기서 시작하기 ↓

무엇을 할 수 있나

연결하고 나면 「월요일 회의에서 뭘 정했지?」 같은 질문만 하면 어시스턴트가 Cosmonote 노트를 뒤져 답합니다. 복사할 일도, 내보낼 일도 없습니다.

읽기만 합니다. 어시스턴트가 무언가를 바꾸거나 지우거나 녹음하는 일은 없으며, 오직 당신 계정의 노트만 봅니다.

MCP는 이것을 가능하게 하는 공개 표준입니다. 아래 단계를 따라가는 데 그 이상은 알 필요가 없습니다. 직접 무언가를 만들고 싶다면 REST API를 쓰세요.

시작하기 전에

필요한 건 하나, Cosmonote API 키입니다. 30초면 됩니다.

  1. 휴대폰에서 Cosmonote 앱을 엽니다.
  2. 설정 → API 키로 이동합니다.
  3. 키 만들기를 누르고 복사합니다.

가까이 두세요. 어시스턴트는 로그인할 때 한 번만 물어보고, 그 뒤로는 묻지 않습니다.

어시스턴트 연결하기

쓰는 것을 고르세요. 모든 경로의 끝은 같습니다. Cosmonote 로그인 화면이 열리고, 키를 붙여 넣으면 연결됩니다.

https://nebula.cosmonote.ai/mcp
바로 가기: Claude Claude Code ChatGPT Cursor, Windsurf, Zed…

Claude

웹, 데스크톱, 모바일
  1. Claude를 열고 설정 → 커넥터로 갑니다.
  2. 사용자 지정 커넥터 추가를 클릭합니다.
  3. URL 칸에 Cosmonote 주소를 붙여 넣습니다: 
    https://nebula.cosmonote.ai/mcp
  4. 연결을 클릭합니다. Cosmonote 로그인 화면이 열립니다.
  5. API 키를 붙여 넣고 승인합니다. 이제 커넥터 목록에 Cosmonote가 보입니다.

Claude Code

터미널에서
  1. 이 명령을 실행합니다: 
    claude mcp add --transport http cosmonote https://nebula.cosmonote.ai/mcp
  2. Claude Code에서 /mcp를 입력하고 Authenticate를 선택합니다.
  3. 열리는 페이지에 API 키를 붙여 넣습니다.

ChatGPT

웹, 데스크톱
  1. ChatGPT를 열고 설정 → 커넥터로 갑니다.
  2. 디렉터리에서 Cosmonote를 찾습니다. 없으면 사용자 지정 커넥터 추가를 고르고 위 주소를 붙여 넣습니다.
  3. 물어보면 API 키로 로그인합니다.

Cursor, Windsurf, Zed 등

MCP를 지원하는 앱이면 방식은 같습니다. 설정 파일에 Cosmonote를 추가하고, 앱을 열어 안내되는 로그인을 끝내면 됩니다.

{
  "mcpServers": {
    "cosmonote": {
      "url": "https://nebula.cosmonote.ai/mcp"
    }
  }
}

연결에는 Streamable HTTP와 OAuth 2.0 + PKCE를 씁니다. 그 밖에 설정할 것은 없습니다.

해보기

연결했다면 녹음해 둔 것에 대해 무엇이든 물어보세요.

최근 회의 3건을 요약해 줘
어제 팀 미팅에서 어떤 결정이 났지?
미완료 할 일을 기한과 함께 모두 보여 줘
출시 일정에 대해 Sarah가 뭐라고 했지?
오늘 회의를 바탕으로 후속 메일을 써 줘
지난 두 강의의 핵심을 비교해 줘

무엇을 볼 수 있나

읽기 전용 도구 세 가지, 모두 당신 계정으로 한정됩니다.

list_notes

제목, 날짜, 길이, 화자, 분류, 핵심을 포함한 노트 목록.

read-only
get_note

노트 한 건의 전체. 요청하면 전사와 요약도 함께.

read-only
list_action_items

노트에서 뽑아낸 할 일. 한 건만도, 전체도 가능합니다.

read-only

기술 참고

연결만 하려면 여기는 필요 없습니다. Cosmonote를 자기 앱에 붙이는 분들을 위한 내용입니다.

엔드포인트 https://nebula.cosmonote.ai/mcp
전송 Streamable HTTP (JSON-RPC)
인증 OAuth 2.0 + PKCE
디스커버리 /.well-known/oauth-authorization-server
접근 읽기 전용, 사용자 단위

잘 안 될 때

연결이 실패합니다

주소를 한 글자씩 확인하세요. https://nebula.cosmonote.ai/mcp이며, 끝에 슬래시를 붙이지 않습니다.

로그인 화면이 키를 거부합니다

키는 접두사까지 통째로 복사합니다. 잘 안 되면 설정 → API 키에서 새로 만들어 그것을 붙여 넣으세요.

연결은 되는데 노트가 없습니다

어시스턴트는 그 키를 발급한 계정의 노트만 봅니다. 같은 Cosmonote 계정인지, 그 계정에 녹음이 있는지 확인하세요.

그래도 안 되면

어떤 어시스턴트를 연결하려는지 적어 [email protected]로 보내주세요.