Paperclip은 AI 에이전트를 직원처럼 조율하는 오픈 소스 1인 기업 프레임워크입니다. 조직도, 예산, 하트비트 스케줄링, 거버넌스 승인, 완전한 감사 로그를 제공하며, 한 번의 명령으로 로컬에서 실행할 수 있습니다. 에이전트들이 작업을 수행하고, 당신은 이사회 회의를 운영합니다.
2026년에 1인 기업을 운영하는 것은 더 이상 모든 것을 혼자서 처리하는 것을 의미하지 않습니다. 이는 당신이 전략에 집중하는 동안 작업을 수행하는 AI 에이전트 팀을 지휘하는 것을 의미합니다. Paperclip은 이를 현실로 만들기 위해 구축된 오픈 소스 1인 기업 프레임워크입니다. 이 프레임워크는 1인 창업자에게 AI 에이전트를 위한 조직도, 예산 시스템, 거버넌스 계층, 작업 추적기를 모두 하나의 자체 호스팅 대시보드에서 제공합니다. 또한 Apidog를 사용하여 에이전트가 상호 작용하는 API를 설계, 모의 및 테스트한다면, Paperclip은 스택을 완성합니다: Apidog가 API 계약을 소유하고, Paperclip은 이를 호출하는 에이전트를 소유합니다. 이 가이드는 Paperclip이 정확히 어떻게 작동하고 오늘부터 1인 운영에 어떻게 연결할 수 있는지 자세히 설명합니다.
버튼
Paperclip이란 무엇이며, Apidog 사용자에게 1인 기업 프레임워크가 중요한 이유는 무엇인가요?
Paperclip의 슬로건은 이를 직접적으로 말합니다: "OpenClaw가 직원이라면, Paperclip은 회사입니다."
Paperclip은 AI 에이전트 모음을 직함, 보고 체계, 월별 예산, 전략적 목표를 가진 구조화된 조직으로 전환하는 Node.js 서버이자 React UI입니다. 이는 챗봇, 프롬프트 관리자 또는 워크플로 드래그 앤 드롭 빌더가 아닙니다. 이는 자율적인 기업을 위한 제어 평면입니다.
이 1인 기업 프레임워크가 지금 중요한 이유는 다음과 같습니다.
2026년에 AI 에이전트를 사용하는 대부분의 1인 창업자들은 혼돈을 관리하고 있습니다. 스무 개의 Claude Code 탭이 열려 있고, 어떤 에이전트가 어떤 파일을 건드렸는지 기록이 없으며, 토큰 지출에 제한이 없습니다. 에이전트가 작업을 완료했는지 또는 환각으로 완성을 보고했는지 알 방법이 없습니다. Paperclip은 실제 회사가 직원을 대하는 것과 동일한 방식으로 에이전트를 대우함으로써 이 모든 것을 해결합니다:
- 조직도 — 에이전트는 역할, 직함 및 관리자를 가집니다.
- 이슈 / 작업 — 모든 작업은 상태, 우선순위 및 담당자와 함께 추적됩니다.
- 목표 — 모든 작업은 회사 미션으로 거슬러 올라가므로 에이전트는 항상 이유를 압니다.
- 하트비트 — 에이전트는 정해진 일정에 따라 깨어나 작업함을 확인하고, 작업을 수행하고, 보고합니다.
- 예산 — 에이전트별 월별 토큰 지출 한도; 한도에 도달하면 작업을 중단합니다.
- 거버넌스 — 에이전트 채용 및 주요 전략 결정을 실행하기 전에 승인합니다.
Apidog를 사용하여 에이전트가 호출하는 API를 정의하고 모의하는 팀의 경우, Paperclip은 누락된 오케스트레이션 계층을 추가합니다. Apidog는 에이전트에게 API 계약이 무엇인지 알려줍니다. Paperclip은 에이전트에게 어떤 작업을 언제 어떻게 수행해야 하며, 얼마를 사용할 수 있는지 알려줍니다.
1인 창업자들이 Apidog 단독 접근 방식보다 이 1인 기업 프레임워크를 선택하는 이유
Apidog는 독립적인 API 설계 및 테스트에 탁월합니다. 그러나 API 설계는 제품 운영의 한 부분일 뿐입니다. Paperclip은 목표 분해, 작업 할당, 진행 상황 추적, 비용 가시성 및 감사 로깅과 같은 주변 프로세스를 처리합니다. Apidog와 Paperclip은 함께 1인 창업자에게 인간이 방향을 설정하고 AI 에이전트가 실행하는 소프트웨어 회사를 위한 완전한 운영 체제를 제공합니다.
Paperclip 1인 기업 프레임워크의 핵심 기능 및 Apidog의 역할
하트비트: Apidog 호환 에이전트 활성화 루프
하트비트는 Paperclip의 핵심 실행 원시 요소입니다. 각 하트비트마다 에이전트는 다음을 수행합니다:
GET /api/agents/me를 호출하여 자신의 신원 확인GET /api/companies/:id/issues?status=todo,in_progress를 호출하여 작업함 읽기GET /api/issues/:id를 호출하여 상위 목표 혈통을 포함한 전체 컨텍스트 얻기- 작업 수행 (코드 작성, API 호출, 콘텐츠 생성)
PATCH /api/issues/:id를 호출하여 상태 업데이트 및 수행한 작업 설명 주석 추가
이것이 바로 Apidog 통합이 빛을 발하는 지점입니다. 작업이 외부 API 호출을 포함하는 경우(예: 고객 데이터를 가져와 주간 보고서를 생성하는 경우), 에이전트는 개발 중에 Apidog 모의 서버를 사용한 다음, 단 한 줄의 코드도 변경하지 않고 프로덕션에서 라이브 엔드포인트로 전환합니다. Apidog의 요청 유효성 검사는 에이전트 작업을 조용히 중단시키기 전에 API 계약의 모든 변경 사항을 감지합니다.
조직도 및 목표 계층: API 계층으로서의 Apidog
Paperclip의 목표 계층은 회사 → 팀 → 에이전트 → 작업 순으로 흐릅니다. 작업이 할당된 에이전트는 항상 상위 체인을 받으므로, 주니어 에이전트는 "100만 달러 월 반복 수익(MRR) 달성"의 일환으로 "SEO 트래픽 증가"의 일부로 블로그 게시물을 작성하고 있음을 알게 됩니다. 이 컨텍스트는 에이전트가 더 넓은 목표를 희생하면서 로컬에서 최적화하는 것을 방지합니다.
이 계층 구조 내에서 Apidog는 API 사양 계층 역할을 합니다. Apidog에서 내부 서비스를 정의하고, 각 서비스에 대한 모의 서버를 게시하며, 에이전트는 작업 설명에서 해당 Apidog 엔드포인트를 참조합니다. API가 변경될 때, Apidog 사양을 업데이트하고, 모의를 다시 생성하면 모든 하위 에이전트가 새 계약을 자동으로 받게 됩니다.
예산 집행: Apidog 워크플로에서 예산 초과 지출 방지
Paperclip의 모든 에이전트에는 budgetMonthlyCents 필드가 있습니다. 에이전트의 spentMonthlyCents가 이 한도에 도달하면 작업을 더 이상 수락하지 않습니다. 재정의도, 예외도 없습니다. 간소하게 운영되는 1인 기업에게 이것은 나머지 모든 것을 가능하게 하는 기능입니다. 에이전트에게 월 20달러 예산을 주고 절대로 초과하지 않을 것이라는 확신을 가질 수 있습니다.
이를 Apidog의 모의 서버와 결합하면, 라이브 AI 제공업체로 전환하기 전에 모의 환경에서 전체 에이전트 작업 스프린트를 실행할 수 있습니다 (토큰 비용 제로). 프로토타이핑은 무료이며, 프로덕션은 예산이 책정됩니다.
Apidog로 1인 기업 프레임워크인 Paperclip 설정하기 {#setup}
제로 설정 로컬 시작: Apidog 즉시 연결
Paperclip을 실행하는 것은 단 하나의 명령으로 가능합니다:
npx paperclipai onboard --yes
이는 내장된 PostgreSQL 데이터베이스를 부트스트랩하고, 마스터 암호화 키를 생성하며, 모든 데이터베이스 마이그레이션을 적용하고, http://localhost:3100에서 서버를 시작합니다. Docker가 필요 없고, 외부 서비스도 필요 없습니다.
실행되면 UI를 열고, 회사를 생성하고, 첫 번째 목표를 정의하세요:
"Build the #1 AI-powered API monitoring tool to $1M MRR."
그런 다음 첫 번째 에이전트(예: claude_local 어댑터를 사용하는 "백엔드 엔지니어" 에이전트)를 생성하세요:
{
"adapterType": "claude_local",
"adapterConfig": {
"model": "claude-opus-4-6",
"maxTokens": 4096
},
"budgetMonthlyCents": 2000
}
에이전트의 작업을 Apidog 모의 서버로 지정하세요. 작업 설명에서 Apidog 컬렉션 URL을 참조하여 에이전트가 전체 API 계약을 컨텍스트로 사용할 수 있도록 합니다.
Apidog 모의를 에이전트 작업에 연결
Paperclip에서 작업 설명은 전체 상위 컨텍스트를 포함하는 풍부한 마크다운입니다. Apidog 모의 기본 URL을 직접 포함할 수 있습니다:
## Task: Add pagination to the /users endpoint
**Apidog Mock Base:** http://localhost:4523/m1/123456/users
**Acceptance criteria:**
- Endpoint accepts `page` and `limit` query params
- Returns `{ data: [], total: 0, page: 1 }` envelope
- Unit test coverage for edge cases (page=0, limit>100)
에이전트는 이를 읽고, Apidog 모의를 호출하여 현재 응답 형태를 확인하고, 구현을 작성한 다음, 주석과 함께 보고합니다.
Apidog를 사용한 Paperclip 1인 기업 프레임워크에서 에이전트, 작업 및 하트비트 실행
Paperclip Apidog 파이프라인을 통한 이슈 관리
Paperclip CLI는 UI를 열지 않고도 작업 수명 주기를 완벽하게 제어할 수 있도록 합니다:
# 에이전트가 새로운 Apidog 정의 엔드포인트를 구현하도록 작업 생성
pnpm paperclipai issue create \
--company-id <id> \
--title "Apidog 사양에 따른 POST /webhooks 엔드포인트 구현" \
--description "Apidog 컬렉션 참조: http://localhost:4523/..."
# 작업 상태 확인
pnpm paperclipai issue list --company-id <id> --status in_progress
# 에이전트가 멈췄을 경우 작업 해제
pnpm paperclipai issue release <issue-id>
각 상태 변경은 불변 활동 로그에 기록되므로, 어떤 에이전트가 어떤 작업을 처리했고 무엇을 말했는지 항상 정확히 알 수 있습니다.
Apidog 통합 1인 기업 프레임워크의 거버넌스 및 승인
Paperclip의 거버넌스 모델은 당신을 이사회의 역할에 놓습니다. 에이전트가 채용되거나 주요 전략이 승인되기 전에 Paperclip은 명시적인 승인을 요구할 수 있습니다:
# 보류 중인 승인 검토
pnpm paperclipai approval list --company-id <id>
# 신규 에이전트 채용 승인
pnpm paperclipai approval approve <approval-id> \
--decision-note "승인됨. 첫 스프린트는 Apidog 모의를 사용하세요."
이것은 1인 기업 프레임워크가 자율성 재앙이 되는 것을 방지합니다. 에이전트가 제안하고, 당신이 결정합니다.
Paperclip + Apidog 1인 기업 프레임워크 스택에서의 테스트, 거버넌스 및 비용 통제
Paperclip Apidog 단위 테스트 스위트 실행
Paperclip은 Vitest로 구동되는 완전한 단위 테스트 스위트와 Playwright로 구동되는 종단간(end-to-end) 테스트를 제공합니다. 이를 실행하는 것은 간단합니다:
# 모든 단위 테스트 실행
pnpm test:run
# 종단간 테스트 실행
pnpm test:e2e
# 상태 확인 — 서버 및 Apidog 모의 도달 가능 여부 확인
curl http://localhost:3100/api/health
단위 테스트 스위트는 핵심 비즈니스 로직(이슈 상태 전환, 예산 집행, 하트비트 실행 수명 주기 및 에이전트 인증)을 다룹니다. 새로운 AI 공급자를 연결하기 위해 사용자 정의 어댑터를 추가할 때, 단위 테스트 스위트를 실행하면 기존 오케스트레이션 동작이 변경되지 않았음을 확인할 수 있습니다.
1인 기업 프레임워크에서는 이것이 전통적인 팀보다 더 중요합니다. 코드 검토자가 없기 때문입니다. 단위 테스트 스위트와 Apidog 계약 테스트가 당신의 안전망입니다.
세 가지 계층의 품질 스택: Paperclip + Apidog + 단위 테스트
1인 창업자를 위한 실용적인 품질 패턴:
- Apidog는 API 계약을 정의하고 모든 푸시마다 자동화된 계약 테스트를 실행합니다.
- Paperclip 이슈는 Apidog 사양을 참조하는 승인 기준을 포함합니다.
- 단위 테스트 (Vitest)는 구현이 두 가지 모두와 일치하는지 유효성을 검사합니다.
이 세 가지 계층 접근 방식은 1인 창업자가 회의 없이도 동료 검토를 통해 5인 팀이 얻을 수 있는 것과 동일한 품질 보증을 받는다는 것을 의미합니다.
결론
Paperclip은 1인 창업자를 회사로 전환시키는 오픈 소스 1인 기업 프레임워크입니다. 이는 AI 에이전트 관리에 조직도, 예산 통제, 거버넌스, 목표 정렬, 하트비트 스케줄링, 그리고 완전한 감사 추적 기능을 제공하며, 이 모든 것이 자체 호스팅되고, 오픈 소스이며, 당신의 것입니다.
이미 Apidog를 사용하여 API를 설계하고 테스트하는 개발자들에게 Paperclip을 추가하면 스택이 완성됩니다. Apidog는 API가 무엇을 하는지 처리합니다. Paperclip은 누가, 언제, 왜, 그리고 어떤 비용으로 API를 호출하는지 처리합니다. 이들은 함께 첫날부터 프로덕션 수준의 1인 기업 프레임워크를 형성합니다: Apidog 모의 서버가 에이전트 개발을 지원하고, Apidog 계약 테스트가 에이전트 출력을 검증하며, Paperclip의 거버넌스 계층은 승인되지 않은 에이전트의 행동을 방지합니다.
시작하기:
- 로컬에서 부트스트랩:
npx paperclipai onboard --yes http://localhost:3100에서 UI를 열고, 회사를 생성하고, 첫 번째 목표를 정의하세요.- 월
$20예산을 가진 에이전트를 추가하고 Apidog 모의 서버로 연결하세요. - 첫 프로덕션 하트비트 전에
pnpm test:run을 실행하여 단위 테스트 스위트가 통과하는지 확인하세요. - 첫 번째 작업을 승인하고, 에이전트가 작업하는 것을 지켜보고, 감사 로그를 검토하세요.
1인 기업은 더 이상 비유가 아닙니다. Paperclip과 Apidog를 통해, 이는 하나의 아키텍처입니다.
버튼
자주 묻는 질문 (FAQ)
Paperclip은 무엇인가요? Paperclip은 오픈 소스 1인 기업 프레임워크입니다. 조직도, 예산, 하트비트 스케줄링, 거버넌스를 통해 AI 에이전트를 조율하는 Node.js 서버이자 React UI입니다. 이는 인간 직원 대신 AI 에이전트로 소프트웨어 회사를 운영하기 위한 제어 평면입니다.
Paperclip은 Apidog와 어떻게 통합되나요? Apidog는 에이전트가 작업하는 API 계약을 정의합니다. Paperclip 작업 설명에 Apidog 모의 URL을 삽입하면 에이전트가 개발 중에 해당 모의를 호출하고, Apidog의 계약 테스트가 최종 구현을 검증합니다. Paperclip은 오케스트레이션을 처리하고, Apidog는 API 사양을 처리합니다.
Paperclip은 진정한 1인 기업에 적합한가요? 네, 그렇습니다. 제로 설정 로컬 설치(npx paperclipai onboard --yes)는 인프라가 필요 없습니다. 예산 한도는 비용 초과를 방지합니다. 하트비트 시스템은 반복 작업을 자동으로 처리합니다. Tailscale 통합을 통해 휴대폰으로 에이전트를 관리할 수 있습니다. 동일한 구성으로 로컬에서 클라우드로 확장 가능합니다.
단위 테스트는 어떻게 실행하나요? Vitest 단위 테스트 스위트의 경우 pnpm test:run을 실행하거나, Playwright 종단간 테스트의 경우 pnpm test:e2e를 실행하세요. 테스트 전에 http://localhost:3100/api/health에 대한 상태 확인을 통해 서버가 올바르게 실행 중인지 확인할 수 있습니다.
Paperclip은 어떤 AI 에이전트를 지원하나요? Paperclip은 Claude (로컬 및 OpenClaw를 통해), Codex, Cursor, Gemini, OpenCode 및 HTTP를 사용하거나 로컬 프로세스로 실행되는 모든 에이전트를 지원합니다. 어댑터 시스템은 개방되어 있으므로, 당신의 에이전트가 하트비트를 받을 수 있다면 채용될 수 있습니다.
Paperclip은 오픈 소스인가요? 네. Paperclip은 MIT 라이선스를 따르며 github.com/paperclipai/paperclip에서 활발히 유지보수되고 있습니다. 플러그인 SDK, 어댑터 패키지 및 스킬 정의는 모두 @paperclipai/* 아래의 스코프 NPM 패키지로 게시됩니다.