코덱스 툴 사용법 05: MCP로 필요한 도구만 연결하기 | DAKER 커뮤니티

코덱스 툴 사용법 05: MCP로 필요한 도구만 연결하기

코덱스를 쓰다 보면 어느 순간 "이 에이전트가 우리 문서, 브라우저, 디자인 파일, 내부 API까지 바로 보면 좋겠다"는 생각이 든다. 이때 무작정 모든 도구를 붙이는 것보다 MCP를 작게 연결하는 편이 안전하다.

OpenAI 공식 Codex 문서 기준으로 MCP는 코덱스에 외부 도구와 컨텍스트를 연결하는 방식이다. CLI와 IDE 확장에서 모두 사용할 수 있고, 설정은 기본적으로 ~/.codex/config.toml에 저장된다. 신뢰한 프로젝트에서는 .codex/config.toml로 프로젝트별 설정도 둘 수 있다.

1. MCP는 "검색 능력"이 아니라 "권한"이다

MCP 서버를 붙이면 코덱스가 새 도구를 호출할 수 있다. 문서 검색 서버, 브라우저 제어 서버, Figma 서버, 사내 API 서버가 모두 후보가 될 수 있다. 하지만 도구가 늘어나는 만큼 실패면도 늘어난다.

좋은 기준은 단순하다.

이 질문에 답하기 어렵다면 아직 MCP로 고정할 단계가 아니다. 한두 번 필요한 일은 그냥 브라우저나 파일로 확인하고, 반복되는 병목만 도구화한다.

2. 처음에는 CLI로 추가한다

공식 문서의 기본 흐름은 codex mcp 명령으로 서버를 추가하고 관리하는 것이다. 예를 들어 개발 문서 검색용 MCP 서버를 붙

5. MCP 결과도 검증 대상이다

도구가 붙었다고 해서 답이 자동으로 맞아지는 것은 아니다. MCP는 컨텍스트를 가져오는 통로이고, 최종 판단은 여전히 검증으로 닫아야 한다.

실무에서는 다음 루프가 안정적이다.

1. /mcp로 서버 상태 확인
2. 작은 질문으로 도구 응답 확인
3. 코덱스에게 변경 범위와 금지 범위 명시
4. 생성된 diff 확인
5. 테스트, 타입체크, 화면 확인 중 필요한 검증 실행
6. 실패한 검증은 완료 보고에 그대로 남기기

Senior takeaway: MCP는 코덱스의 능력을 넓히는 기능이지만, 본질은 권한 관리다. 전역보다 프로젝트별로 작게 시작하고, 비밀값은 환경변수로 빼고, /mcp 상태 확인과 최종 검증을 습관화하면 코덱스는 더 많은 도구를 쓰면서도 작업 경계를 잃지 않는다.일 때는 다음처럼 시작할 수 있다.

codex mcp add context7 -- npx -y @upstash/context7-mcp

추가 후에는 코덱스 TUI에서 /mcp로 활성 서버를 확인한다. 여기서 중요한 것은 "설치가 됐다"가 아니라 "이번 작업에서 실제로 필요한 도구만 켜져 있다"는 점이다.

3. 세밀한 설정은 config.toml에서 관리한다

더 자세한 제어가 필요하면 config.toml에 서버별 테이블을 둔다. OpenAI 문서는 MCP 서버 설정을 [mcp_servers.<server-name>] 형식으로 안내한다.

[mcp_servers.docs]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
startup_timeout_sec = 10
tool_timeout_sec = 60
enabled = true

HTTP 서버라면 url을 쓰고, 인증이 필요하면 토큰 값을 직접 적는 대신 환경변수 이름으로 연결한다. 비밀값을 config.toml이나 AGENTS.md에 붙여 넣는 순간, 편리함보다 사고 가능성이 커진다.

4. 프로젝트별 MCP는 신뢰한 저장소에서만 쓴다

전역 설정은 모든 작업에 따라온다. 반대로 프로젝트별 .codex/config.toml은 해당 저장소에 맞춘 도구를 둘 수 있다. 공식 설정 참고 문서 기준으로 신뢰하지 않은 프로젝트는 프로젝트 로컬 .codex/ 계층을 건너뛴다. 이 동작은 꽤 중요하다.

예를 들어 회사 A의 내부 문서 MCP와 회사 B의 디자인 MCP를 전역에 섞어 두면 코덱스가 작업 맥락을 헷갈릴 수 있다. 프로젝트별로 나누면 "이 저장소에서만 필요한 도구"가 명확해진다.

Redirecting to 코덱스 툴 사용법 05: MCP로 필요한 도구만 연결하기 | DAKER 커뮤니티...