Codex에 블루베리 MCP 연결하기

준비할 것

이 안내는 Apple Silicon Mac에서 실행하는 Codex와 Blueberry Desktop의 로컬 연결을 다룹니다. 다른 기기의 Codex나 클라우드 작업에도 같은 설정이 자동으로 적용된다는 뜻은 아닙니다.

블루베리 설치 안내에 따라 Desktop을 설치하고 로그인한 뒤 워크스페이스를 선택하세요. 에이전트 연결에서 Codex를 선택하고, 필요한 로컬 맥락의 범위를 선택합니다.

Codex의 연결 상태 확인하기

Desktop은 설치된 Codex를 확인하고 로컬 MCP 브리지를 설정합니다. 연결 상태를 확인한 뒤 Codex에서 새 작업을 시작하세요. 새 도구가 보이지 않으면 Codex를 다시 실행합니다. Blueberry Desktop은 실행하고 로그인한 상태로 유지합니다.

Codex CLI도 사용 중이라면 터미널에서 codex mcp get Blueberry --json으로 등록된 설정을 확인할 수 있습니다. 설정이 존재하는 것과 실제 조회에 성공하는 것은 별개의 확인 단계입니다. 사용하는 Codex 환경이 다르면 Desktop에서 연결한 환경과 같은지 먼저 확인하세요.

프로젝트 기록을 읽고 작업 이어가기

코드를 수정하기 전에 이전 결정과 그 이유를 먼저 조회하도록 요청해보세요. 아래 프로젝트 이름을 실제 저장한 이름으로 바꾸면 됩니다. 블루베리에 저장되거나 수집된 기록만 검색 대상이 됩니다.

답변의 출처를 열어 프로젝트가 맞는지 확인하세요. 예전 결정과 최신 기록이 충돌한다면 날짜뿐 아니라 변경 이유와 대체된 결정을 함께 확인하도록 요청합니다.

Blueberry에서 ‘우리 프로젝트’의 구현 결정과 남은 작업을 찾아줘. 관련 기록을 읽고 출처를 보여준 다음, 오늘 이어서 할 작업을 제안해줘. 아직 코드는 변경하지 마.

다른 에이전트의 맥락이 보이지 않을 때

Claude와 Codex가 같은 Blueberry 워크스페이스에 연결되어 있는지 확인하세요. 다른 워크스페이스의 기록은 함께 검색되지 않습니다.

찾으려는 Claude 대화나 기록이 실제로 블루베리에 들어왔는지도 확인합니다. 연결할 에이전트를 선택하는 단계와 과거 대화를 가져오는 단계는 서로 다릅니다. 저장된 제목이나 문구로 먼저 검색하면 연결 문제와 검색어 문제를 구분하기 쉽습니다.