개발자용

내 스택에 BrainTube를 연결하세요

MCP 엔드포인트는 하나예요. Claude, ChatGPT, Cursor 등 MCP 클라이언트를 이미 쌓아 둔 지식 베이스에 연결하세요.

API 키 받기 연결 가이드
MCP 서버
엔드포인트 하나로 모든 MCP 클라이언트에 연결돼요. 처음부터 특정 AI에 묶이지 않게 설계해서, 한 번 연결하면 지금 쓰는 도구 안에서 바로 내 라이브러리를 조회할 수 있어요.
읽기·쓰기 도구
지금 40개의 도구를 쓸 수 있고, 기본으로는 그중 12개가 연결돼요(?tools=full을 붙이면 전부). 의미 기반 검색과 멀티홉 검색, 지식 그래프 탐색, 코퍼스 진단, 잊을 만할 때 다시 꺼내 주는 복습, 그리고 쓰기 기능까지 있어서 어시스턴트가 대신 저장하고, 메모하고, 태그를 달고, 가져오기를 해 줘요.
bt_ API 키
OAuth를 지원하지 않는 클라이언트용이에요. 설정에서 만들고, 단방향 해시로 저장하며, 한 번만 보여 주고, 언제든 폐기할 수 있어요.
쓰던 자료 그대로 가져오기
Kindle, Readwise, Obsidian, Pocket, 브라우저 북마크, Notion 양방향 연결, YouTube 채널까지 앱 안의 가져오기 허브에서 가져올 수 있어요.
EU 데이터 보관
라이브러리는 EU 리전에 저장되고, 저장 시 암호화돼요.
언제든 내보내기
설정에서 라이브러리를 Markdown이나 Anki 카드로 내보내거나, MCP로 전체 코퍼스를 내보낼 수 있어요.

30초면 연결돼요

OAuth로 연결하는 Claude.ai부터 Cursor, Claude Desktop, CLI 도구까지, 모든 클라이언트의 설정 방법은 연결 가이드 한곳에서 최신 상태로 관리해요.

연결 가이드 열기 AI가 읽기 좋은 버전

HTTP 인터페이스

버전 관리 전

같은 백엔드가 MCP와 함께 일반 HTTP도 지원해요. MCP는 실행 중에 도구를 찾아 쓰는 AI 클라이언트를 위한 문이고, HTTP는 원하는 게 이미 정해진 코드를 위한 문이에요. BrainTube 웹 앱, Chrome 확장 프로그램, 채팅 위젯 모두 이 인터페이스를 호출해요.

기본 URL

https://mcp.brain-tube.com

인증

Authorization: Bearer <token>

검색, 코퍼스 통계, 수집, 태그, 메모, 북마크, Brain에 걸쳐 18개의 작업을 제공해요. MCP 엔드포인트는 HTTP 인터페이스보다 훨씬 많은 기능을 제공하니, 여기에 없는 기능이라면 먼저 MCP를 확인해 보세요. 전체 스키마, 파라미터, 인증 방식은 명세에 있어요.

OpenAPI 명세 보기 →

버전 관리가 되지 않고 안정성도 보장하지 않아요. 저희 클라이언트들이 쓰는 인터페이스라서, 그쪽에 필요하면 바뀌어요. 이 위에 무언가를 만들고 있다면 알려 주세요. 바뀌기 전에 미리 알려 드릴게요.

만들 준비 되셨나요?

무료로 시작하세요. 카드 등록도 필요 없어요.

지금 만들기

자주 묻는 질문

BrainTube를 Claude나 ChatGPT에 어떻게 연결하나요?
Claude.ai에서는 https://mcp.brain-tube.com/mcp를 사용자 지정 커넥터로 추가하고 BrainTube 계정으로 로그인하면 돼요. 나머지는 OAuth가 알아서 처리하니 붙여 넣을 키도 없어요. Claude와 ChatGPT에서 테스트를 마쳤고, Cursor를 비롯해 MCP streamable-HTTP를 지원하는 클라이언트는 모두 같은 엔드포인트를 써요. 클라이언트별 단계 안내는 연결 가이드에 있어요.
AI 어시스턴트가 내 라이브러리로 실제로 무엇을 할 수 있나요?
지금 40개의 도구가 제공되고, 그중 10개는 쓰기 기능이 있어요. 기본으로는 자주 쓰는 검색·조회·저장 도구 12개가 연결되고, 나머지 읽기 도구는 도구 찾기로 불러 쓸 수 있어요. 엔드포인트에 ?tools=full을 붙이면 40개 전부가 연결돼요. 기본 목록은 언제나 https://brain-tube.com/connect.md에서 볼 수 있어요. 이 페이지는 서버에서 직접 생성되기 때문에 내용이 낡을 일이 없어요. 어시스턴트는 검색과 조회는 물론 지식 그래프를 탐색하고, 저장한 두 항목 사이의 경로를 찾고, 코퍼스 상태 점검과 빈틈 점검을 실행하고, 한동안 다시 보지 않은 항목을 다시 꺼내 줄 수 있어요. 쓰기도 가능해요. 저장, 일괄 저장, 메모, 태그, 북마크, 그리고 Notion이나 Readwise에서 가져오기까지 할 수 있어요.
API 키는 언제 필요한가요?
OAuth를 지원하지 않는 클라이언트에서만 필요해요. Cursor, CLI 도구, 직접 만든 스크립트 같은 경우요. 설정 → API 키에서 만들 수 있어요. 키는 bt_로 시작하고, 한 번만 보여 주며, X-BrainTube-Token 헤더로 보내면 돼요. 저희는 단방향 해시만 저장하기 때문에, 키를 잃어버렸다면 폐기하고 새로 만들어 주세요.
REST API나 SDK가 있나요?
https://mcp.brain-tube.com에 HTTP 인터페이스가 있고, 공개 OpenAPI 명세는 https://mcp.brain-tube.com/openapi.json에 있어요. BrainTube 웹 앱, 확장 프로그램, 채팅 위젯이 직접 호출하는 인터페이스로, 검색, 코퍼스 통계, 수집, 태그, 메모, 북마크, Brain을 다뤄요. 아직 버전 관리가 되지 않고 안정성도 보장하지 않으니, 공식 지원이 아니라 '쓸 수는 있는' 인터페이스로 생각해 주세요. 이 위에 무언가를 만들 수는 있지만, 예고 없이 바뀔 수 있어요. 타입이 지정된 SDK는 없어요. 로드맵에는 있지만 아직 일정은 정해지지 않았어요.
사용량 제한이 있나요?
지금은 요금제별 API 제한을 공개하지 않아요. 자동화된 트래픽이 계속 이어지면 속도가 제한될 수 있어요. 무거운 작업을 만들고 있다면 어떤 건지 알려 주세요. 벽에 부딪힐 만한 부분이 있으면 미리 짚어 드릴게요.
데이터는 어디에 저장되고, 밖으로 꺼낼 수 있나요?
라이브러리는 EU 리전에 저장되고, 저장 시 암호화돼요. 설정에서 라이브러리를 Markdown이나 Anki 카드로 내보내거나, MCP로 전체 코퍼스를 내보낼 수 있어요.
다른 도구에서 쓰던 라이브러리를 가져올 수 있나요?
네. 앱 안의 가져오기 허브에서 Kindle 하이라이트, Readwise CSV 내보내기 파일, Obsidian과 Markdown 파일, Pocket과 Instapaper 내보내기 파일, 브라우저 북마크, YouTube 채널을 가져올 수 있고, Notion과는 양방향으로 연결돼요.