Xcode 27.1 ACP Agent는 어떻게 연결하나요? 2026 설정 가이드

Apple의 출시 기록에는 Xcode 27.1이 2026년 10월 15일 공개된 것으로 표시됩니다. Apple Xcode 출시 기록

증상: Xcode에서 Agent를 쓰려는데 ACP와 MCP 중 어느 경로를 골라야 할지 불분명합니다.
빠른 판단: Xcode 안에서 호환 Agent를 선택하려면 ACP를 설정하고, 외부 Agent가 Xcode 도구를 호출하려면 MCP를 설정하세요. 두 방식 모두 빌드와 배포 검수를 대신하지 않습니다.

이 글은 Apple 플랫폼 개발자, Agent 도구 개발자, 프로젝트 유지보수자, CI 및 보안 담당자를 위한 점검 절차입니다.
마지막 업데이트: 2026년 10월 17일. Apple의 출시 기록과 Xcode 시스템 요구 사항, Agent 설정 및 ACP 공식 문서를 기준으로 확인했습니다. Xcode 시스템 요구 사항

SECTION 01Apple 플랫폼 개발자: 먼저 버전과 실행 호스트를 확인하세요

Xcode 27.1이 설치되어 있다는 사실만으로 ACP Agent를 실행할 수 있다고 단정하지 마세요. Xcode 버전과 실행 중인 macOS의 호환성을 Apple의 시스템 요구 사항에서 확인한 다음, 실제로 사용하는 Xcode의 Agent 설정 화면에서 현재 제공되는 항목을 확인해야 합니다. 설정 화면과 지원 조건은 업데이트에 따라 달라질 수 있으므로, 예전 안내의 메뉴 이름이나 경로를 그대로 적용하지 마세요.

원격 Mac을 고려한다면 먼저 해당 호스트에서 필요한 Xcode와 macOS 조합을 사용할 수 있는지, 접속 후 프로젝트를 열고 Agent 작업을 확인할 수 있는지를 점검하세요. 현재 제공되는 구성이나 접속 방식은 임의로 가정하지 말고, 선택하려는 서비스의 실제 안내에서 검증해야 합니다.

판단 조건

Xcode 안에서 호환 Agent를 선택해 대화형으로 쓰려면 ACP 설정으로 진행합니다.
이미 외부에서 실행 중인 Agent가 Xcode의 도구를 호출해야 한다면 MCP 경로를 확인합니다.
Agent 연결이 주목적이어도 자동화 빌드가 필요하다면 CI 검수 절차를 별도로 유지합니다.
Xcode 또는 macOS 호환 조건을 확인할 수 없다면 설정을 진행하지 말고, 요구 사항을 먼저 해결합니다.

SECTION 02Agent 도구 개발자: ACP 역할과 초기화를 분리하세요

ACP는 Agent Client Protocol을 뜻합니다. Xcode는 이 경로에서 클라이언트 역할을 하고, 연결 대상은 ACP에 맞춰 동작하는 Agent입니다. 따라서 “ACP를 지원한다”는 설명만으로 Xcode에서 바로 실행된다고 단정할 수는 없습니다. Agent가 지원하는 프로토콜 동작과 실행 방법을 해당 도구의 공식 문서에서 대조해야 합니다.

ACP 공식 문서는 초기화와 세션 설정을 별도 단계로 다룹니다. 초기화 절차와 세션 설정을 확인해 클라이언트와 Agent가 어떤 정보를 주고받아야 하는지 검토하세요. 초기화가 완료됐다는 기록과 이후 세션에서 프로젝트 맥락을 제대로 처리한다는 증거는 구분해야 합니다.

또한 ACP라는 약어만 보고 다른 프로토콜이나 독자 구현과 동일하다고 보지 마세요. 구현체가 공식 프로토콜의 어느 부분을 지원하는지, Xcode에서 기대하는 실행 방식과 맞는지, 필요한 기능이 실제 세션에서 작동하는지 각각 확인해야 합니다.

SECTION 03프로젝트 유지보수자: 작업 공간 접근을 단계별로 확인하세요

연결 여부만 확인하면 프로젝트 검증이 끝난 것이 아닙니다. Agent가 엉뚱한 저장소를 보거나 예상하지 않은 권한을 사용할 수 있으므로, 작업 공간과 권한을 먼저 좁혀야 합니다.

