Claude Code가 배운 것을 저장하게 하기: MCP로 bulk_ingest 쓰기

코딩 에이전트가 저장소에서 한 시간을 보냅니다. 마이그레이션 기록을 읽고, 재시도 로직이 왜 지금 같은 모양인지 파악하고, 드라이버 버그를 설명하는 Stack Overflow 답변 세 개를 찾아낸 뒤, 문제를 고칩니다.

그리고 세션이 끝나면 그 모든 것이 사라집니다. 아래에 소개하는 해결 방법은 2026년 9월 5일에 읽은 BrainTube의 공개 문서와 대조해 확인했습니다.

코드가 사라지는 것은 아닙니다. 코드는 커밋되어 있습니다. 사라지는 것은 에이전트가 거기까지 가면서 배운 모든 것입니다. 다음 세션은 아무것도 없는 상태에서 시작해 같은 맥락을 같은 토큰 비용으로 다시 알아내고, 이미 한 번 비용을 치른 결론에 다시 도달합니다.

지금 에이전트 워크플로에서 가장 비싼 습관이 바로 이것이고, 이는 모델의 문제가 아닙니다. 배관의 문제입니다.

실제로 잃어버리는 것

긴 세션에서 코딩 에이전트가 만들어 내는 것을 지켜보면서 두 더미로 나눠 보세요.

첫 번째 더미는 산출물입니다. diff, 파일, 커밋입니다. 이것들은 살아남습니다. 저장소는 영구적인 저장 공간이고, 에이전트는 그곳에 쓰는 방법을 알기 때문입니다.

두 번째 더미는 이해입니다. 이전 접근 방식이 왜 실패했는지. 어떤 라이브러리 버전에서 호환성이 깨지는 변경이 들어왔는지. 모든 것을 설명해 준 GitHub 이슈의 댓글. 이 더미는 갈 곳이 없습니다. 대화 기록 안에 머물 뿐인데, 대화 기록은 지식 베이스가 아닙니다. 세션을 넘나들며 검색할 수도 없고, 색인되지도 않으며, 그것이 필요한 다음 에이전트가 닿을 수도 없습니다.

코드에 대해서는 이미 이 문제를 해결했습니다. 소스 코드를 채팅 창에 보관하는 사람은 없습니다. 해결책은 도구가 쓸 수 있는 영구적인 저장 공간이었습니다. 이해에도 같은 해결책이 필요합니다.

패턴

에이전트에게 MCP로 쓸 수 있는 라이브러리를 주세요.

BrainTube의 MCP 서버는 읽기·쓰기 서버입니다. 즉, 어시스턴트가 라이브러리에서 무언가를 꺼내기만 하는 것이 아니라 넣을 수도 있습니다. Claude Code 연결은 설정 블록 하나면 됩니다.

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

키는 설정 → API 키에서 만드세요. 키는 해시로만 저장되므로, 잃어버렸다면 폐기하고 새로 만들면 됩니다. Claude.ai는 대신 OAuth로 연결되어 키가 전혀 필요 없고, CLI 도구와 Cursor에는 헤더가 필요합니다.

여기서 하지 않는 일에 주목하세요. API 페이로드를 작성하지 않습니다. MCP 클라이언트는 사용 가능한 도구와 그 매개변수를 런타임에 알아냅니다. 서버를 연결하면, 에이전트가 하려는 일에 맞는 도구를 스스로 찾아냅니다. 그것이 이 프로토콜의 핵심이고, 이 작업이 연동 프로젝트가 아니라 설정 변경으로 끝나는 이유입니다.

이 패턴에 중요한 도구

서버에는 44개의 도구가 있습니다. 그중 네 개가 이 패턴을 떠받칩니다.

`ingest_content`는 메모, 기사, 문서 같은 항목 하나를 코퍼스에 저장합니다. 한 번에 하나씩 저장하는 경우입니다. 에이전트가 남길 만한 것을 찾으면 남깁니다.

`bulk_ingest`는 한 번의 호출로 최대 50개 항목을 받고, 중복 제거와 임베딩은 서버에서 처리합니다. 에이전트에게 중요한 것은 이 도구입니다. 에이전트는 유용한 것을 하나 찾는 게 아니라 열한 개를 찾기 때문입니다. 저장 호출을 50번 따로 하면 속도 제한 문제와 지연 시간 문제가 생깁니다. 한 번의 호출이면 둘 다 생기지 않습니다. 중복 제거가 서버에서 실행된다는 것은, 이미 저장한 출처를 에이전트가 다시 읽어도 사본이 하나 더 생기지 않는다는 뜻이기도 합니다. 저장하는 주체가 신중한 사람이 아닐 때 이는 아주 중요합니다.

`add_note`는 이미 코퍼스에 있는 항목에 메모나 종합 내용을 덧붙여 씁니다. 에이전트 자신의 추론이 따로 떠돌지 않고, 그 추론을 이끌어 낸 출처에 붙어 자리 잡는 곳이 여기입니다.

`tag_item`은 나중에 태그를 추가하거나 제거하므로, 정리 방식을 저장 시점에 정하지 않아도 됩니다.

고리 닫기

저장은 기억 시스템의 절반일 뿐입니다. 나머지 절반은 다음 세션을 시작할 때 그것을 다시 가져오는 일이고, Claude Code에는 정확히 그 용도로 만든 도구가 있습니다.

`export_claude_md`는 코퍼스를 바탕으로, 어떤 Claude Code 프로젝트에든 쓸 수 있는 CLAUDE.md 호환 지식 컨텍스트 파일을 생성합니다.

