Mastra Factory: 이슈부터 PR까지 AI 개발

Mastra Factory는 AI 에이전트로 소프트웨어 개발을 진행하는 오픈 소스 환경입니다. 저장소, 작업 접수, 계획, 구현, 풀 리퀘스트 검토를 하나의 흐름으로 연결합니다. 개발자는 작업을 맡기면서도 변경 범위와 계획, 최종 코드 수용 여부를 결정할 수 있습니다.

쉽게 말해 Mastra Factory는 무엇을 하나요?

GitHub에 버그 이슈를 등록했다고 생각해 보세요. 에이전트가 프로젝트를 조사하고 수정 계획을 제안한 뒤 파일을 바꾸고 검사를 실행합니다. 팀은 실제 변경을 확인하고 요구사항을 충족하는지 판단합니다. Factory는 이 과정과 대화를 해당 작업에 연결해 관리합니다.

새 기능 개발, 버그 수정, 리팩터링, 테스트 작성이 대표적인 용도입니다. 결과물은 채팅 속 코드 조각에 그치지 않고 검토할 수 있는 변경 사항과 PR이 될 수 있습니다. 다만 저장소, 모델 접근 권한, 실행 환경을 설정해야 하며 결과를 평가할 개발자의 역할도 필요합니다.

계획과 코드 검토를 분리하는 작업 흐름

Intake, Triage, Planning, Building, Review, Done 단계로 진행되며 작업 유형에 맞게 규칙을 설정할 수 있습니다. 조사 과정에서 팀이 정보를 보충하고, 구현을 시작하기 전에 계획을 수정하거나 승인합니다.

각 작업 항목에는 자체 세션이 있습니다. PR은 별도 검토 항목과 검토 세션을 가지므로 PR 하나를 병합했다고 원래 작업 전체가 완료되는 것은 아닙니다. 여러 PR이 필요한 경우도 있어 최초 수용 기준과 작업 상태를 함께 확인해야 합니다.

기존 GitHub 저장소로 첫 작업 시작하기

공식 시작 안내는 다음과 같은 경로를 제공합니다.

1. 대상 저장소 밖에서 npm create factory@latest my-factory를 실행하고 설정 과정을 마칩니다.
2. .env에 FACTORY_CREDENTIAL_ENCRYPTION_KEY를 한 번 설정합니다. 없다면 안내서의 openssl rand -base64 32로 생성할 수 있습니다. 키를 바꾸면 저장된 인증 정보를 읽지 못할 수 있으므로 안전하게 백업합니다.
3. npm run dev를 실행하고 표시된 주소를 엽니다. GitHub와 모델 제공업체를 연결합니다. Linear는 선택 사항입니다.
4. Settings → Work Intake에서 GitHub 이슈 동기화를 켜고 저장소를 선택합니다. 저장소 접근 허용과 이슈 구독은 별개의 설정입니다.
5. README 설명 추가처럼 작고 수용 기준이 분명한 작업을 만듭니다. 첫 시도에서는 자동 시작과 계획 자동 승인을 꺼 둡니다.
6. 조사 내용을 읽고 질문에 답한 뒤 계획을 검토합니다. 구현 후에는 실제 diff, 도구 출력, PR 검사 결과를 확인하고 기존 팀 절차에 따라 검토와 병합을 진행합니다.

에이전트가 검사를 통과했다고 말하는 것만으로 완료를 판단하지 말고, 어떤 검사가 실행됐고 무엇이 바뀌었는지 확인하는 것이 중요합니다.

로컬 서버와 자체 호스팅의 차이

전체 플랫폼 호스팅, 플랫폼 리소스를 쓰는 로컬 서버, 완전한 자체 호스팅을 선택할 수 있습니다. 로컬 서버도 클라우드 인증, PostgreSQL, 샌드박스를 사용할 수 있어 화면이 로컬에서 열린다는 사실만으로 모든 데이터가 기기에 남는다고 볼 수 없습니다.

--no-platform 구성은 인증, 영구 데이터베이스, 실행 환경을 직접 설정해야 합니다. 운영 환경에는 계속 실행되는 Node.js 프로세스와 스트리밍 응답을 지원하는 HTTPS가 필요합니다. 배포 요구사항을 확인하세요.

모델 접근은 제공업체 계정에 따라 달라지고 개인 및 조직 인증 정보의 범위도 다릅니다. 키를 이슈에 적지 말고 전용 설정에 저장하세요. 비공개 코드에는 개인정보 처리방침과 선택한 모델·샌드박스 서비스의 조건을 함께 검토해야 합니다.

무료 시작과 실제 운영 비용

2026년 9월 10일 확인한 공식 USD 가격은 Starter 월 0달러이며 관측 이벤트 10만 건, CPU 24시간, 데이터 보관 15일을 포함합니다. Teams는 월 250달러, Enterprise는 별도 견적입니다.

이것은 무제한 코딩 작업을 뜻하지 않습니다. 모델 사용, 리소스 초과, 인프라에 비용이 들 수 있습니다. 전체 가격표에서 사용 조건을 확인하세요. 여기서는 원화 환산이나 국내 세금 포함 가격을 제시하지 않습니다. 라이선스 문서에 따르면 대부분은 Apache 2.0이지만 ee/의 기업 기능은 운영 환경에서 유효한 기업 라이선스가 필요합니다.

자주 묻는 질문

기존 프로젝트에 연결할 수 있나요?

가능합니다. GitHub 저장소를 연결하고 이슈 접수를 설정하면 됩니다. Linear는 필수가 아닙니다.

완전히 무료인가요?

오픈 소스와 무료 시작 요금제가 있어도 모델, 호스팅, 초과 리소스, 기업 기능에는 비용이 생길 수 있습니다.

로컬 실행이면 데이터가 외부로 나가지 않나요?

자동으로 보장되지 않습니다. 서버, 인증, 데이터베이스, 모델, 샌드박스의 전체 구성을 확인해야 합니다.

최종 변경은 누가 승인하나요?

팀이 요구사항을 보완하고 계획을 검토하며 PR 병합 여부를 결정할 수 있습니다. 자동화 정도는 보드 규칙으로 정합니다.

공식 자료와 개발자 커뮤니티

• Factory 문서: 시작 및 설정 안내.
• Mastra GitHub: 소스 코드와 이슈.
• 공식 Discord: 개발자 토론.
• Mastra X: 제품 공지.
• 팀 문의: 데모와 기업 도입 상담.