첫 단계: Agent 추가 정보를 확인합니다.
Xcode의 Agent 설정에서 추가 기능을 찾고, 현재 화면이 요구하는 시작 정보를 확인합니다. 실행 파일 위치, 인수, 환경 값 등을 요구하는 경우에는 임의 값을 넣지 말고 Agent 공식 설치 안내와 비교합니다. 실제 입력 항목은 사용하는 Agent와 Xcode 설정 화면의 안내를 기준으로 합니다.

다음 단계: 프로젝트 맥락을 준비합니다.
검증할 저장소나 작업 공간을 Xcode에서 열고, Agent가 접근해야 할 범위가 그 프로젝트와 일치하는지 확인합니다. 여러 프로젝트를 동시에 열어 둔 상태라면 검증 대상이 혼동되지 않도록 필요한 작업 공간만 남기세요.

그다음 단계: 위험이 낮은 요청으로 시험합니다.
코드 변경, 파일 삭제, 자격 증명 열람을 요청하기 전에 읽기 전용으로 프로젝트 구조나 특정 파일의 역할을 설명하게 합니다. 응답이 실제로 열린 프로젝트에 근거하는지 확인합니다.

마지막 단계: 두 결과를 따로 기록합니다.
Agent가 시작되고 세션을 만들었는지는 연결 결과로 기록합니다. 프로젝트를 올바르게 읽었는지, 필요한 기능을 실행했는지는 별도의 작업 검증으로 남깁니다. 한쪽이 성공해도 다른 쪽을 통과 처리하지 마세요.

SECTION 04외부 Agent를 쓰려면 ACP와 MCP 중 무엇을 선택해야 하나요?

두 경로는 Agent의 위치와 호출 방향이 다릅니다. 외부 Agent가 Xcode의 기능을 도구처럼 사용하려는 경우에는 Apple의 외부 Agent에서 Xcode 도구를 사용하는 안내를 따라 MCP 구성을 확인합니다. 이것은 Xcode 안에 ACP Agent를 등록하는 절차와 별개입니다.

확인 항목	ACP 경로	MCP 경로
Agent가 쓰이는 위치	Xcode에서 선택하는 호환 Agent	Xcode 외부에서 실행되는 Agent
연결의 목적	Xcode와 Agent 사이의 대화형 작업	외부 Agent가 Xcode 도구를 호출
우선 확인할 문서	Xcode Agent 설정과 Agent의 ACP 지원 안내	Apple의 외부 Agent 및 Xcode 도구 안내
성공으로 볼 최소 기준	Agent 세션이 시작되고 프로젝트 맥락을 확인	외부 Agent에서 필요한 Xcode 도구가 호출됨
별도로 남길 검수	프로젝트 접근과 허용 기능	도구 결과와 권한, 이후 빌드 결과

선택은 사용하려는 시작점으로 결정하세요. Xcode에서 Agent를 고르고 싶으면 ACP 지원 여부부터 확인합니다. 이미 사용 중인 외부 Agent에 Xcode 기능을 제공하려면 MCP 구성을 검토합니다. 두 요구가 모두 있다면 한 경로가 다른 경로를 자동으로 대신한다고 가정하지 말고 각각 시험하세요.

SECTION 05CI 엔지니어: Agent 대화와 빌드 승인을 분리하세요

ACP 세션이 시작되거나 MCP 도구가 호출됐다는 사실은 자동화 빌드가 성공했다는 뜻이 아닙니다. Agent 연결, Xcode 도구 사용, CI의 빌드 및 테스트는 서로 다른 결과물로 관리해야 합니다.

검수 대상	확인할 증거	통과 판정에 쓰지 말아야 할 증거
Agent 연결	세션 시작 여부와 Agent가 받은 프로젝트 맥락	Xcode 설정에 등록된 화면만 확인
Xcode 도구 호출	요청한 도구와 반환 결과, 실행 주체	ACP Agent가 응답했다는 사실
CI 빌드 및 테스트	실제 프로젝트의 작업 결과, 테스트 결과, 산출물 전달	Agent가 코드를 읽거나 수정했다는 기록

실제 저장소에서 CI 작업을 별도로 실행하고, 빌드와 테스트 결과가 의도한 대상에 해당하는지 확인하세요. 서명이나 산출물 전달이 배포 경로에 포함된다면 해당 단계도 독립된 승인 기준으로 둡니다. 대화형 작업이 편리하더라도 파이프라인에서 재현할 수 없는 작업은 자동 승인 근거가 될 수 없습니다.

SECTION 06플랫폼 및 보안 담당자: 권한과 원격 사용 조건을 제한하세요

