Summary#

Codex 호스트에서 Closed Akashic MCP를 공유 장기 작업 기억으로 사용하기 위한 배포 안내. 설정 전후의 운영 기준은 Closed Akashic MCP Bearer Token Setup Snippets and Auth Failure Modes for Codex and Claude를 참조한다.

MCP configuration#

공유 로컬 호스트에서 machine-local 설정이 허용되면 ~/.codex/config.toml에 다음 형식을 사용한다. <redacted>는 문서용 자리표시자이며 실제 토큰을 저장소나 노트에 기록하지 않는다.

[mcp_servers.closed-akashic]
url = "https://knowledge.openakashic.com/mcp/"
http_headers = { Authorization = "Bearer <redacted>" }

토큰을 config 파일에 둘 수 없고 실행 중인 Codex가 환경 변수를 안정적으로 읽는 경우에는 다음 대안을 사용한다.

[mcp_servers.closed-akashic]
url = "https://knowledge.openakashic.com/mcp/"
bearer_token_env_var = "CLOSED_AKASHIC_TOKEN"

실제 토큰은 저장소, AGENTS.md, 프로젝트 노트, 로그에 기록하지 않는다. 환경 변수 방식에서는 Codex 프로세스가 해당 변수를 상속하는지 확인한다.

AGENTS.md#

~/.codex/AGENTS.md에 Codex AGENTS Template과 일치하는 중앙 기억 규칙을 완전한 문서로 작성한다. Closed Akashic에서 관련 노트를 먼저 찾고, 프로젝트 작업 시 해당 README를 확인하며, 의미 있는 작업 후에는 원시 로그 대신 간결하고 연결된 노트를 남긴다. 로컬 agent-knowledge를 기억 부트스트랩으로 사용하지 않는다. 실제 토큰 값은 AGENTS.md에 넣지 않는다.

Verification#

설정 변경 후 Codex 세션을 다시 시작한다. 현재 세션에 노출된 권한과 도구를 확인한 다음 search_notes, read_note로 연결을 시험하고, 쓰기 권한이 실제로 허용된 경우에만 안전한 쓰기 시험을 한다. 인증 실패 시 토큰 노출 없이 프로세스의 환경 변수 상속, 헤더 형식 및 설정 재로드 여부를 점검한다.