MCP

nac: 야심 찬 장기 작업을 초점을 잃지 않고 AI 에이전트에 맡기기

AI 에이전트에 장기 작업을 맡기되 통제력을 잃고 싶지 않다면 nac의 오케스트레이터+episode 아키텍처가 가장 적합합니다. 단, 시작 전에 반드시 모델 인증(Arcee 디바이스 코드 로그인 권장)을 완료해야 하며, 오케스트레이터 자체는 명령 실행이나 파일 편집을 할 수 없습니다.

Official source · GitHub - arcee-ai/nac

Install

nac-web upgrade

누구에게 적합한가

  • 대규모·장기 작업을 AI 에이전트에 맡기고 싶지만 에이전트가 통제를 벗어날까 걱정되는 사용자에게 적합합니다: nac는 Arcee가 오픈소스로 공개한 에이전트 실행 프레임워크로, 스레드-에피소드(thread-and-episode) 아키텍처를 채택합니다. 중앙 오케스트레이터가 계획과 작업 분해를 담당하지만, 그 자체로는 명령을 실행하거나 파일을 편집할 수 없고 스레드를 시작하는 것만 가능합니다. 각 스레드가 끝나면 'episode', 즉 구조화된 작업 요약을 반환해 실제로 무엇을 했는지 알려줍니다.
  • 이미 다른 에이전트 도구(harness)를 사용 중이고 nac를 연동하고 싶은 사용자에게 적합합니다: 공식 설명에 따르면 nac는 이식 가능한 onboarding skill과 MCP 통합을 제공하며, 공식이 제공하는 연동 스니펫을 선택한 에이전트 도구에 붙여넣기만 하면 nac 설치, 구성 완료, MCP 연결이 이루어집니다.
  • 명령줄 실행기로 직접 사용하는 것에는 적합하지 않습니다: 오케스트레이터는 대신 명령을 실행하거나 파일을 수정할 수 없으며, 실행은 모두 시작된 스레드 안에서 이루어집니다.
  • 지원되는 구체적인 에이전트 클라이언트 목록, 플랫폼 호환성, 리소스 요구 사항은 근거에서 설명되지 않았으며, 이는 미지의 사항입니다.

3분 만에 첫 시도하기

권장 기본 경로: 공식 설치 프로그램 → 디바이스 코드 로그인 → 로컬 대시보드.

  1. 전제 조건: 근거에서 선행 의존성과 설치 프로그램의 재현 가능한 명령은 설명되지 않았으므로, 공식 README의 설치 안내를 기준으로 하십시오. 설치가 완료되면 nac-web이 설치 프로그램에 의해 $HOME/.local/bin에 들어가며, 필요하다면 해당 디렉터리를 PATH에 추가하십시오.
  2. 모델 인증 선택 — 세션을 시작하기 전에 반드시 완료해야 하는 단계입니다(대시보드에서 나중에 수행할 수도 있습니다). 공식 권장 경로는 Arcee 디바이스 코드 로그인이며, 이를 통해 Latest Open 및 Arcee Trinity 모델을 이용할 수 있습니다:
nac-web arcee-auth login
  1. 프로젝트 디렉터리에서 대시보드를 시작합니다. 성공 신호: 대시보드에 접근 가능하고, 인증이 완료되어 모델을 선택할 수 있는 상태입니다.

이후 업데이트: nac에는 네이티브 업그레이드 기능이 내장되어 있어 최신 안정 버전을 설치할 수 있습니다:

nac-web upgrade

대체 인증 방법(부차적인 안내일 뿐): nac-web codex-auth login으로 ChatGPT 계정을 통해 OAuth 방식으로 OpenAI 모델을 이용하거나, 디렉터리 제공자의 API 키(예: OPENAI_API_KEY)를 내보내는 방법이 있습니다. 주의: 로그인에는 본인의 계정 자격 증명이 관여합니다. 세션을 시작하기 전에 반드시 모델 인증 방식을 먼저 선택해야 합니다. 첫 시도에서는 위험도가 낮고 결과를 관찰할 수 있는 작업 하나만 시작하고, 읽기 전용 성격의 동작을 우선 사용하십시오. episode 속 작업은 스레드가 실행하며, 실제 작업에는 쓰기 작업이 포함될 수 있으므로 중요한 부작용이 발생하기 전에는 확인 절차가 있어야 합니다.

사용 사례

  1. 장기 작업을 위임하고 구조화된 결과를 회수하기: 로컬 대시보드에서 인증된 모델(Arcee 디바이스 코드 로그인 후의 Latest Open 또는 Arcee Trinity 모델 권장)로 세션을 시작하고 작업 하나를 발생시킵니다. 오케스트레이터가 작업을 분해해 스레드를 시작하고, 스레드가 끝나면 episode — 무엇을 완료했는지 설명하는 구조화된 요약 — 를 반환합니다. 기대할 수 있는 결과: 전 과정을 지켜볼 필요 없이 episode를 통해 각 작업 구간의 성과를 파악할 수 있습니다.

  2. nac를 기존 에이전트 도구에 연동하기: 공식은 이식 가능한 onboarding skill과 MCP 통합을 제공하며, 공식이 제공하는 연동 스니펫을 선택한 에이전트 도구에 붙여넣기만 하면 nac 설치, 구성 완료, MCP 연결이 이루어집니다. 근거에서는 특정 에이전트 클라이언트에 대한 단계별 세부 사항을 제시하지 않으므로, 사용 중인 에이전트에서의 실제 동작은 실제 연동 결과를 기준으로 해야 하며, 확인할 수 있는 것은 이 공식 제공 연동 기능이라는 점입니다.

사용 경계

  • 읽기/쓰기 성격: 오케스트레이터 자체는 계획 수립과 스레드 시작만 하며 명령을 실행하거나 파일을 편집하지 않습니다. 실제 실행은 스레드 안에서 이루어지므로 실제 작업에는 쓰기 작업과 명령 실행이 포함될 수 있습니다 — 첫 시도는 관찰 가능한 결과를 내는 작업부터 시작하고, 중요한 부작용이 발생하기 전에는 확인 절차가 있어야 합니다.
  • 인증 요구 사항: 세션을 시작하기 전에 반드시 모델 인증을 완료해야 합니다(nac-web arcee-auth login 디바이스 코드 로그인 권장, 또는 nac-web codex-auth login, 또는 OPENAI_API_KEY 같은 디렉터리 제공자 API 키 내보내기). 무료 한도나 과금 여부는 근거에서 설명되지 않았으며 미지의 사항입니다.
  • 로컬 구성 요소: nac-web은 설치 프로그램에 의해 $HOME/.local/bin에 들어가며, 대시보드는 로컬에서 실행되므로 로컬 상태 쓰기에 해당합니다. 제거 경로에 대한 설명은 근거에서 제공되지 않았습니다.
  • 공식의 명시적 제한: 오케스트레이터는 명령을 실행하거나 파일을 편집할 수 없으며, 스레드를 통해서만 episode 형태의 구조화된 결과를 얻을 수 있습니다.
  • 아직 확인되지 않은 핵심 정보: 구체적으로 어떤 에이전트 클라이언트를 지원하는지, 모델 호출의 비용과 할당량, 스레드 실행의 환경 격리와 권한 경계, 이식 가능한 onboarding skill의 구체적인 설치 명령과 이름은 모두 공식 근거에서 설명되지 않았습니다. 고위험 작업을 맡기기 전에 공식 문서나 저장소에서 이러한 사항을 먼저 확인하고, '설명을 찾지 못했다'는 이유로 '위험이 없다'고 추단하지 마십시오.