Claude Code에 blueberry MCP 연결하기

준비할 것

이 안내는 Apple Silicon Mac에서 Claude와 blueberry Desktop을 함께 사용하는 경우를 다룹니다. Claude 앱을 설치하거나 최신 버전으로 업데이트한 뒤 blueberry에서 연결 상태를 확인하세요.

blueberry 앱을 다운로드하고 실행한 뒤 앱에서 로그인하세요. 사용자마다 ‘이름의 허브’라는 개인 공간이 기본으로 준비되며, 다른 사람을 초대할 수 없습니다. 에이전트 연결에서 Claude를 선택하고 가져올 로컬 대화와 기록의 범위도 직접 선택합니다.

Claude Code 연결 확인하기

blueberry Desktop은 Claude Code의 사용자 범위에 로컬 MCP 브리지를 설정합니다. 연결 설정에는 브리지 실행 경로와 허브 식별자가 들어갑니다. blueberry 비밀번호나 API 키를 채팅에 붙여넣을 필요는 없습니다.

Desktop에서 Claude 연결 상태를 확인한 뒤 Claude Code의 새 대화를 시작하세요. 기존 대화에 새 도구가 나타나지 않으면 Claude Code를 다시 실행합니다. 조회 중에는 blueberry Desktop을 실행하고 로그인 상태를 유지하세요.

첫 맥락 조회하기

연결 상태 확인에 이어, 실제로 저장한 내용이 읽히는지 확인합니다. 아래의 프로젝트 이름을 본인 프로젝트로 바꿔 Claude Code에 요청하세요. 허브가 비어 있다면 먼저 blueberry에 기록을 저장하거나 선택한 대화를 가져와야 합니다.

성공 기준은 답변에 실제 저장된 내용과 확인 가능한 출처가 함께 나오는 것입니다. 에이전트가 원문을 열어 확인했는지도 살펴보세요.

blueberry에서 ‘우리 프로젝트’의 최근 결정과 다음 할 일을 찾아줘. 관련 원문을 읽고 출처와 함께 정리해줘. 찾지 못한 내용은 추측하지 말고 알려줘.

Claude가 보이지 않거나 검색 결과가 없을 때

연결 화면에서 Claude를 찾지 못하면 Claude 앱을 설치하거나 업데이트한 뒤 다시 확인하세요. Claude 연결이 보이면 눌러 Claude의 공식 연결 절차를 마치면 됩니다. blueberry는 Claude 채팅 창의 로그인 정보를 복사하지 않습니다.

도구는 보이지만 결과가 없다면 연결된 허브, 가져오기로 선택한 대화 범위, 수집 완료 여부를 확인하세요. 제목이나 고유한 문구로 검색 범위를 좁혀보세요. MCP 연결만으로 모든 과거 대화가 자동으로 저장되는 것은 아닙니다.