BrainTube를 Cursor에 연결하기

BrainTube를 Cursor에 연결해 AI 코딩 어시스턴트가 내 개인 지식 베이스를 쓸 수 있게 하세요.

Cursor에 연결하면 좋은 점

• 코딩하면서 저장해 둔 문서와 튜토리얼을 검색할 수 있어요
• 편집기를 떠나지 않고 예전 리서치를 참고할 수 있어요
• 실제 내 메모와 하이라이트를 근거로 Cursor에게 질문할 수 있어요
• 지식 코퍼스의 맥락을 활용해 애플리케이션을 만들 수 있어요

설정 단계

Cursor는 아직 BrainTube 로그인을 지원하지 않아서 API 키를 써요. MCP와 API 키는 무료 요금제를 포함한 모든 요금제에 포함돼 있어요.

1. BrainTube에서 설정 → API 키를 열고 키를 만드세요. 키는 bt_로 시작하고 한 번만 표시되니 바로 복사해 두세요.
2. 프로젝트 루트에서 .cursor/mcp.json을 만들거나 여세요(모든 프로젝트에서 BrainTube를 쓰려면 ~/.cursor/mcp.json)
3. mcpServers 아래에 BrainTube를 추가하세요.

{
  "mcpServers": {
    "braintube": {
      "url": "https://mcp.brain-tube.com/mcp",
      "headers": {
        "X-BrainTube-Token": "bt_your_key_here"
      }
    }
  }
}

1. bt_your_key_here를 내 키로 바꾸고 저장하세요
2. Cursor를 다시 시작하세요. 에이전트 패널에 BrainTube 도구가 나타나고, Cursor Settings → MCP(Cursor 설정 → MCP)에 서버가 연결됨으로 표시돼요.

Cursor는 아직 저희가 직접 테스트하지 않았어요. Claude와 같은 MCP streamable-HTTP 엔드포인트를 써요.

Cursor에서 사용하기

연결하고 나면 Cursor에게 이렇게 물어볼 수 있어요.

• "내 BrainTube에서 React 서버 컴포넌트 모범 사례를 검색해 주세요"
• "데이터베이스 최적화에 대해 내가 저장한 게 뭔가요?"
• "그 콘퍼런스 발표에서 나온 아키텍처 패턴에 관한 내 메모를 찾아 주세요"

팁

• 키가 버전 관리에 올라가지 않게 하세요. 프로젝트의 .cursor/mcp.json이 커밋된다면 대신 ~/.cursor/mcp.json을 쓰세요.
• 키는 만료되지 않아요. 키가 작동하지 않는다면 폐기된 거예요. 설정 → API 키에서 새 키를 만드세요.
• 코퍼스에 코딩 프로젝트와 관련된 콘텐츠가 있을 때 가장 잘 작동해요
• Cursor의 코드베이스 검색과 함께 쓰면 더 폭넓은 결과를 얻을 수 있어요