이것으로 고리가 닫힙니다. 에이전트는 세션 중에 배운 것을 저장합니다. 다음 세션 전에, 라이브러리의 관련 부분이 에이전트가 시작할 때 읽는 컨텍스트 파일이 됩니다. 첫 번째 세션에서 배운 것을 네 번째 세션에서도 쓸 수 있고, 누구도 다시 설명할 필요가 없습니다.

세션 도중의 작업을 위한 읽기 도구도 있습니다. 전문 검색을 하는 search_knowledge, "멀티홉 지식 검색: 의미 검색 + 상위 결과에서 출발하는 그래프 탐색"을 하는 deep_search, "지식 그래프에서 두 항목 사이의 최단 경로를 찾는" find_path가 있습니다. 하지만 Claude Code 프로젝트가 시작되는 방식을 바꾸는 것은 export_claude_md입니다.

솔직하게 말하는 비용

저장이 공짜는 아니며, 이 점을 말하지 않고 이 패턴을 설명하는 것은 정직하지 않습니다.

항목 저장은 무료이고 +1 크레딧을 받습니다. 검색은 월 허용량(무료 요금제는 월 1,000회)까지, 라이브러리에 하는 질문은 하루 50회까지 무료이며 그 이후에는 크레딧이 듭니다. MCP 액세스는 무료를 포함한 모든 요금제에 포함되어 있고, 무료 요금제에는 월 1,000회의 무료 MCP 검색이 들어 있습니다. 그래서 라이브러리를 쉴 새 없이 검색하는 에이전트만 사용량을 체감하게 됩니다. 신입 리서처에게 하듯이, 무엇이 남길 가치가 있는지에 대한 규칙을 에이전트에게 주세요.

이 위에 무언가를 만들기 전에 알아 둘 만한 제한이 두 가지 더 있습니다. MCP와 함께 제공되는 HTTP 인터페이스는 버전 관리가 되지 않으며 안정성을 보장하지 않습니다. 저희 웹 앱과 확장 프로그램이 호출하는 인터페이스라서, 그쪽에서 필요하면 바뀝니다. 그리고 타입이 지정된 SDK가 없습니다. 규모 있는 무언가를 만든다면 HTTP 인터페이스 대신 MCP를 쓰시고, 무엇을 만드는지 알려 주세요. 무언가 바뀌기 전에 미리 알려 드리겠습니다.

더 작은 요점

모든 에이전트가 모든 것을 저장해야 한다는 식의 주장도 있습니다. 그것은 틀렸고, 잡음으로 가득 차 검색을 더 나쁘게 만드는 라이브러리를 낳습니다.

쓸모 있는 버전은 더 좁습니다. 에이전트가 실제로 노력이 든 무언가를 알아냈을 때, 즉 근본 원인, 버전 제약, 설계 결정과 그 대안이 밀려난 이유 같은 것을 알아냈을 때, 그 발견은 세션보다 오래 남을 가치가 있습니다. 그런데 지금은 대개 세션보다 오래 남지 못합니다. 쓸 수 있는 라이브러리가 있느냐가 배우는 에이전트와 다시 배우는 에이전트를 가릅니다.

그것을 BrainTube 위에 만들든 다른 곳에 만들든, 그보다 중요한 것은 이 빈틈이 있다는 사실을 알아차리는 일입니다. 오늘날 코딩 에이전트를 쓰는 사람 대부분은 아직 알아차리지 못했습니다. 산출물은 살아남고, 이해가 사라지는 것은 같은 조사가 두 번 반복되는 것을 직접 보기 전까지는 눈에 보이지 않기 때문입니다.

BrainTube의 현재 위치

주장의 경계를 분명히 하자면, BrainTube의 MCP 서버는 읽기·쓰기 서버이고, 라이브러리 전체를 아우르는 서버 하나이며, 무료를 포함한 모든 요금제에 포함됩니다. 연결 가이드에 44개 도구 전부와 클라이언트별 설정 방법이 나와 있습니다.

할 수 없는 것도 함께 말해야 합니다. 서버 하나가 라이브러리 전체를 아우르므로, 클라이언트의 범위를 라이브러리의 일부로 제한할 수 없습니다. 원하는 모델을 직접 가져와 쓰는 옵션도, 타입이 지정된 SDK도 없습니다. 네이티브 모바일 앱도 없습니다. 여기서 설명한 것 중 특정 요금제에서만 쓸 수 있는 것은 없습니다. 저장은 무료이고, 어시스턴트가 실행하는 검색과 질문은 요금제의 허용량까지 무료이며 그 이후에는 크레딧이 듭니다. 현재 허용량은 요금제 페이지에서 확인할 수 있습니다. 에이전트를 사람 없이 돌린다면, 가장 먼저 부딪힐 제약은 기능 제한이 아니라 이 사용량입니다.

이 수치를 확인한 방법

도구 이름, 인용한 도구 설명, bulk_ingest의 50개 항목 제한은 2026년 9월 5일에 brain-tube.com/connect.md에 있는 BrainTube 연결 가이드에서 읽었습니다. 이 페이지는 MCP 서버에서 직접 생성됩니다. 도구 개수 44개는 같은 날 그 페이지의 도구 표를 센 것입니다. 설정 블록은 같은 페이지에서 그대로 옮겼습니다. 크레딧 허용량과 무료 요금제 수치는 같은 날 읽은 brain-tube.com/pricing에서 가져왔습니다. 이 수치에 의존하기 전에 현재 요금을 확인하세요.

안정성과 SDK에 관한 주의 사항은 같은 날 brain-tube.com/developers에서 인용했습니다.

내용이 오래되어 맞지 않는 부분이 있다면 알려 주세요. 날짜를 밝혀 바로잡겠습니다.