Claude Code에 블루베리 MCP 연결하기

준비할 것

이 안내는 Apple Silicon Mac에서 Claude Code와 Blueberry Desktop을 함께 사용하는 경우를 다룹니다. Claude Code를 먼저 설치하고 실행할 수 있는지 확인하세요. Claude 웹 채팅과 Claude Desktop의 연결 절차를 설명하는 문서는 아닙니다.

블루베리의 설치 안내에 따라 Desktop을 설치하고 로그인하세요. 연결할 워크스페이스를 선택하고, 에이전트 연결에서 Claude를 선택합니다. 가져올 로컬 대화와 기록의 범위도 직접 선택합니다.

Claude Code 연결 확인하기

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

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

첫 맥락 조회하기

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

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

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

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

연결 화면에서 Claude를 찾지 못하면 Claude Code CLI의 설치 상태부터 확인하세요. Claude 앱만 설치한 상태와 Claude Code CLI가 준비된 상태는 다릅니다. 설치 후 Desktop에서 다시 연결을 시도합니다.

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