실행 위치는 MCP가 접근해야 할 자원이 있는 곳을 기준으로 정합니다. 원격 문서나 공유 데이터만 제공하는 HTTP MCP는 접근 가능한 서비스 환경에 둘 수 있고, 프로젝트 파일이나 로컬 명령이 필요한 stdio MCP는 Codex CLI의 실행 환경 가까이에 둡니다. Xcode나 macOS 전용 도구가 필요한 작업만 Mac에서 실행하도록 구성합니다.
이 글은 Codex CLI에 MCP를 연결하려는 독립 개발자, 팀과 CI의 실행 경계를 정리하는 DevOps 엔지니어, Xcode 작업을 Agent에 맡기려는 Apple 플랫폼 개발자를 위한 안내입니다.
Codex CLI MCP 배포는 자원 접근 위치부터 나눕니다
Codex CLI는 MCP 도구 호출을 시작하는 클라이언트이고, MCP 서버는 도구와 데이터를 제공합니다. 따라서 서버에 연결할 수 있다는 사실만으로 다른 컴퓨터의 프로젝트 파일까지 읽을 수 있는 것은 아닙니다. Codex CLI가 어느 컴퓨터에서 실행되는지, 도구 프로세스가 어떤 파일 경로를 보는지 함께 확인해야 합니다. Codex CLI 공식 저장소는 CLI가 로컬 컴퓨터에서 실행되는 도구임을 설명하며, Codex 설정 안내는 MCP 서버 설정을 다룹니다.
| 필요한 작업 | MCP 방식과 위치 | 판단 근거 |
|---|---|---|
| 원격 문서 조회, 공용 읽기 전용 데이터 | HTTP MCP를 접근 가능한 서비스 환경에 배치 | Codex에서 원격 HTTP 문서 서버를 설정하는 공식 예제가 있습니다. |
| 현재 작업 폴더의 파일 읽기, 로컬 명령 실행 | stdio MCP를 Codex CLI와 같은 실행 환경에 배치 | stdio는 로컬 프로세스를 시작하는 방식이므로 해당 프로세스가 보는 파일과 명령이 기준입니다. |
| Xcode 또는 macOS 전용 도구 호출 | 필요한 도구와 작업을 Mac에서 실행 | Xcode 명령 줄 도구와 macOS 환경이 실행 조건에 포함됩니다. |
| 팀 공용 기능과 저장소별 작업을 함께 운영 | 공유 HTTP 서비스와 실행 환경별 MCP를 조합 | 공용 기능과 작업 폴더 접근을 분리해 권한과 실행 위치를 따로 검증할 수 있습니다. |
MCP 전송 방식 명세는 stdio와 Streamable HTTP를 서로 다른 전송 방식으로 설명합니다. 이는 배포 위치에 대한 일괄 규칙이 아니라, MCP 서버가 어떤 실행 환경과 자원에 의존하는지 따져야 한다는 뜻입니다.
문서 조회는 HTTP로 분리하고 권한을 확인합니다
문서 검색처럼 서버가 제공하는 원격 데이터만 필요한 경우에는 MCP 서버와 개발용 Mac을 같은 장비에 둘 필요가 없습니다. Codex 공식 문서 MCP 예제는 HTTP 방식으로 문서 서버를 설정하는 예를 보여 줍니다. 이 예제가 읽기 전용 문서 서비스라는 점은 중요합니다. 모든 MCP 서버가 같은 권한이나 데이터 접근 범위를 가진다는 의미는 아닙니다.
Codex CLI가 원격 MCP에 연결되면 원격 Mac의 프로젝트 파일도 자동으로 읽을 수 있나요?
그렇지 않습니다. HTTP 연결은 MCP 서버에 요청을 전달할 뿐, 원격 Mac의 작업 폴더를 Codex CLI의 로컬 폴더처럼 만들어 주지 않습니다. 원격 파일이 필요하다면 Codex CLI와 파일을 읽는 도구를 그 Mac에서 함께 실행하거나, 권한을 제한한 별도 파일 접근 도구를 구성해야 합니다.
배포 전에 다음 항목을 확인합니다.
- [ ] Codex CLI 실행 환경에서 MCP 서버 주소에 네트워크로 도달할 수 있습니다.
- [ ] 인증 정보는 필요한 사용자나 작업에 한정해 전달합니다.
- [ ] 읽기 전용인지, 쓰기나 명령 실행도 가능한지 확인합니다.
- [ ] 연결 테스트와 실제 데이터 권한 테스트를 따로 수행합니다.
Codex의 MCP 서버 설정 참고 자료에서 설정 필드와 실행 옵션을 확인하고, 네트워크 연결 성공을 데이터 접근 승인으로 간주하지 않습니다.
프로젝트 파일과 로컬 명령은 실행 환경 가까이에 둡니다
stdio MCP는 Codex CLI가 로컬 프로세스를 시작해 통신하는 방식입니다. 설정에 실행 명령과 인수를 둘 수 있으므로, 서버 프로세스가 실제로 어느 호스트에서 뜨는지를 먼저 확인해야 합니다. Codex 설정 자료의 서버 실행 옵션과 환경 변수 항목을 기준으로 명령, 인수, 환경 변수를 점검합니다.
| 작업 환경 | Codex CLI 실행 위치 | stdio MCP 실행 위치 | 확인할 파일 범위 |
|---|---|---|---|
| 개발자가 로컬 프로젝트에서 작업 | 개발자 컴퓨터 | 같은 컴퓨터 | 로컬 작업 폴더와 로컬 명령 |
| 저장소가 원격 Mac에 있고 그곳에서 작업 | 원격 Mac의 터미널 세션 | 같은 원격 Mac | 원격 작업 폴더와 Mac에 설치된 명령 |
| 로컬 Codex에서 원격 프로젝트를 사용 | 로컬 컴퓨터 | 로컬 프로세스라면 로컬 파일만 확인 가능 | 원격 파일은 명시적인 원격 접근 도구가 있어야 함 |
Codex CLI는 로컬에 두고 MCP만 원격 Mac에서 실행해도 원격 프로젝트를 다룰 수 있나요?
MCP 서버가 원격 Mac에서 실행된다는 이유만으로 작업 폴더가 공유되지는 않습니다. 원격 서버가 파일 도구를 제공하고 해당 도구가 인증된 경로에 접근하도록 설계된 경우에만 가능합니다. 반대로 개발 환경 전체가 원격 Mac에 있다면 Codex CLI와 stdio MCP를 그 Mac에서 실행하는 편이 파일 경로와 명령 실행의 경계를 명확하게 합니다.
Xcode 작업은 Mac의 도구 실행까지 검증합니다
MCP는 도구 호출을 연결하는 방식이지, 서버가 어떤 운영 체제 기능을 얻는지를 정하는 장치는 아닙니다. Xcode 또는 macOS SDK에 의존하는 도구는 해당 Apple 도구 체인이 설치된 Mac에서 실제 실행되어야 합니다. Apple은 Xcode 명령 줄 도구 안내에서 xcodebuild 같은 도구의 설치 조건을 설명하고, 활성 개발자 디렉터리 설정 문서에서 사용할 Xcode 위치를 지정하는 방법을 안내합니다.
따라서 Xcode MCP를 Mac에 배포하는 것만으로 검증을 끝내면 안 됩니다. 도구 프로세스가 의도한 Mac에서 실행되는지, 활성 개발자 디렉터리가 올바른지, 작업 계정이 필요한 프로젝트와 도구에 접근할 수 있는지 확인합니다. Apple의 CI에서 앱과 Swift 패키지를 빌드하는 안내도 빌드 작업을 수행하는 환경에서 Xcode 도구 체인을 점검하는 근거가 됩니다. 이 문서들은 특정 원격 Mac의 성능을 보장하지는 않습니다.
Xcode나 macOS 도구를 호출하는 MCP는 반드시 Mac에서 실행해야 하나요?
MCP 서버 자체가 언제나 Mac을 요구하는 것은 아닙니다. 다만 서버가 xcodebuild, macOS SDK 또는 Mac에 있는 파일을 직접 사용한다면 해당 명령과 자원이 있는 Mac에서 실행해야 합니다. 원격 서비스가 요청을 받아 Mac의 실행 작업으로 전달하는 구성도 가능하지만, 이때는 실제 작업이 어느 Mac에서 수행되는지와 그 실행 권한을 별도로 확인합니다.
팀 공유는 서비스와 작업 실행을 분리해 검증합니다
팀에서 공통 문서나 제한된 조회 기능을 제공할 때는 HTTP MCP를 중앙 서비스로 운영할 수 있습니다. 하지만 저장소를 읽거나 빌드 명령을 실행하는 도구는 실행 주체와 작업 폴더가 필요합니다. 공용 서버가 있다는 사실만으로 팀원의 프로젝트 파일이나 CI 작업 공간이 그 서버에 전달되는 것은 아닙니다.
혼합 구성에서는 공용 HTTP MCP가 공유 데이터만 제공하고, 저장소별 stdio MCP가 각 작업 환경에서 실행되도록 역할을 나눕니다. Codex CLI 설정에서 서버 주소와 실행 명령을 구분하고, 서버마다 인증과 도구 권한을 확인합니다. 원격 Mac은 작업 환경을 제공할 수 있지만, 그 자체가 사용자나 프로젝트 사이의 보안 격리를 보장하지는 않습니다.
조건에 따라 본기, 원격 Mac, 혼합 구성을 선택합니다
아래 조건을 위에서부터 확인하면 배치 위치를 좁힐 수 있습니다.
- 필요한 자원이 원격 문서나 공유 데이터뿐이라면, 네트워크 접근과 인증을 검증한 뒤 HTTP MCP를 서비스 환경에 둡니다.
- 도구가 현재 프로젝트 경로, 로컬 명령 또는 작업 상태에 의존한다면, Codex CLI와 stdio MCP를 같은 작업 환경에 둡니다.
- 도구가 Xcode, macOS SDK 또는 Mac 로컬 자원을 호출한다면, 해당 작업과 도구를 Mac에서 실행합니다.
- 공유 데이터와 프로젝트별 실행이 모두 필요하다면, HTTP 서비스와 환경별 MCP를 나누고 각 권한을 따로 설정합니다.
- 원격 프로젝트 파일이 필요하지만 Codex CLI는 로컬에서 실행 중이라면, 연결 성공만으로 진행하지 않습니다. 원격에서 CLI를 실행하거나 명시적인 원격 파일 도구를 구성하는 쪽으로 되돌아갑니다.
운영 전에 다음 검사를 마칩니다.
- [ ] Codex CLI, MCP 프로세스, 작업 폴더가 각각 어느 호스트에 있는지 기록했습니다.
- [ ] 실제 Codex 호출로 서버 연결뿐 아니라 필요한 파일 읽기와 도구 실행도 확인했습니다.
- [ ] Xcode 작업은 Mac에서 명령을 실행하고 결과를 확인했습니다.
- [ ] 팀 구성에서는 실행 계정, 인증 정보, 도구 권한을 구분해 검증했습니다.
- [ ] 실패했을 때 작업이 중단되는 위치와 로그를 확인할 수 있습니다.
로컬 개발 환경에서 문서 검색과 일반 도구 호출만 한다면 모든 구성을 원격 Mac으로 옮길 이유는 적습니다. 반면 로컬 Windows나 Linux 환경에 Apple 도구 체인이 없고 Xcode 작업이 필요하다면, 로컬 구성은 Mac 전용 실행과 파일 경로 관리에서 제약이 생깁니다. 장기간 계속 쓸 개발 장비는 직접 보유하는 편이 맞을 수 있지만, 일시적인 빌드나 도구 검증 환경이 필요하다면 RUVCLOUD의 원격 Mac을 검토할 수 있습니다. 시작 전에 원격 Mac 요금 안내에서 필요한 이용 조건을 확인하고, 실제 도구 체인과 접근 방식이 작업에 맞는지 살펴보세요.
Xcode 작업을 원격 Mac에서 실행하기로 결정했다면 RUVCLOUD 원격 Mac 이용 안내에서 환경을 확인한 뒤, MCP 서버와 Codex CLI가 같은 작업 파일을 바라보는지 실제 호출로 검증하는 것이 좋습니다.