Agent에 부여할 수 있는 프로젝트 접근 범위, 실행 가능한 도구, 계정 권한을 먼저 목록으로 만드세요. 시험 단계에서는 필요한 프로젝트와 작업만 허용하고, 비밀 값은 불필요하게 프롬프트나 실행 인수에 노출하지 않습니다. Agent가 사용하는 자격 증명은 CI나 개발자 계정과 섞이지 않도록 별도 관리하는 편이 안전합니다.

실패 원인을 찾을 때 권한을 한꺼번에 확대하지 마세요. 설정에 필요한 실행 정보가 잘못됐는지, Xcode와 Agent 사이의 초기화가 끝나지 않았는지, 열린 작업 공간이 다른지 순서대로 좁혀야 합니다. 연결 실패와 프로젝트 접근 실패를 구별하면 어떤 권한을 점검할지 명확해집니다.

점검 영역	확인할 조건	보류해야 하는 경우
실행 환경	필요한 Xcode와 macOS 조합을 공식 요구 사항에서 확인	호환 여부를 확인할 근거가 없음
접근 범위	검증 대상 프로젝트와 허용 도구를 특정	프로젝트 전체나 계정 권한이 불필요하게 열림
재현성	같은 설정으로 세션과 작업을 다시 확인	시작 정보나 권한이 담당자마다 다름
CI 승인	프로젝트 빌드와 테스트를 별도 실행	Agent 연결만으로 빌드 통과를 선언

SECTION 07자주 묻는 질문

Xcode 27.1에 ACP Agent를 등록하려면 어디부터 확인해야 하나요?
설치 버전과 macOS 호환 조건을 먼저 확인하세요. 그다음 Xcode의 Agent 설정 화면에서 추가 항목과 요구되는 시작 정보를 살펴보고, Agent 공식 안내와 대조합니다. Agent 등록 뒤에는 열린 작업 공간에서 범위가 작은 읽기 작업을 실행해 프로젝트 맥락이 제대로 전달되는지 확인해야 합니다.
Agent를 추가했는데 표시되지 않거나 시작에 실패하면 어떻게 하나요?
Xcode와 macOS 호환성, Agent의 ACP 지원 범위, 실행 위치와 계정 권한을 차례로 점검하세요. 설정 화면에서 요구하는 시작 정보는 Agent 공식 안내와 비교합니다. 연결만 성공하고 프로젝트를 읽지 못할 수도 있으므로 작업 공간을 확인한 뒤 읽기 작업으로 다시 검증하세요. 진단을 위해 권한을 먼저 확대하지 마세요.
ACP와 외부 Agent의 MCP 연결은 어떤 점이 다른가요?
ACP는 Xcode 안에서 호환 Agent를 사용하는 연결입니다. MCP는 외부에서 실행 중인 Agent가 Xcode의 도구를 이용하도록 구성하는 경로입니다. 따라서 Agent가 어디에서 실행되고 누가 도구를 호출하는지에 따라 선택이 달라집니다. 어느 한쪽을 설정했다고 다른 쪽까지 자동으로 준비되는 것은 아닙니다.
Agent 연결이 되면 CI 빌드도 통과했다고 볼 수 있나요?
그렇게 볼 수 없습니다. 연결은 대화형 세션의 상태일 뿐이며, 프로젝트 빌드와 테스트, 서명, 산출물 전달을 증명하지 않습니다. 실제 저장소와 CI 경로에서 해당 작업을 별도로 실행하고 결과를 기록하세요. Agent의 응답이나 도구 호출을 자동화 빌드의 통과 근거로 사용하지 마세요.

ACP와 MCP 중 어느 경로를 택하든, 현재 실행 환경의 호환성과 프로젝트 접근 범위를 먼저 확인해야 합니다. 기존 로컬 개발 방식은 장비 관리와 실행 환경 유지 부담이 있고, 일반 클라우드 서버는 macOS 전용 Xcode 작업을 그대로 대체하지 못합니다. 반대로 원격 Mac도 필요한 버전과 접근 방식이 제공되는지 확인하지 않고 선택하면 검증이 막힐 수 있습니다.

먼저 MACNOX의 원격 Mac 개발 환경 안내에서 작업에 맞는 이용 조건을 확인하고, 한국 이용 정보와 요금 안내를 검토하세요. 실제 Xcode 실행이 필요하고 현재 안내된 조건이 요구 사항에 맞는 경우에만 한국용 원격 Mac 옵션을 살펴보세요. 안정적인 장기 실행이나 물리 장비 접근이 필수라면 구매 또는 자체 운영이 더 적합할 수 있습니다.