Codex로 MCP를 설정하면 어떤 도구도 보이지 않을 것입니다. 먼저 서버가 현재 클라이언트에서 로드되었는지 확인하고, 시작, 인증, 도구 필터링을 확인하세요. 설정을 바로 삭제하고 재설치하지 마세요; 대부분의 문제는 codex mcp list 또는 TUI에서 /mcp 확인하고 명확한 재시작을 통해 찾을 수 있습니다.
1단계: 수정이 동일한 구성인지 확인하기
코덱스 앱, CLI, IDE 확장 기능은 코덱스 구성을 공유하며, 기본 위치는 ~/.codex/config.toml입니다; 신뢰할 수 있는 프로젝트도 .codex/config.toml을 사용할 수 있습니다. 다른 CODEX_HOME이 설정되었거나 구성 파일이 변경되면 현재 클라이언트가 다른 파일을 읽을 수 있습니다. 먼저, 다음과 같이 진행하세요:
codex mcp list목록에 타겟 이름이 없다면, 현재 환경에서는 해당 구성이 읽히지 않았다는 의미입니다.
2단계: 클라이언트가 재로드하게 합니다
코덱스 앱에서 MCP를 저장한 후, 재시작을 클릭하세요; IDE 확장 기능을 위해 Restart 확장 프로그램을 선택하세요. CLI에서 새 세션을 시작한 후, TUI에서 /mcp을 입력하여 서버 상태와 공개된 도구를 확인하세요. config.toml만 수정하고 이전 세션을 계속 사용하면 도구 목록이 새로고침되지 않을 수 있습니다.
3단계: 시작 실패와 인증 실패를 구분
STDIO 서버는 로컬 명령어, 매개변수, 작동 디렉터리, 환경 변수에 의존합니다. 구성 설정에서 시작 명령을 같은 터미널로 복사해서 직접 실행하세요; 프롬프트가 존재하지 않거나 의존성이 없다면, 먼저 PATH와 런타임 환경을 복구하세요. HTTP 서버가 OAuth가 필요할 때, 다음과 같은 실행을 수행합니다:
codex mcp login <服务器名称>승인 후 클라이언트를 재시작하세요. 서버가 느리게 시작하면 startup_timeout_sec 개선될 수 있습니다; 기본 시작 대기 시간은 단 10초입니다.
4단계: 도구가 필터링되었는지 확인
설정 항목 enabled = false 서버 전체를 비활성화enabled_tools 나열된 도구만 허용하며, 허용된 목록 이후에도 도구를 계속 제외disabled_tools 됩니다. 서버가 연결되어 있지만 도구 수가 0일 때는 모델을 의심하기보다는 이 세 가지 항목을 우선적으로 점검하세요.
도구가 여전히 사용 불가능하다면, /mcp, 시작 명령 오류, 서버 로그로 표시되는 상태를 유지하세요. 이 세 가지 항목은 "구성 불가", "프로세스 시작 불가", "권한 미완료", "도구 필터링됨"을 명확히 구분할 수 있습니다. 이후 복구는 해당 계층만 처리합니다.
